Como conectar o WhatsApp
Conexões em /admin/whatsapp-connections. Cada linha pode ser só notificação ou também inbox do Chat. É o pré-requisito mais comum do Chat.
Pré-requisito
Permissão de WhatsApp. Para a conexão entrar na inbox, a flag Chat precisa estar ligada em Gerais e a conexão precisa ter Chat habilitado (não só notificação).
Maquete
| Número | Departamento | Chat | Status |
|---|---|---|---|
| +55 11 90000-0001 | Fiscal | Chat on | QR / conectado |
| +55 11 90000-0002 | — | Só notificação | Conectado |
Passo a passo
- Configurações → Conexões WhatsApp (ou o atalho do menu).
- Crie a conexão, escolha a API e escaneie o QR Code no celular.
- Defina o departamento da linha — a IA e a restrição por departamento usam isso.
- Marque se a conexão atende o Chat ou é só para notificação (faturas, atendimentos).
Glossário
| Campo | O que faz |
|---|---|
| QR Code | Pareia o aparelho com a API (UazAPI). Sem isso a linha não envia nem recebe. |
Chat habilitado (chat_enabled) | Se off, a conexão não cria conversa na inbox. Webhooks de mensagem são ignorados. Notificações transacionais continuam. |
| Notificação por WhatsApp (Gerais) | Flag global de disparos. Independente de chat_enabled. |
| Departamento da conexão | Roteia a conversa e escolhe o agente de IA daquele departamento (ou o default global). |
Erro comum
Chat ligado em Gerais, mas a conexão ficou como “só notificação”. A inbox permanece vazia. Edite a conexão e habilite o Chat nela.