Quando usar
- A ClaudIA parou de responder e você suspeita de Rate Limit do Zendesk
- Você quer entender quais chamadas de API a ClaudIA faz
- Você precisa dimensionar consumo para evitar atingir o limite
Pré-requisitos
- Zendesk integrado à ClaudIA
- Acesso à central de admin do Zendesk para verificar rate limits
Sobre este artigo
A integração da ClaudIA com Zendesk foi projetada com foco em alta performance e prevenção de exaustão:
-
Lógica de Rate Limit — backoff exponencial para espaçar requisições e permitir recuperação da API
-
Desligamento controlado — capacidade de desativar a ClaudIA simplesmente, caso seja necessário reduzir carga
Estrutura de Integração
A integração explora os endpoints do Zendesk/Sunshine de modo otimizado, reduzindo ao máximo a necessidade de requisições.
Chamadas de API principais
| Ação | Descrição | Frequência |
|---|---|---|
| Enviar mensagem | Envia mensagem da ClaudIA para o usuário | 1 requisição/mensagem |
| Resolver ticket | Marca o ticket como resolvido | 2 requisições/ticket (na finalização) |
| Reassign ticket (Handover) | Reatribui o ticket para humano | conforme necessário |
Quando o Rate Limit é atingido
Mensagens podem demorar ou não ser entregues, e tickets podem não ser fechados até o limite ser liberado.
Observações
-
Para entender Rate Limit em geral: O que é Rate Limit em Helpdesks e por que afeta a ClaudIA
-
Para handover por timeout: Como funciona o handover por timeout (Escalar Tickets sem Resposta)
-
Para tickets parados: [Zendesk] Como criar uma visualização para tickets parados