Limites e Boas Praticas
Limites de envio
Por lote
| Parametro | Limite |
|---|---|
| Destinatarios por lote | 1.000 |
| Lotes simultaneos | 3 por canal |
| Tamanho do texto | 4.096 caracteres |
Delay entre mensagens
| Parametro | Valor |
|---|---|
| Delay minimo | 1.000ms (1 segundo) |
| Delay recomendado | 3.000ms (3 segundos) |
| Jitter automatico | Ate 30% do delay configurado |
O jitter adiciona uma variacao aleatoria ao delay para simular comportamento humano e reduzir o risco de bloqueio pelo WhatsApp.
Rate limit da API
| Recurso | Limite |
|---|---|
| Criacao de lotes | 10 requisicoes/minuto |
| Consulta de status | 60 requisicoes/minuto |
| Cancelamento | 10 requisicoes/minuto |
Boas praticas
Horario de envio
- Envie mensagens em horario comercial (8h-18h) para melhor taxa de entrega
- Evite envios em massa durante madrugadas e finais de semana
- Respeite o fuso horario dos destinatarios
Delay e velocidade
- Use delay de pelo menos 3.000ms para canais Baileys
- Para canais WABA, o delay pode ser menor (1.000ms) pois a API oficial suporta maior volume
- Nunca use o delay minimo (1.000ms) em contas novas ou com pouco historico
Conteudo da mensagem
- Personalize as mensagens sempre que possivel (use templates com variaveis)
- Evite mensagens identicas para muitos contatos — isso aumenta o risco de bloqueio
- Para canais WABA, utilize templates aprovados pelo Meta para garantir a entrega
- Inclua opcao de opt-out para que o destinatario possa parar de receber mensagens
Monitoramento
- Acompanhe o status do lote via endpoint
GET /v1/bulk/:batchId - Configure um webhook para receber notificacao quando o lote for concluido
- Monitore a taxa de falha — taxas acima de 10% indicam problemas na lista de contatos
- Trate os erros retornados no array
errorsdo lote
Qualidade da lista de contatos
- Valide os numeros de telefone antes de enviar (formato DDI+DDD+NUM)
- Remova numeros invalidos ou desativados da lista
- Mantenha a lista atualizada — contatos antigos tem maior chance de falha
- Use o endpoint
POST /v1/bulk/validatepara validar contatos antes do envio
Cancelamento
- Cancele lotes com taxa de falha muito alta para preservar a reputacao do numero
- Mensagens ja enviadas nao sao afetadas pelo cancelamento
- Apos cancelar, investigue a causa das falhas antes de reenviar
Consequencias de uso inadequado
Atencao
O uso inadequado do envio em massa pode resultar em:
- Bloqueio temporario do numero pelo WhatsApp (24h-72h)
- Banimento permanente do numero em casos graves
- Suspensao da conta na plataforma Ogmma
Para evitar problemas, siga as boas praticas acima e respeite os limites estabelecidos.