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.