Skip to Content

Ligue um número Twilio por meio de SIP

A ligação de um número Twilio como um número SIP externo permite que o seu agente de voz Versafy atenda chamadas para esse número e o utilize como número do chamador para as chamadas efetuadas. Isto é útil quando pretende manter o número e o encaminhamento de chamadas na sua própria conta Twilio enquanto utiliza o Versafy como um serviço telefónico de IA.

Para a ligação normal do Twilio sem um tronco SIP externo, utilize Ligue uma conta Twilio e um número de telefone. Suporta fluxos de entrada completos com operadores, programações, anúncios e correio de voz.

Esta configuração suporta:

  • chamadas recebidas do número Twilio para um agente de voz Versafy;
  • chamadas de saída individuais de um agente de voz;
  • saída Campanhas, quando disponível para o seu espaço de trabalho;
  • histórico de chamadas em Chamadas e gravações.

Limitação do fluxo de entrada SIP externo: Um número SIP externo só pode ser atribuído a um número ativo Apenas IA Fluxo de chamadas de entrada sem alinhamento para um humano. Se os chamadores precisarem de encaminhamento da operadora, filiais em horário comercial, anúncios ou correio de voz, utilize a ligação Twilio nativa do Versafy. Veja Fluxos de chamadas recebidas.

Antes de começar

Prepare o seguinte:

  • uma conta Twilio com permissão para comprar números e gerir Elastic SIP Trunks;
  • um projeto ou subconta Twilio que será proprietário do número e do tronco;
  • permissão para gerir números de telefone e fluxos de chamadas recebidas em Versafy;
  • um ativo Agente de voz para chamadas de entrada e saída;
  • um gestor de palavras-passe para o nome de utilizador e palavra-passe do tronco SIP.

As contas de teste da Twilio restringem a propriedade de números de telefone e destinos de saída. Atualize a conta Twilio antes da utilização e revisão em produção Restrições da conta de teste da Twilio .

Visão geral da configuração

Completará a ligação nesta ordem:

  1. Compre um número compatível com voz na Twilio.
  2. Crie um tronco SIP elástico da Twilio.
  3. Configurar o tronco Rescisão definições para chamadas de saída.
  4. Comece a importar o número em Versafy e copie o seu URI SIP de entrada.
  5. Adicione esse URI ao tronco Originação definições para as chamadas recebidas.
  6. Associe o número Twilio ao tronco.
  7. Atribua o número SIP externo a um fluxo de chamadas de entrada apenas AI.
  8. Teste as chamadas de entrada e saída.

1.º Compre um número compatível com a voz no Twilio

A compra de um número dedicado oferece aos clientes um número público para ligar e ao seu agente de voz um número de chamada aprovado para as chamadas efetuadas.

  1. Faça login no Console Twilio  e selecione o projeto ou subconta que pretende utilizar.
  2. Abrir Produtos e serviços → Números e remetentes → Números de telefone.
  3. Selecione Configurar um novo número de telefone.
  4. Escolha o país e o tipo de número e, em seguida, solicite o Voz capacidade nos filtros de pesquisa.
  5. Selecione um número, reveja as cobranças recorrentes e de utilização do Twilio e conclua a compra.
  6. Preencha qualquer pedido de identidade, morada ou registo regulamentar da Twilio para esse país e tipo de número.
  7. Copie o número adquirido no formato internacional E. 164, incluindo + e o código do país – por exemplo, +12025550123.

A interface do Twilio pode variar de acordo com a conta. Veja Guia atual de configuração do número de telefone da Twilio  se os rótulos na sua consola forem diferentes.

2.º Crie um tronco SIP elástico

O tronco é a ligação bidirecional entre o Twilio e o Versafy. Um dos lados envia as chamadas recebidas para o seu Voice Agent; o outro permite que o Voice Agent faça chamadas através da sua conta Twilio.

  1. Na consola da Twilio, abra Produtos e serviços → Elastic SIP Trunking → Gerir → Troncos.
  2. Selecione Criar novo tronco.
  3. Introduza um nome reconhecível Nome amigável, como Versafy Sales Line.
  4. Salve o porta-bagagens.

Mantenha o porta-bagagens aberto num separador do browser e o Versafy aberto noutro. Twilio’s Guia de entroncamento elástico SIP  explica as secções e a terminologia atuais da Consola.

3.º Configure o Twilio Termination para chamadas de saída

