Dialogflow Phone Gateway

Visualizar

Este produto ou recurso está sujeito aos "Termos das Soluções Pré-GA" na seção "Termos Gerais de Serviço" dos Termos Específicos de Serviço. Os produtos e recursos pré-GA estão disponíveis "no estado em que se encontram" e podem ter suporte limitado. Para mais informações, consulte as descrições da fase de lançamento.

O recurso de gateway telefônico do Dialogflow fornece uma interface de telefone para seu agente. Ele é usado para criar soluções conversacionais de unidade de resposta audível (URA) que se integram ao restante da sua rede de call center. Você pode selecionar um número de telefone hospedado pelo Google.

Para informações sobre preços e cotas de gateways de telefone, consulte as páginas Preços e Cotas e limites.

Limitações

Suporte ao idioma

Essa integração é compatível apenas com o uso de um idioma por agente.

Se os modelos de fala aprimorados estiverem ativados para o agente, essa integração será compatível apenas com os seguintes idiomas:

• Inglês (en)
• Inglês - EUA (en-US)

Se os modelos de fala aprimorados estiverem desativados para o agente, consulte a coluna Telefone na página Referência de idioma para ver uma lista de idiomas compatíveis.

Suporte para número de telefone

Apenas números de telefone dos EUA são aceitos, tanto para chamadas recebidas quanto para transferências.

Antes de começar

Faça o seguinte antes de ler este guia:

1. Leia os Conceitos básicos do Dialogflow.
2. Execute as etapas de configuração.

Criar um agente

1. Acesse o console do Dialogflow ES.
2. Faça login no console do Dialogflow se solicitado. Para mais informações, consulte Visão geral do console do Dialogflow.
3. No menu da barra lateral, expanda Agentes de carregamento.
4. Clique em Criar novo agente.
5. Digite o nome do agente, o idioma padrão e o fuso horário padrão.
6. Insira um projeto. Para permitir que o console do Dialogflow crie um projeto, selecione Criar um novo projeto do Google.
7. Clique em Criar.

Ativar recursos Beta

Verifique se os recursos Beta estão ativados:

1. Acesse o console do Dialogflow ES.
2. Selecione um agente.
3. Clique no botão de configurações ao lado do nome do agente.
4. Na guia General, role a tela para baixo e verifique se Beta Features está ativado.
5. Se você tiver feito alterações, clique em Save.

Configurar um gateway de telefone

Para configurar o gateway, siga estas etapas:

1. Selecione um provedor:
   1. Acesse o console do Dialogflow ES.
   2. Selecione seu agente.
   3. Clique em Integrações.
      
   4. Clique em Dialogflow Phone Gateway.
      
2. Configure o Phone Gateway:
   1. Selecione o idioma.
   2. Selecione o código do país para o número de telefone.
   3. (Opcional) Selecione os códigos de área preferidos.
   4. Clique em Próxima.
      
3. Selecione um número:
   1. Escolha um número de telefone na lista.
   2. Clique em Criar.
      
4. Conclua a configuração:
   1. O gateway está ativo.
   2. Se quiser, mude o ambiente.
   3. Salve o número de telefone exibido e feche a janela de diálogo. Clique no botão de integrações do Dialogflow Phone Gateway novamente para recuperar essas informações.
      

Ligar para o número de telefone

Agora você pode ligar para o número e seguir as instruções simples de voz. As interações estão definidas no agente.

Observação: há cotas e limites para esse recurso. Se você receber um sinal de ocupado ou a chamada cair, talvez tenha excedido sua cota.

Observação: se você decidir excluir o agente, mas continuar usando seu projeto do Google Cloud , desative a integração do gateway de telefone antes da exclusão do agente.

Examinar as intents

Agora que você tem um agente de gateway de telefone ativo, vamos analisar as intents que você importou. Isso vai ajudar você a entender como criar seus próprios agentes do Phone Gateway.

dê as boas-vindas a quem está ligando

Quando você ligou para o número, o agente lhe cumprimentou e apresentou uma lista de opções. Siga estas etapas para ver como isso foi configurado:

1. Acesse o console do Dialogflow ES.
2. Selecione seu agente.
3. Clique em Intents.
4. Clique em Intent de boas-vindas padrão.
5. Role para baixo até a seção Eventos. Os eventos Boas-vindas (WELCOME) e Boas-vindas de telefonia (TELEPHONY_WELCOME) estão presentes. Isso significa que todos os tipos de eventos de boas-vindas acionam essa intent. Como alternativa, você pode criar intents separadas, cada uma dedicada a um evento de boas-vindas específico.
6. Role a tela para baixo até a seção Respostas e clique na guia Dialogflow Phone Gateway.
7. A resposta Sintetizar fala contém a mensagem de boas-vindas que você ouviu ao ligar para o número.

