ConectZap · Documentação

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

  1. Pare de enviar para a mesma cota e espere o Retry-After.
  2. Repita com a mesma Idempotency-Key nas operações que criam efeitos.
  3. Se o 429 é frequente, distribua as chamadas no tempo usando RateLimit em 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.