Limites
Limites de taxa protegem a API contra uso indevido e picos que prejudicariam outras organizações. Limites de tamanho existem porque o WhatsApp Business Platform impõe os mesmos limites do outro lado — enviar além deles é rejeitado pela Meta de qualquer forma.
Tabela de limites
| Limite | Valor |
|---|---|
| Requisições por organização e credencial | 120 por minuto |
| Envio de mensagens por canal | 60 por minuto |
| Payload de mensagem enviada | 256 KiB |
| Teste de webhook por endpoint | 10 por hora |
| Resolução de link público por IP | 20 a cada 15 minutos |
| Conclusão de link público por IP | 10 a cada 15 minutos |
| Corpo do webhook recebido da Meta | 2 MiB |
| Imagem enviada | 5 MiB |
| Sticker (webp) | 500 KiB |
| Áudio e vídeo | 16 MiB |
| Documento (PDF e outros formatos de escritório) | 100 MiB |
Para arquivos grandes, prefira enviar uma URL https no payload da mensagem em vez de fazer upload por
POST .../media: esse upload passa pelo host do CRPRO Hub e pode ter um limite de tamanho de requisição menor do que o aceito diretamente pela Meta.Ao estourar o limite
Um limite de taxa excedido responde 429 RATE_LIMITED. Um limite de tamanho excedido responde 413 (mensagem ou payload de webhook) ou 400 INVALID_MEDIA (mídia enviada fora do tipo ou tamanho aceito pelo tipo).
- Não repita a requisição imediatamente. Recue por um intervalo — idealmente crescente a cada nova tentativa — antes de tentar de novo.
- Quando presente, o campo
details.retry_afterda resposta de erro traz o número de segundos recomendado antes da próxima tentativa. - O limite geral de requisições é por organização e credencial: uma chave de API separada, ou uma organização diferente, tem sua própria contagem.
Entrega de webhook
A entrega de eventos por webhook tem sua própria política, descrita em detalhe na página de Webhooks: até dez tentativas por evento, e o endpoint pausa automaticamente depois de 20 falhas consecutivas.
Nenhum destes limites é negociável por plano nesta fase — todo plano compartilha a mesma tabela. Se o seu caso de uso esbarra sistematicamente num limite de taxa, isso é sinal de que vale a pena rever o padrão de chamadas antes de tentar contorná-lo.