WhatsApp (conexão Baileys)
🛂 Permissão:
dashboard.view🔒 Plano: a conexão em si é livre; envio proativo (outbound) requerwhatsapp_outbound_enabled. 📍 Caminho: Configurações → WhatsApp
A 365 Vendas conecta um número de WhatsApp ao tenant via Baileys (gateway não-oficial baseado em WhatsApp Web). Uma vez conectado, o número passa a:
- Receber mensagens de clientes — encaminhadas para o agente de IA (Conversas IA).
- Enviar mensagens proativas automatizadas (reposição, cross-sell, reativação) — controlado pela Inteligência Comercial.
Pré-requisitos
- Um número de WhatsApp dedicado (idealmente celular comercial).
- Acesso físico ao celular para escanear o QR code (uma vez).
- Conexão de internet estável no celular — o Baileys mantém a sessão ativa replicando o WhatsApp Web.
Limitação: o WhatsApp Web (e Baileys) só permite 1 número por dispositivo. Se desconectar do celular, a integração também cai.
Estados da conexão
| Status | Significado |
|---|---|
| Desconectado | Sem sessão ativa. |
| Conectando... | Aguardando geração do QR. |
| Aguardando QR Code | QR pronto na tela; falta escanear. |
| Conectado ✅ | Sessão ativa, mensagens fluindo. |
Como conectar (1ª vez)
- Em Configurações → WhatsApp, clique em Conectar WhatsApp.
- Aguarde o QR code aparecer (até ~10 segundos).
- No celular, abra WhatsApp → Menu → Aparelhos Conectados → Conectar um aparelho.
- Aponte a câmera para o QR.
- O painel detecta a conexão automaticamente — status muda para Conectado e exibe o número.
Como reconectar
Se a sessão cair (queda de internet do celular, logout do WhatsApp Web):
- Volte em Configurações → WhatsApp.
- Clique em Conectar e refaça o QR.
A reconexão preserva o histórico — apenas restabelece a sessão.
Como desconectar
Em Configurações → WhatsApp, clique em Desconectar. A sessão é encerrada e o número fica livre para conectar em outro dispositivo.
Atenção: desconectar interrompe o agente de IA imediatamente. Mensagens recebidas durante esse período não são respondidas automaticamente.
O que o agente faz com mensagens recebidas
Quando o número está Conectado:
- Cliente novo: o agente cadastra automaticamente (Customer com telefone).
- O agente responde dúvidas sobre produtos, preços, estoque, status do pedido, horário de funcionamento (usando os dados de Configurações da loja).
- O agente fecha pedidos: confirma itens, endereço, frete, gera link de pagamento.
- Conversas ficam armazenadas (ver Conversas IA).
Mensagens proativas (outbound)
Habilitado se o plano tem whatsapp_outbound_enabled. Casos:
- Reposição — cliente costuma pedir o produto X a cada 30 dias; está há 35 sem pedir → mensagem "Hora de repor?".
- Cross-sell — cliente comprou Y; outros clientes costumam levar Z junto → sugestão.
- Reativação — cliente sumiu há mais de N dias.
- Disparo manual — vendedor envia mensagem direto pelo painel.
Templates configurados em Inteligência Comercial → WhatsApp (Inteligência comercial).
Boas práticas
- Dedique um número à 365 Vendas — não use o número pessoal do dono.
- O número precisa estar com WhatsApp aberto para o agente funcionar.
- Configure o horário de funcionamento (Configurações da loja) — o agente respeita.
- Modere o uso do disparo outbound — abuso pode ser denunciado pelos clientes e levar ao banimento do número pelo WhatsApp.
- Mantenha um plano B (telefone secundário, e-mail) caso a conexão caia.
Limitações conhecidas
- A integração Baileys depende do WhatsApp Web. Atualizações do WhatsApp podem quebrá-la temporariamente — em geral o suporte aplica patch rápido.
- Mensagens fora do horário comercial são respondidas se o agente estiver ativo. Para silenciar, defina o horário em Config. da Loja e o próprio agente respeita.
- O Baileys não é o WhatsApp Business API oficial. Para volumes muito grandes, considere migrar para o oficial (consulte o suporte).