Quantas chamadas cada entrada aceita por minuto, como o limite é contado, o que vem no 429 com Retry-After e como repetir com segurança.
Nesta página
Os limites
Os limites valem por janela fixa: o contador começa na primeira chamada e zera
quando a janela termina.
Entrada
Limite
Contado por
POST /api/crm/integrations/leads
100 requisições a cada 60 segundos
Chave de API
GET /api/crm/forms/<token> e POST /api/crm/forms/<token>/submit
100 requisições a cada 60 segundos
Endereço IP de origem
POST /api/crm/workflows/<token>/trigger
100 requisições a cada 60 segundos
Endereço IP de origem
POST /api/servicedesk/monitoring/<token>
100 requisições a cada 60 segundos
Endereço IP de origem
POST /api/integrations/github/webhook e POST /api/integrations/gitlab/webhook
100 requisições a cada 60 segundos
Endereço IP de origem, por provedor
POST /api/whatsapp/webhook/meta e POST /api/whatsapp/webhook/zapi
120 eventos a cada 60 segundos
Conexão de WhatsApp
Rotas com sessão (/api/workspaces/<id>/...)
100 requisições a cada 60 segundos
Usuário, somando todas as rotas
Envio de arquivo com sessão (anexos, mídia, imagens)
10 envios de arquivo a cada 60 segundos
Usuário
Login e verificação em duas etapas (/api/auth/...)
10 tentativas a cada 15 minutos, com bloqueio de 30 minutos
Endereço IP e rota
Nota
O formulário do CRM e o gatilho de workflow somam no mesmo contador por
IP. Um servidor que dispara workflows e envia formulários tem 100 chamadas por
minuto para os dois juntos.
O que acontece no limite
Passou do limite, a API responde 429 com o header Retry-After (em segundos)
e o mesmo valor em error.details.retryAfterSeconds:
Leads: um lead em aberto com o mesmo e-mail ou telefone é devolvido com
200, sem duplicar.
Alertas de monitoramento: o mesmo externalId atualiza o alerta e não abre
outro chamado.
GitHub e GitLab: a entrega é identificada pelo id do evento e processada
uma vez só.
Workflows: cada chamada inicia uma nova execução. Se o seu sistema
pode reenviar, inclua um identificador seu no corpo e trate a repetição no
próprio workflow (por exemplo, buscando o registro antes de criar).
Tamanho do corpo
Além do número de chamadas, algumas entradas limitam o tamanho do corpo:
Entrada
Tamanho máximo
Acima disso
POST /api/servicedesk/monitoring/<token>
64 KB
422 SD_MONITOR_PAYLOAD_INVALID
POST /api/integrations/github/webhook e POST /api/integrations/gitlab/webhook
1 MB
413, em texto puro
Para ficar longe do limite
Envie em lotes pequenos e espalhados, em vez de rajadas.
Se vários servidores seus saem pelo mesmo IP, eles dividem o mesmo contador nas
entradas contadas por IP.
Use uma chave de API por sistema: cada chave tem o seu contador.
Precisa de mais? Escreva para o suporte contando o volume e o
caso de uso.
