Sign in
Dialogflow Integration

Update stored Dialogflow Connection

Updates the stored Dialogflow connection for the specified connection and returns the updated configuration.

put/dialogflow_connections/{connection_id}

Path parameters

connection_idstring required

Uniquely identifies a Telnyx application (Call Control).

Request body

conversation_profile_idstring

The id of a configured conversation profile on your Dialogflow account. (If you use Dialogflow CX, this param is required)

dialogflow_api'cx' | 'es'

Determine which Dialogflow will be used.

environmentstring

Which Dialogflow environment will be used.

locationstring

The region of your agent is. (If you use Dialogflow CX, this param is required)

service_accountobject required

The JSON map to connect your Dialoglow account.

Example request

{
  "conversation_profile_id": "a-VMHLWzTmKjiJw5S6O0-w",
  "dialogflow_api": "cx",
  "environment": "development",
  "location": "global",
  "service_account": {
    "auth_provider_x509_cert_url": "https://www.googleapis.com/oauth2/v1/certs",
    "auth_uri": "https://accounts.google.com/o/oauth2/auth",
    "client_email": "example@example.com",
    "client_id": "your-client-id",
    "client_x509_cert_url": "https://www.googleapis.com/robot/v1/metadata/x509/example%40example.iam.gserviceaccount.com",
    "private_key": "-----BEGIN PRIVATE KEY-----\n-----END PRIVATE KEY-----",
    "private_key_id": "your-private-key",
    "project_id": "your-project-id",
    "token_uri": "https://oauth2.googleapis.com/token",
    "type": "service_account"
  }
}

Response

Return details of the Dialogflow connection associated with the given CallControl connection.

Example response

{
  "data": {
    "connection_id": "1234541231",
    "conversation_profile_id": "a-VMHLWzTmKjiJw5S6O0-w",
    "environment": "development",
    "record_type": "dialogflow_connections",
    "service_account": "****"
  }
}

Changes

Changed in 2 of the 61 revisions of this API.6

  • 1571b0380bd73See the full diff
    • ▲

      the // response's property type changed from integer to string, and format from int32 to no format for status

      response-property-type-changed

    • ▲

      the // response's property type changed from integer to string, and format from int32 to no format for status

      response-property-type-changed

    • ▲

      the // response's property type changed from integer to string, and format from int32 to no format for status

      response-property-type-changed

    This revision also has 64 changes that name no endpoint, such as unreferenced schemas being removed. See the revision's changelog

  • 8f5f4e5379943See the full diff
    • ▲

      the // response's property type changed from string to integer, and format from no format to int32 for status

      response-property-type-changed

    • ▲

      the // response's property type changed from string to integer, and format from no format to int32 for status

      response-property-type-changed

    • ▲

      the // response's property type changed from string to integer, and format from no format to int32 for status

      response-property-type-changed

    This revision also has 41 changes that name no endpoint, such as unreferenced schemas being removed. See the revision's changelog