Sign in

v52

OpenAPI 3.1.0raw.githubusercontent.com2026-07-311,1941,9384.1 MB
Dialogflow Integration

Create a Dialogflow Connection

Save Dialogflow Credentiails to Telnyx, so it can be used with other Telnyx services.

post/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": "****"
  }
}