Limites
A cota de requisições depende do plano da empresa e vale por janela de tempo. As respostas trazem o estado da cota para que o seu cliente reduza o ritmo antes de chegar ao limite.
Cabeçalhos
| Cabeçalho | Exemplo | Significado |
|---|---|---|
RateLimit-Policy |
600;w=60 |
Política do plano: 600 requisições por janela de 60 s. |
RateLimit |
limit=600, remaining=12, reset=31 |
Estado atual: restam 12 requisições, e a janela renova em 31 s. |
Retry-After |
31 |
Segundos até poder tentar de novo. Vem em 429, em 503 e em
409 de pausa automática.
|
Ao receber 429
- Pare de enviar para a mesma cota e espere o
Retry-After. - Repita com a mesma
Idempotency-Keynas operações que criam efeitos. -
Se o
429é frequente, distribua as chamadas no tempo usandoRateLimitem vez de esperar o erro.
Códigos possíveis: rate_limited (cota de
requisições) e instance_busy (fila de envio da
instância cheia).
Limites por operação
| O quê | Limite |
|---|---|
| Fila de envio por instância | 5.000 mensagens pendentes; acima disso, 429 instance_busy |
Verificação de números (contacts/check) |
até 50 números por lote e 1 lote a cada 10 s por instância (estimado, pode mudar) |
| Teste de webhook | 1 a cada 10 s por webhook |
| Paginação | limit de 1 a 100 |
| Tempo real | 50 conexões por empresa (estimado, pode mudar); mensagens do cliente até 4 KB e até 10 por segundo |
| Ticket de tempo real | 60 s, uso único |
Idempotency-Key |
até 128 caracteres; resposta guardada por 24 h |
Valores marcados como estimados ainda serão calibrados em produção (sujeitos a ajuste). Todos
podem mudar enquanto o contrato estiver em 1.0.0-draft.*; a
referência é a fonte de verdade.