WhatsApp não-oficial (Baileys)
Uma conexão de WhatsApp feita escaneando um QR code, do mesmo jeito que você abre o WhatsApp Web. Cobre o que a API oficial não atende — em especial grupos. É um canal de uso interno, não um canal de IA para o cliente final.
Onde fica
Menu Configuração › Integrações › WhatsApp não-oficial — rota /config/integracoes/whatsapp-baileys. Duas abas: Visão geral e Sessões (QR).
Não substitui o WhatsApp Cloud API. O canal oficial é o recomendado para atendimento ao cliente final, com respaldo da Meta, templates e janela de 24h. O não-oficial é complementar — grupos e comunicação operacional.
Quando usar
| Situação | Canal indicado |
|---|---|
| Atendimento ao cliente final, 1 a 1 | WhatsApp Cloud API (oficial) |
| Conversas em grupos | WhatsApp não-oficial |
| Iniciar conversa fora das 24h | WhatsApp Cloud API (com template HSM) |
| Comunicação operacional interna | WhatsApp não-oficial |
Aba Sessões (QR)
Onde você conecta e gerencia as sessões. A tela se atualiza sozinha a cada poucos segundos.
- Clique em Conectar WhatsApp. Um QR code aparece.
- No celular, abra o WhatsApp → Aparelhos conectados → Conectar um aparelho e aponte a câmera para o QR.
- A sessão passa de Aguardando QR para Conectando e, então, Conectado. Os grupos e contatos são sincronizados.
Estados da sessão
Conectado · Conectando · Aguardando QR · Desconectado · Erro (a mensagem do erro aparece no card).
Cada card mostra rótulo, número/JID e contadores: grupos, contatos, mensagens, não lidas, quando conectou e o último evento.
Ações por sessão
- Abrir chat — vai para os Grupos de WhatsApp.
- Reconectar / Renovar QR — quando a sessão não está conectada.
- Ressincronizar — atualiza a lista de grupos.
- Reparar prévias — recalcula a última mensagem e o horário de cada conversa.
- Recuperar mídia — re-tenta baixar imagens, áudios e vídeos dos últimos 10 dias.
- Renovar sessão — gera um novo QR sem apagar os dados.
- Desconectar — encerra a conexão e limpa a autenticação, mas mantém os dados.
- Editar nome e Membros.
Remover é irreversível. Apaga a sessão e todos os dados dela — grupos, contatos, mensagens, mídias e a autenticação. Só use quando tiver certeza.
Riscos e limitações
- Não tem o respaldo da Meta — use com responsabilidade.
- Não suporta templates HSM nem a janela de 24h da API oficial.
- Depende do celular pareado seguir ativo; muito tempo offline pode derrubar a sessão.
- Volume alto de mensagens em massa aumenta o risco de bloqueio do número pela própria Meta.