Como conectar canal de voz via Twilio

Use este guia quando você precisar configurar, entender ou validar Como conectar canal de voz via Twilio na IAra.

Antes de começar na IAra

• Confirme que seu usuário tem permissão para acessar a área citada no artigo.
• Faça a configuração primeiro em um cenário de teste, sempre que o recurso afetar atendimentos reais.
• Se o fluxo envolver WhatsApp, Meta, Twilio, e-mail, domínio, SAML, API ou outro provedor externo, confirme as credenciais e permissões antes de iniciar.

Guia detalhado

Com o Twilio Voice, os clientes ligam para um número de telefone real e os agentes atendem no navegador.

O que você precisa da sua conta Twilio:

• SID da conta e token de autenticação

• Um SID de chave de API e um segredo de chave de API (tokens seguros para conectar cada agente à chamada)

• Um aplicativo TwiML e um número de telefone da Twilio 

Etapas para criar uma nova caixa de entrada do canal de voz

1. Na IAra, crie (ou abra) a caixa de entrada "Canal de voz" — Configurações → Caixas de entrada → Adicionar caixa de entrada → Canal de voz.

   \

2. Insira seu número de telefone da Twilio e as credenciais da Twilio acima, insira seu "API Key SID" e "API Key Secret" e salve.

   \

3. A IAra mostrará dois URLs:

   • URL de voz do Twilio

   • URL de retorno de chamada de status da Twilio

4. Copie-os e atualize-os no painel do Twilio: cole o "URL de voz do Twilio" nas configurações do número de telefone do Twilio e no aplicativo TwiML e cole o "URL de retorno de chamada de status do Twilio" no campo de retorno de chamada de status do seu número de telefone.

Etapas para ativar o Voice em caixas de entrada existentes

1. Acesse a página de configurações da sua caixa de entrada. (Configurações > Caixas de entrada > {Nome da caixa de entrada})

2. Abra a guia de configurações "Voz" da caixa de entrada e ative o botão de opção "Ativar chamada de voz".

3. A IAra mostrará dois URLs:

   • URL de voz do Twilio

   • URL de retorno de chamada de status da Twilio

4. Copie-os e atualize-os no painel do Twilio: cole o "URL de voz do Twilio" nas configurações do número de telefone do Twilio e no aplicativo TwiML e cole o "URL de retorno de chamada de status do Twilio" no campo de retorno de chamada de status do seu número de telefone.

   \

5. Depois de salva, a caixa de entrada estará pronta para fazer e receber chamadas nesse número.

Como validar na IAra

1. Execute o fluxo em uma conta ou conversa de teste.
2. Confirme se o resultado aparece para o agente, gestor ou cliente exatamente como esperado.
3. Revise se o nome da caixa, time, etiqueta, assistente ou integração está claro para o restante da equipe.

Problemas comuns

• Usuário sem permissão para acessar a configuração.
• Nome de tela diferente entre versões ou contas.
• Recurso dependente de plano, provedor externo ou habilitação pela Digi2B.
• Falta de teste em conversa realista antes de liberar para a equipe.

Checklist final

• [ ] Configuração revisada por um administrador.
• [ ] Teste realizado com dado ou conversa controlada.
• [ ] Impacto para agentes e gestores entendido.
• [ ] Artigos relacionados revisados para evitar links quebrados.