Configuração de integração telefônica
IBM Cloud
Depois de configurar a integração telefônica para o assistente, é possível modificar as configurações de integração do telefone para customizar o comportamento da chamada.
Manipulando falhas de chamada e transferência
Você pode configurar a integração telefônica para transferir o autor da chamada para um agente em tempo real se a conexão telefônica falhar por qualquer motivo. Para transferir o autor da chamada para um humano automaticamente, vá para a guia Advanced (Avançado ) nas configurações de integração do telefone e faça as seguintes seleções de configuração:
-
Destino SIP quando uma chamada falhar: inclua o terminal SIP para o serviço de agente de suporte. Especifique um SIP ou um URI de telefone para uma fila de chamadas geral que pode redirecionar solicitações para outras filas. Para obter mais informações, consulte Configurando uma solução de central de serviço de backup.
-
Mensagem de falha de chamada: Adicione a mensagem que você deseja que o assistente diga a um chamador antes de transferir a chamada para um agente em tempo real.
Se, depois de transferir a chamada para um humano, a conexão com um agente ao vivo falhar por qualquer motivo, você poderá configurar o que fazer.
-
Mensagem de falha de transferência: Adicione a mensagem que você deseja que o assistente diga ao autor da chamada se a transferência para um agente ativo falhar. A mensagem pode ter até 150 caracteres.
-
Chamada de desconexão sobre falha de transferência: escolha se você desconectará a chamada após a mensagem de falha. Esta opção está ativada por padrão. Se essa opção for desativada, quando uma transferência de chamada falhar, o assistente poderá desconectar ou processar uma ação diferente.
Se você optar por deixar uma chamada conectada apesar de uma falha de transferência, o watsonx Assistant iniciará uma nova vez para determinar a próxima etapa. É importante que o Assistente seja configurado com um Action ou webhook que possa lidar com esse cenário.
A integração telefônica suporta recuperação de desastre, que fornece a capacidade de realizar um failover rápido para outra região em vez de rotear a chamada para um agente em tempo real quando ocorrer uma interrupção de serviço. Isso é feito enviando uma resposta SIP 503 para o provedor de entroncamento SIP de envio de dados em vez de encaminhar a chamada automaticamente para um agente em tempo real quando ocorrerem falhas na configuração de uma chamada. Essa resposta de 503 pode ser usada pelo provedor de entroncamento SIP para redirecionar a chamada para outra região. Para aproveitar esse recurso, abra um chamado de serviço com relação à instância de serviço watsonx Assistant que requer recuperação de desastre.
Assegure a conexão telefônica
É possível incluir segurança na conexão telefônica acessando a guia Opções avançadas nas configurações de integração do telefone e selecionando uma ou ambas as opções a seguir:
-
Forçar entroncamento seguro: selecione esta opção para usar o Secure Real-Time Transfer Protocol (SRTP) para assegurar o áudio que é transmitido por telefone. Para obter mais informações sobre o RTP, consulte Detalhes de roteamento de chamada.
-
Ativar a autenticação SIP: selecione esta opção se quiser exigir autenticação de compilação SIP.
Quando a autenticação SIP é exigida, todo o tráfego de entrada (ou seja, solicitações do provedor SIP para o assistente) é autenticado usando a autenticação de compilação SIP e deve ser enviado usando TLS (Transport Layer Security). Se essa opção for selecionada, o nome de usuário e a senha de compilação do SIP deverão ser configurados e o tronco SIP sendo usado para conexão com o Assistente deverá ser configurado para usar apenas TLS.
Se você usar o Twilio como seu provedor de tronco SIP, não poderá ativar a autenticação SIP para troncos SIP de saída para watsonx Assistant.
Aplicando definições de configuração avançadas do tronco SIP
Para configurar como o assistente interage com um tronco SIP por meio de um provedor externo, acesse a guia Tronco SIP nas configurações de integração do telefone e atualize as opções a seguir na seção Integração de entroncamento SIP:
-
Cabeçalhos INVITE SIP para extração: liste os cabeçalhos que o assistente deve usar.
A solicitação INVITE SIP pode incluir metadados sobre a chamada em cabeçalhos que podem ser extraídos e enviados para o assistente usando variáveis de contexto. Por exemplo, muitas empresas usam sistemas Interactive Voice Response (IVR) que passam informações sobre uma chamada recebida usando cabeçalhos SIP. Se quiser fazer uso de qualquer um desses cabeçalhos, liste os nomes de cabeçalho aqui.
Os cabeçalhos especificados, se presentes na solicitação, são armazenados na variável de contexto
sip_custom_invite_headers
, juntamente com outros metadados relacionados que são extraídos automaticamente do INVITE SIP. Essa variável é uma matriz na qual cada par de chave/valor representa um cabeçalho da solicitação, como neste exemplo:{ "input": { "text": "", ... }, "context" : { "global" : {...}, "skills" : {...}, "integrations" : { "voice_telephony": { "private":{ "user_phone_number":"+18594213456", }, "sip_call_id": "Aob2-2743-5678-1234", "assistant_phone_number":"+18882346789", "sip_custom_invite_headers": { "X-customer-name": "my_name", "X-account-number": "12345" } } } } }
Você pode então referenciar esses cabeçalhos no assistente. Por exemplo, é possível verificar o valor do cabeçalho em uma condição de etapa para determinar a próxima etapa. Também é possível usar esses cabeçalhos ao procurar os logs do assistente; por exemplo, você pode procurar um cabeçalho customizado para encontrar todas as mensagens associadas a uma conta específica.
-
Desative o toque que os chamadores ouvem enquanto o assistente é contatado: Escolha se deseja que o autor da chamada ouça um sinal que indique que o assistente está sendo contatado.
Uma resposta
180 Ringing
é enviada do assistente de volta para o provedor do tronco SIP enquanto o assistente processa o convite de chamada recebido. A resposta de toque é enviada por padrão. -
Não colocar responsáveis pela chamada em espera ao transferir para um agente em tempo real: escolha se a integração telefônica coloca o responsável pela chamada em espera.
Se o provedor de tronco SIP gerenciar esperas, desative esse recurso. Por exemplo, alguns provedores de tronco SIP preferem que o assistente envie uma solicitação REFER do SIP para que eles mesmos possam colocar a chamada espera.
Para obter mais informações sobre o protocolo SIP, consulte RFC 3261 e sobre o protocolo RTP, consulte RFC 3550.
Configurando uma solução de backup da central de serviço
Quando você usa a integração telefônica como a primeira linha de assistência para os clientes, é uma boa ideia ter um agente de backup ao vivo disponível. É possível projetar o assistente para transferir uma chamada para um humano caso a conexão telefônica falhe ou o usuário peça para falar com alguém.
Sua empresa talvez já tenha um ou mais números de telefone que se conectam a um despachante automático de chamadas (ACD), que pode colocar os autores das chamadas em fila até que um agente apropriado esteja disponível. Caso contrário, escolha uma solução de central de serviços para usar como backup.
Uma conversa não pode ser transferida de um tipo de integração para outro. Por exemplo, se você usar a integração de chat web com o suporte da central de serviços, não será possível transferir uma chamada telefônica para a central de serviço configurada para o chat web.
Deve-se fornecer o URI do SIP da central de serviço para a solução de suporte da central de serviço usada. Deve-se especificar essas informações no assistente ao ativar uma transferência de chamada de um nó de diálogo ou etapa de ação. Para obter mais informações, consulte Transferindo uma chamada para um agente vivo.
Otimize suas ações para interação telefônica
Para melhorar ainda mais a experiência do cliente, projete seu diálogo com as capacidades da integração telefônica em mente:
-
Não inclua elementos HTML nas respostas de ação. Para adicionar formatação, use Markdown. Para obter mais informações, consulte Formatando respostas.
-
É possível usar uma extensão de procura para incluir os resultados da procura em ações que a integração telefônica lerá. Quando os resultados da procura são retornados, a integração do telefone lê a mensagem introdutória (por exemplo,
I found this information that might be helpful
) e, em seguida, lê apenas o corpo do primeiro resultado da procura.A resposta de procura inteira (ou seja, a mensagem introdutória mais o corpo do primeiro resultado da procura) deverá ter menos de 5.000 caracteres de comprimento ou a resposta não será lida. Certifique-se de testar os resultados da procura retornados e curar a coleta de dados usados conforme necessário.
Para obter mais informações sobre o uso de uma integração de procura, consulte Alavancando o conteúdo de ajuda existente.
Para obter mais informações sobre como implementar ações comuns por meio do diálogo, consulte Manipulando interações telefônicas.
Criando um tronco SIP
Se você não usar a opção para gerar um número de telefone gratuito, deverá configurar o tronco SIP usado pela integração telefônica. Localize um provedor e crie uma conta de tronco SIP, pela qual você deve pagar por uso.
Você pode configurar um tronco SIP das seguintes formas:
- Configurando um tronco SIP do Twilio
- Utilizar outros provedores de terceiros
- Trazer seu próprio tronco SIP
- Migrar de Voice Agent with Watson
Configuração de um tronco SIP do Twilio
Antes de iniciar a configuração de um Tronco SIP do Twilio, execute as etapas de pré-requisito a seguir:
- Crie uma conta Twilio no site da Twilio.
- Criar um tronco SIP
Se você já criou um tronco SIP, siga as etapas em Configurar um tronco SIP.
Criar um tronco SIP
-
Faça login no console do Twilio e vá para a seção Elastic SIP Trunking.
Observação: se você não vir o Elastic SIP Trunking, faça o seguinte:
- Procure por
Elastic SIP Trunking
na barra de pesquisa. - Clique em Painel de entroncamento do SIP elástico
- Procure por
-
No menu de navegação esquerdo, vá para Overview (Visão geral ) e clique em Get Started (Começar).
-
Clique em Create New Trunk (Criar novo tronco ) na barra de navegação Trunks (Troncos ).
-
Digite um nome para o seu tronco SIP no campo FRIENDLY NAME.
-
Clique no botão Criar. Um SID de tronco é atribuído quando você cria um novo tronco.
Para configuração de um tronco SIP, siga as etapas em Configurar um tronco SIP.
Configurar o tronco SIP
Para configurar um tronco SIP, faça o seguinte:
-
Na página Painel de Truncamento SIP Elástico, acesse Truncamento SIP Elástico.
-
Clique em Manage (Gerenciar ) no menu de navegação esquerdo.
-
Clique em Trunks e selecione o tronco SIP criado.
-
Clique em Origination (Origem ) para definir suas configurações.
-
Para adicionar o URI SIP de origem, clique no botão Add new Origination URI (Adicionar novo URI de origem ) e forneça valores para os seguintes campos:
- Origination SIP URI- Você pode obter o SIP URI para a sua integração telefônica na página de configuração de integração telefônica do site watsonx Assistant. Para fazer isso em watsonx Assistant, inicie as ferramentas e crie o Assistente. Escolha Incluir integração e selecione Telefone.. Em seu assistente, copie o URI do SIP e cole-o no campo URI do SIP de Origem do Twilio.
- Prioridade-A prioridade classifica a importância do URI Um número menor representa a maior importância.
- Peso-O Peso é usado para determinar o compartilhamento de carregamento quando mais de um URI tem a mesma prioridade Quanto maior o valor, mais carga um URI é fornecido.
- Ativado-É necessário alternar a alternância Ativado para
Yes
Isso significa que o URI do SIP de origem está ativado
-
Se você planeja suportar transferências de chamadas, ative o Call Transfer (REFER do SIP) no tronco SIP. Se quiser transferir chamadas para a rede pública de telefonia comutada (PSTN), ative também a Transferência PSTN no tronco.
-
Selecione Números na barra de navegação para o seu tronco SIP e, em seguida, faça uma das seguintes coisas:
- Clique em Incluir um número e, em seguida, Compre um número*.
- Se você já tem um número, você pode clicar em Adicionar um número e, em seguida, Adicionar um Número Existente.
Se você usar uma conta Lite ou versão de teste do Twilio para propósitos de teste, certifique-se de verificar o destino de transferência. Para obter mais informações, consulte a documentação do Twilio.
Não será possível ativar a autenticação SIP se você escolher Twilio como provedor de tronco SIP. O Twilio não suporta o SIPS para chamadas de origem.
Usando outros provedores de terceiros
Você pode pedir ajuda para configurar uma conta com outro provedor de tronco SIP abrindo uma solicitação de suporte.
A IBM estabeleceu relações com os seguintes provedores de tronco SIP:
O provedor de tronco SIP configura um tronco SIP para o tráfego de voz e gerencia o acesso por meio dos endereços IP permitidos. A maioria dos principais provedores de tronco SIP tem relações existentes com a IBM. Portanto, a configuração de rede necessária para suportar a conexão do tronco SIP geralmente pode ser feita com o mínimo de esforço.
-
Crie um IBM Cloud caso.
-
No campo Tópico, insira
watsonx Assistant
.. -
Na lista suspensa Subtópico, selecione
Phone & SMS Integration
.. -
No campo Assunto, insira
SIP trunk provider setup for watsonx Assistant
.. -
Inclua as informações a seguir na descrição:
- Nome da empresa
- O ID da conta IBM Cloud
- O nome do serviço watsonx Assistant
- Diagrama de rede com informações de endereço IP ou provedor de tronco SIP
Trazer seu próprio tronco SIP
Se você optar por usar um tronco SIP com o qual a IBM não tem um relacionamento estabelecido, você pode fazer isso.
A tabela a seguir lista os nomes completos de domínio e endereços IP usados para conexões SIP.
Local | Nomes de domínio | Endereços IP |
---|---|---|
Dallas | public.0001.voip.us-south.assistant.watson.cloud.ibm.com public.0002.voip.us-south.assistant.watson.cloud.ibm.com public.0003.voip.us-south.assistant.watson.cloud.ibm.com |
67.228.108.82 169.63.5.162 150.239.30.146 |
Frankfurt | public.0001.voip.eu-de.assistant.watson.cloud.ibm.com public.0002.voip.eu-de.assistant.watson.cloud.ibm.com public.0003.voip.eu-de.assistant.watson.cloud.ibm.com |
161.156.178.162 169.50.56.146 149.81.86.82 |
Londres | public.0001.voip.eu-gb.assistant.watson.cloud.ibm.com public.0002.voip.eu-gb.assistant.watson.cloud.ibm.com public.0003.voip.eu-gb.assistant.watson.cloud.ibm.com |
158.176.120.162 141.125.102.34 158.175.99.34 |
Seoul | public.0001.voip.kr-seo.assistant.watson.cloud.ibm.com | |
Sidney | public.0001.voip.au-syd.assistant.watson.cloud.ibm.com public.0002.voip.au-syd.assistant.watson.cloud.ibm.com public.0003.voip.au-syd.assistant.watson.cloud.ibm.com |
168.1.47.2 135.90.86.50 168.1.106.130 |
Tóquio | public.0001.voip.jp-tok.assistant.watson.cloud.ibm.com public.0002.voip.jp-tok.assistant.watson.cloud.ibm.com public.0003.voip.jp-tok.assistant.watson.cloud.ibm.com |
165.192.69.82 128.168.105.178 161.202.149.162 |
Washington, D.C. | public.0001.voip.us-east.assistant.watson.cloud.ibm.com public.0002.voip.us-east.assistant.watson.cloud.ibm.com public.0003.voip.us-east.assistant.watson.cloud.ibm.com |
52.116.100.158 169.61.70.162 169.59.136.194 |
Migrando do Voice Agent with Watson
Se você criou uma instância do serviço IBM® Voice Agent with Watson na IBM Cloud para permitir que os clientes se conectem a um assistente através do telefone, considere usar a integração telefônica. É possível usar a mesma conta SIP e o número de telefone que você configurou para uso com Voice Agent with Watson na integração do telefone.
A integração telefônica proporciona uma perfeita integração com o assistente. No entanto, atualmente a integração não suporta as funções a seguir:
- Chamada de saída
- Configurando locais de backup
- Encaminhamento de eventos para salvar relatórios de detalhes de chamadas no serviço de banco de dados IBM Cloudant for IBM Cloud
- Revisando a página de resumo de uso. Use IBM Log Analysis como alternativa. Para obter mais informações, consulte Visualizando logs .
Para migrar do Voice Agent with Watson para a integração telefônica do watsonx Assistant, conclua as etapas a seguir:
-
Na página Voice Agent with Watson, copie o número ou números de telefone que você usou para a conta SIP.
-
Ao configurar a integração telefônica do watsonx Assistant, inclua o número de telefone ou o conjunto de números que você copiou na etapa anterior.
-
Na página de configuração de integração de telefone, copie o Identificador Uniforme de Recursos (URI) do SIP.
-
Na conta do tronco SIP, substitua o URI do Voice Agent with Watson que você especificou anteriormente pelo URI copiado da página de configuração de integração de telefone na etapa anterior.
Por exemplo, para usar um tronco do SIP Twilio, você incluiria o Identificador Uniforme de Recursos (URI) do SIP do assistente no campo URI do SIP de origem do Twilio.
-
Se o provedor de tronco SIP ainda não estiver na lista de desbloqueio com a região do watsonx Assistant para a qual você está migrando, siga estas instruções para obter acesso ao tronco SIP.
Detalhes de roteamento de chamada
As chamadas recebidas para o assistente seguem este caminho:
-
Um cliente chama o número de telefone de suporte ao cliente que é gerenciado pelo provedor de tronco Protocolo de Inicialização de Sessão (SIP).
-
O serviço de tronco SIP envia uma solicitação SIP
INVITE
à integração telefônica do seu assistente para estabelecer uma conexão. -
A integração telefônica conecta-se aos serviços de fala que são necessários para suportar a interação.
-
Após os serviços estarem prontos, a conexão é estabelecida e o áudio é enviado por Protocolo de Transporte em Tempo Real (RTP).
O RTP é um protocolo de rede para entrega de áudio e vídeo sobre redes IP.
-
A ação de saudação do assistente é processada. O texto de resposta é enviado para o serviço Text to Speech para ser convertido em áudio e o áudio é enviado para o responsável pela chamada.
-
Quando o cliente diz alguma coisa, o áudio é convertido em texto pelo serviço Speech to Text e é enviado para o assistente para avaliação.
-
O assistente processa a entrada e calcula a melhor resposta. O texto de resposta do assistente é enviado para o serviço Text to Speech para ser convertido em áudio e o áudio é enviado de volta para o responsável pela chamada pela conexão existente.
-
Se o responsável pela chamada pedir para falar com uma pessoa, o assistente poderá transferir a pessoa para uma central de atendimento. Uma solicitação
REFER
do SIP é enviada para o provedor do tronco SIP para que ele possa transferir a chamada para o URI do SIP da central de atendimento que é especificado no nó de diálogo no qual a ação de transferência está configurada. -
Quando um dos participantes da chamada desliga, uma solicitação SIP
BYE
é enviada ao outro participante.