A terminação permite ao Versafy enviar uma chamada para o Twilio, que a liga ao número de destino do cliente.

  1. Abra o novo porta-bagagens Rescisão secção.
  2. Crie um único URI SIP de rescisão, como versafy-sales.pstn.twilio.com.
  3. Copie o nome do host completo. Irá inseri-lo em Versafy posteriormente sem sip: ou um porto.
  4. Em Autenticação, crie um Lista de credenciais.
  5. Adicione um novo nome de utilizador SIP e uma palavra-passe forte e exclusiva à lista.
  6. Associe esta Lista de Credenciais a este tronco e guarde as definições de Terminação.

Utilize o nome de utilizador e a palavra-passe da lista de credenciais SIP em Versafy, e não o SID da conta Twilio, o token de autenticação ou a palavra-passe da consola. A Twilio requer um URI de terminação e pelo menos um método de autenticação antes de o trunk poder fazer chamadas de saída.

Se ligar para destinos internacionais, ative apenas os países de que a sua empresa necessita nas permissões geográficas do Twilio Voice. Veja Guia de permissões geográficas da Twilio .

4. Importe o número para Versafy

A importação disponibiliza o número de propriedade da Twilio para Versafy sem ligar a conta completa da Twilio.

Navegação: Abrir Telefone → Números de telefone, selecione o Números separador e selecione Adicionar número externo (via SIP).

  1. Digite um claro Etiqueta, como Twilio Sales.

  2. Introduza o comprado Número de telefone no formato E. 164, incluindo + e o código do país.

  3. Expandir Configuração de entrada.

  4. Abaixo Encaminhamento de entrada/URI de origem, copie o completo URI SIP. Mantenha-o inalterado; irá colá-lo no Twilio na secção seguinte.

  5. Manter Criptografia de media definido como Permitido para a conexão inicial.

  6. Deixe inalterados os filtros opcionais de número de entrada, filtros de endereço de origem, lista de domínios, mapeamentos de cabeçalho e campos de autenticação, a menos que o seu administrador de telefonia tenha uma política específica para os mesmos.

  7. Expandir Configuração de saída e digite:

    • Endereço: o nome do host Twilio Termination, como versafy-sales.pstn.twilio.com. Não inclua sip: ou um porto.
    • Transporte: TCP (recomendado).
    • Criptografia de mídia: Desativado.
    • Nome de utilizador do tronco SIP: o nome de utilizador da lista de credenciais do Twilio.
    • Palavra-passe do tronco SIP: a palavra-passe da mesma lista de credenciais do Twilio.

  8. Deixe os cabeçalhos e os codecs de saída opcionais vazios para a configuração inicial.

  9. Selecione Importar.

Não active o Twilio Entroncamento seguro para esta configuração TCP. O Secure Trunking requer definições de TLS e suportes encriptados correspondentes em ambos os lados e rejeitará uma ligação que utilize as definições acima.

5.º Configure o Twilio Origination para chamadas de entrada

A originação informa o Twilio para onde enviar uma chamada quando um cliente marca o número adquirido.

  1. Regresse ao tronco no Twilio Console e abra Originação.
  2. Selecione Adicionar novo URI de origem.
  3. Insira um Nome amigável, como Versafy inbound.
  4. Cole o URI SIP completo copiado de Versafy. Inclui o número de telefone, o host, a porta e o transport=tcp configuração.
  5. Mantenha o URI Habilitado.
  6. Para um único URI, mantenha os valores padrão de prioridade e peso do Twilio.
  7. Guarde as configurações de origem.

Não substitua o número dentro do URI, remova transport=tcp, altere o esquema para sips:ou cole aqui o nome do host do Twilio Termination. O Twilio documenta o comportamento do URI de origem no seu Guia de configuração do Elastic SIP Trunking .

6.º Associe o número Twilio ao tronco

Associar o número ativa o tronco como rota de voz de entrada do número.

Mudança de rota: A associação do número a este tronco substitui a configuração anterior de voz de entrada no Twilio. Confirme se o número não está a servir outra aplicação de produção antes de continuar.

  1. Abra o porta-bagagens Números secção.
  2. Selecione Associar um número a este tronco.
  3. Escolha o número que comprou e confirme a adesão.
  4. Verifique se o número aparece na lista de números do tronco.

Se o Twilio abrir a página de configuração do número, escolha Entroncamento SIP para chamadas de voz recebidas, selecione este tronco e guarde.

