O que é Rate Limit?
Rate Limit é uma restrição imposta pelos helpdesks (Zendesk, Hubspot, Intercom, Freshdesk, etc.) que limita quantas requisições podem ser feitas em um intervalo de tempo.
Essa limitação é exclusiva da plataforma de helpdesk e foge do controle da ClaudIA.
Por que isso afeta a ClaudIA?
As integrações da ClaudIA já são otimizadas para consumir o mínimo possível de requisições. Nossa arquitetura foi projetada para reduzir chamadas desnecessárias e priorizar apenas as ações realmente essenciais, como:
-
Enviar mensagens para usuários finais
-
Fechar/Resolver tickets automaticamente
-
Atribuir tickets para humanos (handover)
Cada uma dessas ações consome chamadas de API.
Por que posso atingir o Rate Limit então?
Mesmo com nossa integração otimizada, existem fatores fora do nosso controle:
Limitações do Helpdesk
-
Cada helpdesk define seus próprios limites de requisições em RPM (X requests por minuto).
-
Esses limites variam de acordo com o plano contratado.
-
Alguns helpdesks aplicam o limite global por conta, ou seja: todas as aplicações e integrações compartilham o mesmo teto.
Configurações e uso do Cliente
-
Recursos que multiplicam requisições, como split messages.
-
Alto volume de tickets concentrado em janelas curtas (ex.: milhares de atendimentos em poucas horas).
-
Outros sistemas ou pessoas usando a API em paralelo à ClaudIA, consumindo o mesmo limite.
-
Fluxos do Eddie que façam requisições adicionais ao helpdesk.
O que acontece ao atingir o Rate Limit?
-
Mensagens podem demorar ou não ser entregues.
-
Tickets podem não ser resolvidos ou reatribuídos no tempo esperado.
-
O helpdesk começa a rejeitar chamadas até que o limite seja liberado.
O que fazer para evitar?
Como o controle do limite é sempre do helpdesk e depende das configurações e uso do cliente, recomendamos:
-
Acompanhar seu consumo de API na própria plataforma.
-
Mapear quais sistemas além da ClaudIA estão consumindo a API.
-
Revisar suas configurações e evitar recursos que gerem requisições extras.
-
Distribuir melhor o volume de tickets ao longo do tempo, quando possível.
-
Solicitar ao helpdesk aumento de limite ou upgrade de plano.
-
Avaliar alternativas sem restrição de API, como o Cloud Chat.
O que significa “Resolved in N2” nas mensagens?
Quando a ClaudIA encontra um bloqueio causado por Rate Limit, pode aparecer a mensagem de resolução em N2 com dois possíveis motivos:
-
Resolved in N2. Reason: Failed to escalate due to an error.
→ Significa que o ticket não pôde ser escalado para N2 por limitação do helpdesk. Ele foi encerrado dessa forma apenas para evitar inconsistências com o helpdesk.-
Exemplo:
Resolved in N2. Reason: Handover by timeout.
→ Significa que o job de fallback conseguiu escalar o ticket para N2, mesmo após a falha inicial.- Exemplo:
-