Use este guia quando você precisar configurar, entender ou validar **Como conectar chamadas de voz do WhatsApp** 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 WhatsApp Calling, os clientes ligam para o seu número comercial diretamente do aplicativo WhatsApp e os agentes atendem no navegador.

**Antes de começar:**

* A caixa de entrada deve ser uma caixa de entrada do WhatsApp Cloud (a API oficial do WhatsApp Cloud). As caixas de entrada do WhatsApp conectadas por meio de outros provedores (como 360dialog) não podem usar chamadas.

* O número de telefone deve estar cadastrado na API do WhatsApp Business Calling. Caso contrário, a ativação da chamada falhará com uma mensagem solicitando que você integre o número primeiro ao Meta (ou ao seu provedor de soluções comerciais do WhatsApp).

**Etapas para ativar novas caixas de entrada:**

1. Na IAra, crie a caixa de entrada "Canal de chamada do WhatsApp" — *Configurações → Caixas de entrada → Adicionar caixa de entrada → Chamada do WhatsApp*.

   \

2. Faça o cadastro integrado para completar a integração da chamada de voz, uma vez feito isso a caixa de entrada estará pronta para fazer e receber ligações naquele número.

   \

**Etapas para ativar caixas de entrada existentes:**

1. Abra a guia de configurações "Chamadas" da caixa de entrada e ative "Ativar chamadas de voz".

   \

2. Se a caixa de entrada estiver conectada por meio de inscrição incorporada: alterne o sinalizador de chamada de voz. Se a caixa de entrada estiver conectada por meio de teclas manuais, certifique-se de ativar a assinatura de web-hook de chamadas em [developers.facebook.com](http://developers.facebook.com).

   \

**Observações sobre permissão/consentimento** 

O WhatsApp exige que a pessoa atendida permita o recebimento de chamadas. Se um agente tentar ligar para alguém que ainda não consentiu, a IAra envia uma solicitação de permissão em vez de fazer a chamada.

Esta solicitação mostra *"Enviou uma solicitação de permissão de chamada ao contato. Tente novamente assim que ele aceitar."* Depois que o contato aceitar, as chamadas serão realizadas normalmente. (Se uma solicitação foi enviada recentemente, a IAra aguarda antes de enviar outra solicitação de chamada.)

A mensagem de solicitação de permissão de chamada pode ser atualizada para enviar uma mensagem personalizada ao usuário e está disponível na guia Chamadas nas configurações da caixa de entrada.

---

## 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.