n8n-nodes-whatsapp-br

🇧🇷 Nós N8N para WhatsApp Business API - Versão Brasileira

Integração completa com WhatsApp Business API criada especialmente para o mercado brasileiro, com suporte completo a português e todas as funcionalidades necessárias para automações poderosas.

📦 Instalação

npm install n8n-nodes-whatsapp-br

✨ Versão JavaScript - Sem necessidade de compilação TypeScript!

Após instalar, reinicie o N8N e os nós estarão disponíveis imediatamente.

🚀 Recursos

✅ Nó Principal: WhatsApp BR

📱 Gerenciamento de Sessões

• ✅ Listar Sessões Conectadas
• ✅ Conectar Nova Sessão (QR Code)
• ✅ Desconectar Sessão
• ✅ Pausar Sessão
• ✅ Retomar Sessão
• ✅ Deletar Sessão

💬 Envio de Mensagens

• ✅ Enviar Texto
• ✅ Enviar Imagem (com legenda)
• ✅ Enviar Vídeo (com legenda)
• ✅ Enviar Áudio
• ✅ Enviar Documento/PDF
• ✅ Enviar Localização GPS
• ✅ Verificar se Número Está no WhatsApp

👥 Contatos e Grupos

• ✅ Listar Contatos
• ✅ Obter Detalhes de Contato
• ✅ Listar Grupos
• ✅ Obter Detalhes de Grupo

📁 Gerenciamento de Mídias

• ✅ Listar Downloads
• ✅ Baixar Mídia Específica
• ✅ Deletar Mídia

✅ Nós de Trigger: 2 Opções Disponíveis ⭐

WhatsApp Trigger (Simples)

Trigger tradicional com 1 saída - Recebe todas as mensagens em um único fluxo

WhatsApp Multi Trigger (Avançado)

Trigger com 6 saídas - Cada tipo de mensagem sai por uma porta diferente:

1. Texto
2. Imagem
3. Áudio
4. Vídeo
5. Documento
6. Outros (stickers, localizações, contatos, etc)

WhatsApp Router (Filtro Inteligente) ⭐ NOVO

Nó intermediário que filtra e roteia mensagens do Trigger:

• Conecta após o Trigger simples
• 6 saídas separadas por tipo
• Filtros automáticos de grupos e mensagens próprias
• Ideal para usar com o Trigger simples

Escolha conforme sua necessidade:

• Workflow simples → WhatsApp Trigger

• Workflows complexos (opção 1) → WhatsApp Trigger + WhatsApp Router ⭐

• Workflows complexos (opção 2) → WhatsApp Multi Trigger

• 📨 Mensagem Recebida (principal)

• 📤 Mensagem Enviada

• ✅ Status de Mensagem (entregue, lida)

• 🖼️ Mídia Recebida/Enviada

• ❤️ Reação Recebida/Enviada

• 👥 Eventos de Grupo (entrada, saída, atualização)

• 📞 Chamada Recebida

• 🟢 Presença Atualizada (online/offline)

• 📝 Contato Alterado

🌟 Múltiplas Saídas Automáticas:

O Trigger tem 9 saídas diferentes - Cada tipo de mensagem sai pela porta correta:

1. 💬 Texto - Mensagens de texto
2. 🖼️ Imagem - Fotos e imagens
3. 🎵 Áudio - Áudios e notas de voz
4. 🎥 Vídeo - Vídeos
5. 📄 Documento - PDFs, DOCs, etc
6. 🎨 Sticker - Figurinhas
7. 📍 Localização - Localizações
8. 👤 Contato - Contatos/vCards
9. 🔗 Outros - Outros tipos

Recursos do Trigger:

• ✅ Roteamento automático - Sistema decide por qual saída enviar
• ✅ Workflows diferentes - Conecte nós diferentes em cada saída
• ✅ Filtro de grupos - Padrão NÃO aceita grupos (mais seguro)
• ✅ Payload completo - Todas as saídas recebem dados completos
• ✅ Ícone padronizado - Mesmo visual dos outros nós

🔧 Configuração

1. Credenciais

