Principal Encerramento de conversas: Handover (N2) e Reter (N1) O que é Rate Limit em Helpdesks e por que afeta a ClaudIA

O que é Rate Limit em Helpdesks e por que afeta a ClaudIA

Última atualização em May 21, 2026

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:

  1. Acompanhe seu consumo de API na plataforma do helpdesk

  2. Mapeie quais sistemas além da ClaudIA consomem a API

  3. Revise configurações e evite recursos que geram requisições extras

  4. Distribua melhor o volume de tickets ao longo do tempo

  5. Solicite ao helpdesk aumento de limite ou upgrade de plano

  6. 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