Quando usar
- Você está vendo mensagens não entregues ou tickets não resolvidos e suspeita de Rate Limit
- Você precisa entender o que está dentro e fora do controle da ClaudIA
- Você quer saber o que fazer para evitar atingir o limite
Pré-requisitos
- Acesso ao painel do Helpdesk para verificar consumo de API
- (Para diagnóstico) Acesso ao Hub para verificar tickets com
Resolved in N2
Sobre este artigo
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. É exclusivo da plataforma de helpdesk e foge do controle da ClaudIA.
Por que isso afeta a ClaudIA
As integrações da ClaudIA são otimizadas para consumir o mínimo possível de requisições. Nossa arquitetura prioriza apenas as ações essenciais:
-
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
Mesmo com integração otimizada, há fatores fora do nosso controle:
Limitações do Helpdesk
-
Cada helpdesk define seus próprios limites em RPM (X requests/min)
-
Os limites variam por plano contratado
-
Alguns helpdesks aplicam limite global por conta — todas as integrações compartilham o mesmo teto
Configurações e uso do cliente
-
Recursos que multiplicam requisições (ex: split messages)
-
Alto volume de tickets em janelas curtas (milhares em poucas horas)
-
Outros sistemas/pessoas usando a API em paralelo, 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é o limite ser liberado
O que fazer para evitar
Como o controle do limite é sempre do helpdesk e depende das configurações e uso do cliente:
-
Acompanhe seu consumo de API na plataforma do helpdesk
-
Mapeie quais sistemas além da ClaudIA consomem a API
-
Revise configurações e evite recursos que geram requisições extras
-
Distribua melhor o volume de tickets ao longo do tempo
-
Solicite ao helpdesk aumento de limite ou upgrade de plano
-
Avalie alternativas sem restrição de API — como o Cloud Chat
O que significa "Resolved in N2" nas mensagens?
Quando a ClaudIA encontra bloqueio por Rate Limit, pode aparecer a mensagem de resolução em N2 com sinalização específica.
Observações
-
Para entender o transbordo automático por timeout: Como funciona o handover por timeout (Escalar Tickets sem Resposta)
-
Para Rate Limit específico do Zendesk: [Zendesk] Rate Limit e usos de RPM pela ClaudIA