Alguns produtos e recursos estão sendo renomeados. Os recursos de playbook generativo e de fluxo também estão sendo migrados para um único console consolidado. Confira os detalhes.
Mantenha tudo organizado com as coleções
Salve e categorize o conteúdo com base nas suas preferências.
O recurso de gateway telefônico do Dialogflow CX fornece uma interface de telefone para seu
agente. Ele é usado para criar soluções conversacionais de unidade de resposta audível (IVR, na sigla em inglês)
que se integram ao restante da sua rede de call center. Com esse
gateway, é possível selecionar um número de telefone hospedado pelo Google e conectá-lo
ao seu agente.
No momento, essa integração funciona apenas com agentes criados na regiãoglobal. Se você precisar de um número de telefone local hospedado em uma região específica, entre em contato com a Equipe de Contas do Google.
Apenas números de telefone dos EUA são aceitos.
Há cotas e limites para esse recurso. Se você
receber um sinal de ocupado ou a chamada cair, será possível que você tenha excedido sua cota.
Selecione a guia Manage. Clique em Integrations no menu lateral à esquerda
e em Try it para CX Phone Gateway.
Clique em Criar.
Selecione o código do país para o número de telefone.
Opcional. Selecione os códigos de área preferidos.
Clique em Solicitar.
Selecione um número.
Escolha um número de telefonia na lista.
Digite um nome de exibição para configurar o perfil de conversa associado
ao número de telefone.
Opcional. Clique em Show more settings e atualize as configurações.
Clique em Save.
Conclusão:
O gateway está ativo.
Clique no número de telefone na página Phone Numbers para
verificar e atualizar as configurações.
Ligar para o número de telefone
Agora você pode ligar para o número e seguir as instruções simples de voz.
Se o agente atingir o estado final da sessão, a chamada será encerrada.
Recuperar número de telefone do autor da chamada
É possível recuperar o valor caller_id do campo payload.
Ouvir áudio pré-gravado
Use as opções de fulfillment para tocar áudio pré-gravado.
O áudio precisa conter um único canal (mono) de áudio codificado em
μ-law
a 8 kHz e ser hospedado no Cloud Storage.
Se você tiver configurado um
webhook,
essa integração vai preencher o
campo WebhookRequest.payload com o identificador de chamadas do usuário final.
O formato é o seguinte:
Clique no ícone Excluir de um número de telefone para removê-lo.
Excluir um agente
Você pode excluir agentes excluindo seu projeto do Google Cloud.
Se quiser continuar usando seu projeto do Google Cloud, você precisará excluir todos
os números de telefone associados ao agente do gateway de telefone antes de
excluir o agente.
Consulte a seção Excluir um número para excluir um
número de telefone.
[[["Fácil de entender","easyToUnderstand","thumb-up"],["Meu problema foi resolvido","solvedMyProblem","thumb-up"],["Outro","otherUp","thumb-up"]],[["Difícil de entender","hardToUnderstand","thumb-down"],["Informações incorretas ou exemplo de código","incorrectInformationOrSampleCode","thumb-down"],["Não contém as informações/amostras de que eu preciso","missingTheInformationSamplesINeed","thumb-down"],["Problema na tradução","translationIssue","thumb-down"],["Outro","otherDown","thumb-down"]],["Última atualização 2025-08-18 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."]]