Adicione as credenciais WhatsApp BR API no N8N:

2. Configurar Trigger

Passo 1: Adicionar o Nó

1. No N8N, adicione o nó "WhatsApp Trigger"
2. Selecione as credenciais criadas
3. Configure os parâmetros:
   • Sessão: Deixe vazio (todas) ou especifique uma
   • Eventos: Padrão = apenas "Mensagem Recebida" ⭐

Passo 2: Obter URL do Webhook

1. Com o workflow ativo, clique no Trigger
2. Copie a "Production URL" que aparece
3. Exemplo: https://seu-n8n.com/webhook/abc123

Passo 3: Registrar no Painel

1. Acesse o painel: http://seu-servidor:3000
2. Vá em "Webhooks"
3. Clique em "Adicionar Webhook"
4. Cole a URL do Trigger
5. Ative o toggle "Processar Resposta" (se quiser resposta automática)
6. Salve

Pronto! Agora as mensagens chegam no N8N automaticamente! 🎉

📖 Exemplos de Uso

Exemplo 1: Enviar Mensagem de Texto

{
  "Recurso": "Mensagem",
  "Operação": "Enviar Texto",
  "Sessão": "MinhaSessao",
  "Destinatário": "5511999999999",
  "Mensagem": "Olá! Esta é uma mensagem automática."
}

Exemplo 2: Enviar Imagem com Legenda

{
  "Recurso": "Mensagem",
  "Operação": "Enviar Imagem",
  "Sessão": "MinhaSessao",
  "Destinatário": "5511999999999",
  "URL da Mídia": "https://exemplo.com/imagem.jpg",
  "Legenda": "Confira esta imagem!"
}

Exemplo 3: Listar Grupos

{
  "Recurso": "Grupo",
  "Operação": "Listar Grupos"
}

Exemplo 4: Webhook com Resposta Automática

{
  "Eventos": ["message_received"],
  "Resposta Automática": true,
  "Mensagem de Resposta": "Obrigado! Recebi sua mensagem."
}

🔌 Fluxos de Exemplo

Fluxo 1: Responder Automaticamente

WhatsApp BR Trigger (message_received)
  ↓
Verificar conteúdo da mensagem
  ↓
WhatsApp BR (Enviar Texto)

Fluxo 2: Notificar Grupo Quando Receber Email

Email Trigger
  ↓
Formatar mensagem
  ↓
WhatsApp BR (Enviar Texto para Grupo)

Fluxo 3: Backup de Mídias

WhatsApp BR Trigger (media_received)
  ↓
WhatsApp BR (Baixar Mídia)
  ↓
Google Drive (Upload)

🌐 Endpoints da API

O nó se conecta aos seguintes endpoints:

🔐 Segurança

• ✅ Autenticação via Bearer Token
• ✅ Validação de credenciais automática
• ✅ Comunicação HTTPS recomendada
• ✅ Webhooks seguros com validação

📝 Changelog

v1.0.0

• ✅ Lançamento inicial
• ✅ Suporte completo a sessões
• ✅ Envio de todos os tipos de mídia
• ✅ Trigger com webhook
• ✅ Gerenciamento de contatos e grupos
• ✅ Downloads de mídias

🤝 Contribuindo

Contribuições são bem-vindas! Por favor:

1. Fork o projeto
2. Crie sua feature branch (git checkout -b feature/NovaFuncionalidade)
3. Commit suas mudanças (git commit -m 'Adiciona nova funcionalidade')
4. Push para a branch (git push origin feature/NovaFuncionalidade)
5. Abra um Pull Request

📄 Licença

MIT © Thiago D'Arezzo

📧 Contato: devthiper@gmail.com

🆘 Suporte

• 🌐 Site: https://developer.thiper.com
• 🐛 Issues: https://github.com/thiper/n8n-nodes-whatsapp-br/issues
• 📖 Documentação: https://developer.thiper.com

⭐ Créditos

Desenvolvido com ❤️ para a comunidade brasileira de automação.

Palavras-chave: n8n, whatsapp, whatsapp-business, automation, webhook, brasil, portuguese, messaging, api, integration