Guia de configuração e uso

Este projeto utiliza o N8N (versão 2.4.4 - stable) e a API do WhatsApp (WAHA) para criar workflows automatizados. Siga os passos abaixo para configurar e executar o ambiente.

---

Pré-requisitos

• Docker Desktop
• Docker Compose
• Make

---

Instalação

$ git clone https://github.com/bladellano/n8n-waha.git

$ cd n8n-waha

$ cp .env.example .env

$ make up

Verificar Status dos Serviços

$ docker ps

Os containers devem mostrar status "healthy" após alguns segundos.

---

Acesso

• N8N: http://127.0.0.1:5678
• WAHA API: http://127.0.0.1:3000
• WAHA Swagger: http://127.0.0.1:3000/docs (admin/admin)

---

Variáveis de Ambiente

N8N

• GENERIC_TIMEZONE: Fuso horário (padrão: America/Sao_Paulo)
• WEBHOOK_URL: URL base para webhooks
• N8N_HOST: Host do servidor (padrão: 0.0.0.0)
• N8N_PORT: Porta do servidor (padrão: 5678)
• N8N_PROTOCOL: Protocolo HTTP/HTTPS (padrão: http)

WAHA

• WHATSAPP_DEFAULT_ENGINE: Engine padrão (NOWEB)
• WHATSAPP_HOOK_EVENTS: Eventos para webhook (message)
• WHATSAPP_HOOK_URL: URL do webhook no N8N

---

Instalação de dependências no n8n

No N8N, instale a extensão para integração com a API WAHA:

@devlikeapro/n8n-nodes-waha

---

Melhorias Implementadas

✅ Versão Estável do N8N: Atualizado para a versão 2.4.4 (stable - 16/01/2026) ✅ Health Checks: Monitoramento de saúde dos containers ✅ Restart Policy: Containers reiniciam automaticamente em caso de falha ✅ Volumes Otimizados: Corrigido mapeamento duplicado de volumes ✅ Variáveis com Defaults: Valores padrão para facilitar configuração ✅ Network Compartilhada: Comunicação eficiente entre serviços

---

Criação de workflow

Crie um workflow simples no N8N: um bot que responde a mesma mensagem recebida (ping-pong).