Resposta curta
Segundo a documentação da Meta, cada número de telefone comercial da WhatsApp Cloud API suporta até 80 mensagens por segundo por padrão, chegando a 1.000 por upgrade automático para números elegíveis. Há limites separados para o mesmo destinatário, para chamadas de gerenciamento da Graph API e para o volume diário. Exceder a vazão retorna o erro 130429: reduza o ritmo, coloque os envios em fila e tente de novo com backoff.
Como chegar a 1.000 mensagens por segundo
O teto vale para cada número de telefone comercial e conta mensagens recebidas e enviadas de todos os tipos. A Meta faz o upgrade dos números elegíveis automaticamente e sem custo quando as três condições são atendidas. O upgrade pode levar até 1 minuto, e nesse período o número fica indisponível.
Números usados ao mesmo tempo no app WhatsApp Business e na Cloud API têm vazão fixa de 20 mensagens por segundo.
| Requisito | Detalhe |
|---|---|
| Limite de mensagens | Ilimitado no portfólio empresarial |
| Volume | 100.000 ou mais usuários únicos contatados fora das janelas de atendimento ao cliente em 24 horas móveis |
| Qualidade | Pontuação de qualidade AMARELA (média) ou superior |
Quatro limites diferentes e seus erros
| Limite | O que restringe | Erro típico |
|---|---|---|
| Vazão | Mensagens por segundo por número | 130429 |
| Limite por par | Mensagens de um número para o mesmo destinatário em pouco tempo | 131056 |
| Limites da Graph API | Chamadas de gerenciamento por app e conta | 4, 80007, 80008 |
| Limite de mensagens | Pessoas únicas alcançadas em 24 horas móveis | Restrições de envio |
Como tentar de novo com segurança
- Coloque cada envio em uma fila e esvazie a fila com um pool de workers.
- Mantenha o ritmo abaixo do seu teto, deixando margem para as respostas.
- Registre cada mensagem antes de enviar para que uma nova tentativa nunca a duplique.
- Tente de novo apenas erros de limitação e erros transitórios do servidor, com backoff exponencial e jitter, limitando o atraso e o número de tentativas.