Uma Conexão WhatsApp representa um número conectado via WhatsApp Cloud API, permitindo que um agente atenda conversas diretamente no WhatsApp do cliente.
Dados da conexão
| Campo | Descrição |
|---|---|
| Nome | Identifica a conexão. |
| Número | Número associado à conexão, ex: +5511999998888. |
| Ativo | Controla se a conexão está recebendo mensagens. |
| Agente | Agente usado como fallback quando não há uma URA ativa vinculada à conexão. |
| Descrição | Observações livres sobre a conexão. |
Configuração da ligação (WhatsApp Cloud API)
Preencha esta seção depois de criar a conexão, com os dados obtidos no Meta for Developers:
| Campo | Descrição |
|---|---|
| Phone Number ID | ID do número na Cloud API. |
| WhatsApp Business Account ID | ID da conta de negócios do WhatsApp. |
| Access Token | Token de acesso da aplicação. Armazenado de forma criptografada. |
| Webhook Verify Token | Token usado pela Meta para validar o webhook. Armazenado de forma criptografada. |
| URL do Webhook | Gerada automaticamente pelo Rouxinol a partir da conexão — copie e registre no painel do App da Meta. |
| Proxy URL | Opcional. Se preenchida, todo evento de chamada recebido também é enviado (via POST) para essa URL, além do processamento normal pelo agente de IA. |
| Homologado | Marque manualmente depois de confirmar que o webhook foi validado no painel da Meta. |
Testando a conexão
A ação Testar Ligação, disponível na tela de edição, simula uma chamada recebida usando o SDP do próprio navegador (no lugar do SDP da Meta), conectando a uma sala no Janus com o agente configurado. Esse teste exige que o worker php artisan janus:whatsapp-listen esteja rodando.
Roteamento de mensagens
A ordem de prioridade para decidir qual agente atende uma conversa recebida é a mesma usada em SIP:
- URA ativa vinculada à conexão, se houver.
- Agente configurado como fallback na própria conexão do WhatsApp.
- Primeiro agente ativo da conta, caso nenhum dos anteriores esteja definido.