Visão Geral
O que é?
O Disparador de Campanhas (Producer WhatsApp Trigger) é um Cloudflare Worker que permite o disparo em massa de mensagens do WhatsApp usando templates aprovados pela Meta. Ele funciona como uma API que recebe listas de contatos e enfileira as mensagens para envio através do Chatwoot.
Por que existe?
O WhatsApp Business API tem limitações rigorosas de rate limiting. O Disparador de Campanhas resolve isso:
- Validação prévia: Valida todos os contatos e templates antes de iniciar envio
- Processamento em lote: Divide listas grandes em chunks gerenciáveis
- Rate limiting inteligente: Controla velocidade de envio automaticamente
- Resiliência: Usa Cloudflare Queues para garantir que nenhuma mensagem se perca
- Escalabilidade: Cloudflare Workers escalam automaticamente
Arquitetura
Casos de Uso
✅ Quando usar
- Campanhas de marketing: Notificações de promoções, lançamentos
- Lembretes em massa: Pagamentos, consultas, eventos
- Notificações: Status de pedidos, alertas
- Re-engajamento: Clientes inativos, carrinhos abandonados
⚠️ Quando NÃO usar
- Conversas individuais: Use a API normal do Chatwoot
- Mensagens fora de template: WhatsApp exige templates aprovados
- Fora da janela de 24h: Apenas com templates específicos
Características Técnicas
| Característica | Valor |
|---|---|
| Platform | Cloudflare Workers |
| Queue | Cloudflare Queues |
| Rate Limit Default | 10 mensagens/segundo |
| Batch Size | Configurável (recomendado: 100-500) |
| Retry | 3 tentativas automáticas |
| Timeout | 30 segundos por requisição |
Limitações
- Templates obrigatórios: Todas as mensagens devem usar templates aprovados pela Meta
- Rate limiting do WhatsApp: ~80 mensagens/segundo (ajustável conforme tier)
- Janela de 24h: Mensagens proativas só funcionam dentro da janela ou com templates específicos
- Custo por mensagem: Varia por país (~R$ 0,15-0,30)
Próximos Passos
- Rotas da API - Documentação completa das endpoints
- Exemplos de Uso - Implementações práticas
- Schema do Banco - Estrutura do banco de dados