Resposta ao comando de teste

Depois que você respondeu "teste", o agente apresentou uma nova lista de opções. Siga estas etapas para ver como isso foi configurado:

1. Clique em Intents.
2. Clique em Testar intent de telefonia.
3. Role a tela para baixo até a seção Respostas e clique na guia Dialogflow Phone Gateway.
4. A resposta Sintetizar fala contém a resposta que você ouviu depois de falar "teste".

Como definir o contexto

Depois de dizer "teste", há dois comandos possíveis de executar: "transferir" ou "encerrar". Isso não é uma limitação dos agentes de gateway de telefone, mas sim como esse intent é definido. Os intents associados a esses comandos são fornecidos com contexto. Siga estas etapas para ver como isso foi configurado:

1. Role até a seção Contexto na parte superior.
2. Observe o contexto de saída TestTelephonyIntent-followup.
3. Clique em Intents.
4. Clique no botão de expansão ao lado de Testar intent de telefonia.
5. Clique em Testar intent de telefonia: encerrar.
6. Role até a seção Contexto na parte superior.
7. Observe o contexto de entrada TestTelephonyIntent-followup.

Encerrar a chamada

Quando você respondeu "encerrar", o agente disse "até logo" e encerrou a chamada. Siga estas etapas para ver como isso foi configurado:

1. Role para baixo até a seção Frases de treinamento e observe as frases usadas para encerrar a chamada.
2. Role a tela para baixo até a seção Respostas e clique na guia Dialogflow Phone Gateway.
3. Observe que a resposta Sintetizar fala contém "até logo".
4. Observe que Definir este intent como fim da conversa está ativado. Se ele estiver ativado, o Dialogflow encerrará a chamada telefônica depois de reproduzir todas as outras instruções de áudio.

Observação: se você estiver usando fulfillment, configure o campo end_interaction da mensagem WebhookResponse para encerrar uma chamada.

Mensagens de resposta avançada do gateway do telefone

As intents deste exemplo usam mensagens de resposta avançadas para respostas do gateway de telefone. Veja a seguir os tipos que você pode usar:

• Reproduzir áudio: reproduz o arquivo de áudio fornecido. Especifique o URI para um objeto do Cloud Storage que contenha o áudio a ser reproduzido. Por exemplo, 'gs://bucket/object'. O objeto precisa conter um único canal (mono) de áudio PCM linear (2 bytes/amostra) a 8 kHz.
• Sintetizar fala: sintetiza o texto fornecido como áudio e o reproduz. Se preferir, ative Use response from the DEFAULT tab as the first response, que usará a resposta padrão para sintetizar uma resposta de fala. Se você definir apenas as respostas padrão e não ativar Use response from the DEFAULT tab as the first response, somente o texto preenchido em QueryResult.fulfillment_text (usando uma resposta de texto selecionada aleatoriamente) será sintetizado para áudio.
• Transferir chamada: transfere o autor da chamada para outro número. A duração da chamada transferida é incluída na duração total da chamada, e as taxas do Dialogflow são aplicadas até o encerramento da chamada.

Observação: ao adicionar uma mensagem avançada, passe o mouse sobre o botão ? para mais informações sobre ela e as respectivas entradas.

Configurações do agente

É possível controlar vários aspectos da síntese de fala. Consulte Configurações de fala do agente.

Usar o simulador do Dialogflow

Ao testar um agente de gateway de telefone, você não precisa fazer uma chamada telefônica. É possível interagir com o agente e receber respostas de áudio usando o simulador do Dialogflow:

1. Digite "olá" e pressione a tecla de retorno.
2. Mude a Resposta padrão para Dialogflow Phone Gateway.
3. Clique no botão Reproduzir áudio para ouvir a resposta do agente.
4. Continue a conversa com o agente.

Números para chamadas sem custo financeiro

Você pode solicitar um número de telefone com um código de área 833. Observação: os números de ligação sem custo financeiro têm preços mais altos.

Eventos

Os eventos a seguir são invocados por esta integração:

Evento	Descrição
TELEPHONY_WELCOME	Acionado quando alguém liga para o número de telefone associado ao agente do Dialogflow.

Aquecimento do agente

Quando um usuário final liga para um agente do Dialogflow Phone Gateway, o Dialogflow começa carregando o agente para uma resposta rápida ao enunciado inicial do usuário final. Enquanto o agente está carregando, o smartphone continua tocando. Para isso, o Dialogflow envia uma solicitação de detecção de intent ao seu agente. O texto dessa solicitação é TELEPHONY_WARMUP.

Recuperar número de telefone do autor da chamada

Se você usa a edição do Dialogflow Essentials, é possível recuperar o valor caller_id do campo OriginalDetectIntentRequest.payload na solicitação de webhook. Na edição de teste do Dialogflow, o valor caller_id é editado.