Dialogflow CX Phone Gateway

The Dialogflow CX phone gateway feature provides a telephone interface to your agent. It is used to build conversational IVR (interactive voice response) solutions that integrate with the rest of your call center network. With the phone gateway, you can select a telephone number hosted by Google and connect it to your agent.


The following limitations apply:

  • This integration currently works only with agents created in the global region.
  • Only US phone numbers are supported.
  • The following features are not currently supported:
  • There are quotas and limits for this feature. If you receive a busy signal or the call drops, you may have exceeded your quota.

Supported languages

The Dialogflow CX phone gateway feature supports all languages that provide both STT and TTS.

Set up a phone gateway

To set up your gateway, follow these steps:

  1. Go to the Dialogflow CX Console. Choose your GCP project and select your agent.
  2. Select the Manage tab. Click Integrations in the left sidebar menu and click Try it for CX Phone Gateway.
  3. Click +Create.
    1. Select the country code for the phone number.
    2. Optional. Select preferred area codes.
    3. Click Request.
  4. Select a number.
    1. Choose a telephony number from the list.
    2. Enter a display name for configuring the conversation profile associated with the phone number.
    3. Optional. Click Show more settings and update the settings.
    4. Click Save.
  5. Completion:
    1. The gateway is now active.
    2. You can click the phone number under the Phone Numbers page to check and update settings.

Call the telephone number

You can now call the number and follow the simple voice prompts. If the agent reaches end session state, the call ends.

Retrieve caller phone number

You can retrieve the caller_id value from the payload field in the webhook request.

Delete a number

You can click the Delete icon of a phone number to delete that number.

Delete an agent

You can delete agents by deleting your GCP project. If you want to keep using your GCP project, you must delete all the phone numbers associated with your phone gateway agent before you delete the agent.

Please see Delete a number section for phone number deletion.