WhatsApp

O Hedhog pode enviar mensagens de WhatsApp através de uma instância auto-hospedada da Evolution API, via uma ação de Integração de Webhook — disparada automaticamente sempre que um sistema externo chama um dos seus webhooks do Hedhog (ex.: o envio de um formulário de terceiros dispara uma notificação de WhatsApp).

O whatsapp-official (a API oficial WhatsApp Business Cloud) está presente no seed como provedor de catálogo para uso futuro, mas ainda não tem consumidor implementado nesta versão — apenas a Evolution API realmente envia mensagens hoje.

Status: ⚠️ Parcial — a Evolution API funciona através da ação de Integração de Webhook; o whatsapp-official é apenas catálogo, sem consumidor.

1. Auto-hospede a Evolution API e crie uma instância de WhatsApp (comandos abaixo)
2. Vá em Settings → Integrations and Webhooks, abra (ou crie) uma Webhook Integration e adicione uma ação WhatsApp (Evolution API)
3. Preencha os campos whatsapp_* diretamente na ação — nenhum Perfil de Integração necessário
4. Envie uma mensagem de teste e confirme que ela é de fato entregue ao telefone vinculado, não apenas um HTTP 200

docker run -d \
  --name evolution-api \
  -p 8080:8080 \
  -e AUTHENTICATION_API_KEY=your-api-key \
  atendai/evolution-api:latest

Substitua your-api-key por uma string aleatória segura — isso se torna o cabeçalho apikey que o Hedhog envia em cada requisição. O dashboard de gerenciamento fica disponível em http://localhost:8080.

Crie uma sessão de WhatsApp ("instância") antes de enviar qualquer coisa:

curl -X POST http://localhost:8080/instance/create \
  -H "apikey: your-api-key" \
  -H "Content-Type: application/json" \
  -d '{"instanceName": "my-instance", "qrcode": true}'

Escaneie o QR code retornado a partir de um telefone em WhatsApp → Aparelhos conectados → Conectar um aparelho. A sessão permanece ativa enquanto aquele telefone tiver acesso à internet — perder a conexão do telefone derruba a sessão e as mensagens começarão a falhar até você reconectar.

1. Vá em Settings → Integrations and Webhooks, abra (ou crie) uma Webhook Integration
2. Adicione uma ação do tipo WhatsApp (Evolution API) e preencha, diretamente na ação:

Esta ação só envia texto simples via sendText — ela não suporta mídia, botões ou listas.

• A WhatsApp Business Policy restringe mensagens em massa/não solicitadas a contatos que deram opt-in — enviar para pessoas que nunca consentiram arrisca ter o número banido pelo WhatsApp, não apenas pela Evolution API
• Sessões atreladas a um número de telefone pessoal são inerentemente frágeis: uma bateria descarregada, um logout do app ou a perda de conectividade naquele telefone quebra toda integração que depende dele
• O whatsapp-official (Cloud API da Meta) está catalogado mas não integrado — se você precisa de suporte oficial e estável em taxa de envio, terá que construir essa integração você mesmo por enquanto
• Para volume sério de produção, avalie a WhatsApp Business Cloud API oficial via um Meta Business Solution Provider em vez de uma sessão da Evolution API atrelada a um telefone

• Dispare a ação de webhook uma vez e confirme que a mensagem de fato chega ao telefone vinculado — não apenas que a chamada HTTP retornou 200
• Verifique o próprio dashboard da Evolution API para confirmar que a instância ainda aparece como conectada