Rate Limits e Boas Praticas na API do WhatsApp

Tipos de Limites

A API do WhatsApp Business aplica dois tipos de limites que voce precisa entender e respeitar:

• Rate limit (msgs/segundo): Maximo de requisicoes por segundo ao endpoint de envio
• Tier de conversas (conversas/dia): Maximo de novas conversas business-initiated por dia

Limites Atuais da Cloud API

Os limites da Cloud API sao:

• Envio: 80 mensagens/segundo por numero de telefone
• Upload de midia: 50 requisicoes/segundo
• Download de midia: 25 requisicoes/segundo
• Gerenciamento de conta: 10 requisicoes/segundo

Lidando com Erro 429

Quando voce excede o rate limit, a API retorna HTTP 429. Implemente backoff exponencial:

async function enviarComRetry(payload, tentativas = 5) {
  for (let i = 0; i < tentativas; i++) {
    const res = await fetch(API_URL, { method: 'POST', body: JSON.stringify(payload) });
    if (res.status !== 429) return res;
    const espera = Math.pow(2, i) * 1000; // 1s, 2s, 4s, 8s, 16s
    await new Promise(r => setTimeout(r, espera));
  }
  throw new Error('Rate limit excedido apos todas as tentativas');
}

Estrategia de Filas

Para envios em grande volume, use uma fila de mensagens:

1. Adicione todas as mensagens a uma fila (Redis, SQS, BullMQ)
2. Processe a fila respeitando o limite de 80 msgs/segundo
3. Implemente dead letter queue para mensagens que falharam repetidamente
4. Monitore o tamanho da fila e alertas de atraso

Qualidade do Numero

A Meta monitora a qualidade do seu numero baseada em:

• Taxa de bloqueio pelos destinatarios
• Taxa de denuncia de spam
• Feedback negativo dos usuarios

Um numero com qualidade baixa pode ter seu tier reduzido ou ser suspenso temporariamente.

Boas Praticas de Envio

Enviar rapido nao e o objetivo — enviar de forma inteligente e sustentavel e.

• Distribua envios ao longo do dia, evitando picos
• Segmente sua base e envie apenas para contatos relevantes
• Monitore metricas de qualidade diariamente
• Remova numeros invalidos e inativos da base
• Implemente warm-up gradual para novos numeros

Conclusao

Respeitar os rate limits nao e apenas uma questao tecnica — e uma questao de saude da sua operacao no WhatsApp. Implemente filas robustas, monitore qualidade e envie de forma inteligente para manter sua conta em bom estado.