Some products and features are in the process of being renamed. Generative playbook and flow features are also being migrated to a single consolidated console. See the details.
Stay organized with collections
Save and categorize content based on your preferences.
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.
This integration currently works only with agents created in the globalregion. If you need a local telephone number hosted in a specific region, please reach out to your Google account team.
Only US phone numbers are 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.
This integration uses the phone_call
speech model, even if other speech models are specified in the console or in the
conversation profile, unless you enable the Override request-level speech
model
setting.
Go to the Dialogflow CX console. Choose your Google Cloud project
and select your agent.
Select the Manage tab. Click Integrations in the left sidebar menu
and click Try it for CX Phone Gateway.
Click +Create.
Select the country code for the phone number.
Optional. Select preferred area codes.
Click Request.
Select a number.
Choose a telephony number from the list.
Enter a display name for configuring the conversation profile associated
with the phone number.
Optional. Click Show more settings and update the settings.
Click Save.
Completion:
The gateway is now active.
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.
Play pre-recorded audio
You can use fulfillment options to
play pre-recorded audio.
The audio must contain a single channel (mono) of
μ-law
encoded audio at 8kHz and be hosted on Cloud Storage.
If you have configured a
webhook,
this integration will populate the
WebhookRequest.payload field with the caller ID of the end-user.
The format looks like the following:
You can click the Delete icon of a phone number to delete that number.
Delete an agent
You can delete agents by deleting your Google Cloud project.
If you want to keep using your Google Cloud 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.
[[["Easy to understand","easyToUnderstand","thumb-up"],["Solved my problem","solvedMyProblem","thumb-up"],["Other","otherUp","thumb-up"]],[["Hard to understand","hardToUnderstand","thumb-down"],["Incorrect information or sample code","incorrectInformationOrSampleCode","thumb-down"],["Missing the information/samples I need","missingTheInformationSamplesINeed","thumb-down"],["Other","otherDown","thumb-down"]],["Last updated 2025-08-07 UTC."],[[["\u003cp\u003eDialogflow CX Phone Gateway provides a telephone interface for agents, enabling the creation of conversational IVR solutions for call centers.\u003c/p\u003e\n"],["\u003cp\u003eThe phone gateway currently only supports US phone numbers and works with agents created in the \u003ccode\u003eglobal\u003c/code\u003e region, subject to certain quotas and limits.\u003c/p\u003e\n"],["\u003cp\u003eSetting up the gateway involves selecting a Google-hosted number, configuring a display name, and optional settings through the Dialogflow CX console.\u003c/p\u003e\n"],["\u003cp\u003eThe system utilizes the \u003ccode\u003ephone_call\u003c/code\u003e speech model, unless overridden, and supports all languages with both speech-to-text (STT) and text-to-speech (TTS) capabilities.\u003c/p\u003e\n"],["\u003cp\u003eFeatures include playing pre-recorded audio hosted on Cloud Storage, call transfer functionality, and retrieving the caller's phone number via the webhook payload.\u003c/p\u003e\n"]]],[],null,["# Dialogflow CX Phone Gateway\n\nThe Dialogflow CX Phone Gateway feature provides a telephone interface to your\nagent. It is used to build conversational IVR (interactive voice response)\nsolutions that integrate with the rest of your call center network. With the\nphone gateway, you can select a telephone number hosted by Google and connect\nit to your agent.\n\nAlso see\n[Call companion](/dialogflow/cx/docs/concept/call-companion).\n\nLimitations\n-----------\n\nThe following limitations apply:\n\n- This integration currently works only with agents created in the `global` [region](/dialogflow/cx/docs/concept/region). If you need a local telephone number hosted in a specific region, please reach out to your Google account team.\n- Only US phone numbers are supported.\n- There are [quotas and limits](/dialogflow/quotas) for this feature. If you receive a busy signal or the call drops, you may have exceeded your quota.\n- [Partial response](/dialogflow/cx/docs/concept/fulfillment#partial-response) is supported for all routes except the [Default welcome intent](/dialogflow/cx/docs/concept/intent#welcome) route on the [Default start flow](/dialogflow/cx/docs/concept/flow#start)'s start page.\n- This integration uses the [`phone_call`](/speech-to-text/docs/speech-to-text-requests#select-model) speech model, even if other speech models are specified in the console or in the conversation profile, unless you enable the [**Override request-level speech\n model**](/dialogflow/cx/docs/concept/agent#stt-model-selection) setting.\n\nSupported languages\n-------------------\n\nThe Dialogflow CX Phone Gateway feature supports all\n[languages that provide both STT and TTS](/dialogflow/cx/docs/reference/language).\n\nSet up a phone gateway\n----------------------\n\nTo set up your gateway, follow these steps:\n\n1. Go to the [Dialogflow CX console](https://dialogflow.cloud.google.com/cx/projects). Choose your Google Cloud project and select your agent.\n2. Select the **Manage** tab. Click **Integrations** in the left sidebar menu and click **Try it** for **CX Phone Gateway**.\n3. Click **+Create** .\n 1. Select the country code for the phone number.\n 2. Optional. Select preferred area codes.\n 3. Click **Request**.\n4. Select a number.\n 1. Choose a telephony number from the list.\n 2. Enter a display name for configuring the conversation profile associated with the phone number.\n 3. Optional. Click **Show more settings** and update the settings.\n 4. Click **Save**.\n5. Completion:\n 1. The gateway is now active.\n 2. You can click the phone number under the **Phone Numbers** page to check and update settings.\n\nCall the telephone number\n-------------------------\n\nYou can now call the number and follow the simple voice prompts.\nIf the agent reaches end session state, the call ends.\n\nRetrieve caller phone number\n----------------------------\n\nYou can retrieve the `caller_id` value from the [payload](#payload) field.\n\nPlay pre-recorded audio\n-----------------------\n\nYou can use fulfillment options to\n[play pre-recorded audio](/dialogflow/cx/docs/concept/fulfillment#audio).\nThe audio must contain a single channel (mono) of\n[μ-law](https://en.wikipedia.org/wiki/%CE%9C-law_algorithm)\nencoded audio at 8kHz and be hosted on [Cloud Storage](/storage/docs).\n\nTransfer a call\n---------------\n\nYou can use fulfillment options to\n[transfer a call](/dialogflow/cx/docs/concept/fulfillment#transfer).\n\nWebhook request payload\n-----------------------\n\nIf you have configured a\n[webhook](/dialogflow/cx/docs/concept/webhook),\nthis integration will populate the\n`WebhookRequest.payload` field with the caller ID of the end-user.\nThe format looks like the following: \n\n \"payload\": {\n \"telephony\": {\n \"caller_id\": \"+18558363987\"\n }\n }\n\nDelete a number\n---------------\n\nYou can click the **Delete** icon of a phone number to delete that number.\n\nDelete an agent\n---------------\n\nYou can delete agents by deleting your Google Cloud project.\nIf you want to keep using your Google Cloud project, you must delete all\nthe phone numbers associated with your phone gateway agent before you\n[delete the agent](/dialogflow/cx/docs/concept/agent#del).\n\nPlease see [Delete a number](#delete-phone-number) section for phone number\ndeletion."]]