v2026.5.5
Data de lançamento: 26 de maio de 2026
✨ Novas Funcionalidades
Canal Auxiliar WAHA para WhatsApp Official
Canais WhatsApp Official agora podem ter um canal WAHA (QR code) auxiliar vinculado, para suprir as limitações naturais da API oficial do WhatsApp.
Para que serve?
O WhatsApp Official possui restrições que o WAHA (conexão via celular) não tem. O canal auxiliar permite aproveitar o melhor dos dois mundos:
- Echoes de mensagens enviadas pelo celular — o canal oficial não envia eventos de mensagens enviadas diretamente no app; o canal auxiliar captura essas mensagens (
fromMe=true) e as registra no histórico da conversa - Envio fora da janela de 24h — quando a janela de resposta do Official expirou, um botão "Enviar via Canal Auxiliar" aparece no rodapé da conversa, permitindo enviar qualquer mensagem (texto, arquivos, áudio) através do WAHA
- Grupos do WhatsApp — o canal auxiliar pode receber e responder mensagens de grupos, com as configurações habituais de habilitar grupos e bloquear mídia
- Foto de perfil — o WAHA consegue buscar a foto de perfil de contatos que o Official não expõe
Como configurar?
- Acesse as configurações do canal WhatsApp Official desejado
- Role até a seção Canal Auxiliar WAHA
- Clique em Adicionar canal auxiliar WAHA
- Escaneie o QR code com o WhatsApp do celular — deve ser o mesmo número do canal oficial, em Modo Coexistência
- Ajuste as configurações:
- Ouvir mensagens do cliente — desativado por padrão para evitar duplicações com o canal oficial
- Ouvir minhas mensagens (from me) — ativado por padrão para capturar echoes
- Habilitar grupos e Bloquear mídia em grupos (se o módulo de grupos estiver ativado na organização)
Como funciona o envio fora da janela 24h?
- Quando a janela de resposta expira, o rodapé da conversa exibe os botões Usar Template e Enviar via Canal Auxiliar
- Ao clicar em "Enviar via Canal Auxiliar", o input completo de mensagens aparece (com suporte a arquivos, áudio, emoji e formatação)
- A mensagem é enviada pelo canal WAHA auxiliar e registrada normalmente no histórico da conversa
Comportamento do webhook no canal auxiliar
- Mensagens de clientes (
fromMe=false) são ignoradas por padrão (evita duplicação com o canal oficial) - Mensagens enviadas por mim (
fromMe=true) são processadas e vinculadas ao chat do canal oficial - Eventos de status, reações, edições, deleções e ligações também são roteados para o canal oficial correspondente
- O canal auxiliar não aparece na listagem geral de canais — fica visível apenas dentro das configurações do canal oficial
🎯 Benefícios
- ✅ Histórico completo de mensagens, incluindo as enviadas pelo celular
- ✅ Comunicação contínua mesmo após expirar a janela de 24h
- ✅ Suporte a grupos pelo canal WAHA sem criar um canal separado visível
- ✅ Configuração simples diretamente nas configurações do canal official
- ✅ Zero duplicação de mensagens — controle fino de quais eventos o auxiliar processa