7. Atribuir um fluxo de chamadas de entrada apenas para IA

O fluxo de entrada escolhe qual o Agente de Voz que serve esse número.

  1. Em Versafy, abra Telefone → Números de telefone → Fluxos de chamadas recebidas.
  2. Crie um fluxo utilizando o Apenas IA modelo.
  3. Selecione o número SIP externo importado e o Voice Agent que deverá atender.
  4. Reveja, crie e ative o fluxo.
  5. Voltar para o Números guia e confirme se o número mostra Fluxo de chamadas recebidas anexado e o nome do fluxo pretendido.

Se tiver criado o fluxo antes de importar o número, encontre o número em Números, escolha Ligue a um fluxo de chamadas de entradae selecione um fluxo ativo Apenas AI.

8. Teste ambas as direções de chamada

O teste de ambas as direções confirma que as atribuições de número, tronco, autenticação e Versafy funcionam em conjunto.

Testar chamadas recebidas

  1. Ligue para o número da Twilio a partir de um telefone fora da conta da Twilio.
  2. Confirme se o Agente de Voz esperado responde com a mensagem de abertura correta.
  3. Faça uma pergunta normal do teste e termine a chamada.
  4. Abrir Telefone → Registos e gravações de chamadas e confirme que a chamada aparece.

Testar chamadas de saída

  1. Abrir Telefone → Agentes de Voz.
  2. Encontre o agente ativo e selecione Faça uma chamada.
  3. Selecione o número Twilio importado como número do chamador.
  4. Introduza um destino de teste no formato E. 164 e confirme a chamada.
  5. Atenda a chamada e verifique o áudio bidirecional.
  6. Verifique Chamadas e gravações antes de repetir uma tentativa falhada ou pouco clara.

Também pode revisar Entroncamento SIP elástico → Registos em Twilio. O Twilio fornece verificações de tronco adicionais Teste o seu tronco Elastic SIP .

Solução de problemas

O número SIP externo não aparece para as chamadas efetuadas

Confirme que a importação foi concluída, o número mostra Saída ativada sob Telefone → Números de telefone → Números, e o Agente de Voz está ativo. Abrir Editar no número externo e verifique o endereço de saída e as credenciais.

As chamadas de saída falham com um erro de autenticação

Confirme se a lista de credenciais está anexada ao mesmo tronco Twilio e se o Versafy Nome de utilizador do tronco SIP e Palavra-passe do tronco SIP corresponda exatamente a ele. Não utilize credenciais de conta Twilio.

As chamadas efetuadas falham antes de tocar

Verifique isso:

  • Endereço contém apenas o nome do host Twilio Termination;
  • O destino inclui + e o seu código de país;
  • A Twilio permite chamadas para esse país de destino;
  • uma conta de teste está a ligar para um destino verificado pela Twilio;
  • o número Twilio continua a pertencer ao mesmo projeto ou subconta que o tronco.

As chamadas recebidas não chegam a Versafy

Confirme se o número Twilio está associado ao tronco correto, se o URI de origem está ativado e corresponde exatamente ao valor copiado de Versafy e se o número externo está atribuído a um fluxo AI Only ativo.

Não está disponível qualquer fluxo para o número SIP externo

Somente ativo Apenas IA fluxos sem alinhamento para um ser humano são elegíveis. Crie ou ative este tipo de fluxo ou utilize a ligação nativa do Twilio se precisar de uma viagem de chamada mais complexa.

A chamada é ligada, mas o áudio está em falta ou é unidirecional

Confirme se o Twilio Secure Trunking está desativado para esta definição e se as definições de encriptação de suporte Versafy correspondem a este guia. Se restringiu Endereços IP de origem permitidos, inclua todos os intervalos de sinalização atuais do Twilio, em vez de apenas uma região; revisão Lista atual de endereços IP de trunking SIP da Twilio .

Se o Twilio reportar um erro de suporte não suportado, edite o número SIP externo e adicione PCMU/8000 ou PCMA/8000 sob Codecs habilitados. Twilio’s guia de resolução de problemas de tronco  lista os codecs que aceita.

Precisa de alterar o número de telefone importado

Pode editar o seu rótulo e definições SIP, mas não o próprio número E. 164. Desligue-o de qualquer fluxo, apague o número SIP externo de Versafy e importe novamente o número correto. A sua eliminação de Versafy não liberta o número da sua conta Twilio.

Última atualização em
Início rápido