zendesk-api-rate-limit-requests-per-minute
eesel Team
Last edited 27 fevereiro 2026
{
"title": "Limites de taxa da API Zendesk: Um guia completo para desenvolvedores para 2026",
"slug": "zendesk-api-rate-limit-requests-per-minute",
"locale": "pt",
"date": "2026-02-27",
"updated": "2026-02-27",
"template": "default",
"excerpt": "Domine os limites de taxa da API Zendesk com este guia para desenvolvedores que cobre limites específicos do plano, tratamento de erros, estratégias de monitoramento e técnicas de otimização.",
"categories": [
"Zendesk",
"Guides"
],
"tags": [
"Zendesk API",
"Rate Limits",
"API Development",
"429 Errors",
"Integration"
],
"readTime": 12,
"author": 16,
"reviewer": 14,
"seo": {
"title": "Limites de taxa da API Zendesk: Um guia completo para desenvolvedores para 2026",
"description": "Domine os limites de taxa da API Zendesk com este guia para desenvolvedores que cobre limites específicos do plano, tratamento de erros, estratégias de monitoramento e técnicas de otimização.",
"image": "https://wmeojibgfvjvinftolho.supabase.co/storage/v1/object/public/public_assets/blog-gen/banner-9abbc92a-7120-4344-ad9c-b1c4c339c497"
},
"coverImage": "https://wmeojibgfvjvinftolho.supabase.co/storage/v1/object/public/public_assets/blog-gen/banner-9abbc92a-7120-4344-ad9c-b1c4c339c497",
"coverImageAlt": "Imagem do banner para limites de taxa da API Zendesk: Um guia completo para desenvolvedores para 2026",
"coverImageWidth": 1920,
"coverImageHeight": 1080,
"faqs": {
"heading": "Perguntas Frequentes",
"type": "blog",
"answerType": "html",
"faqs": [
{
"question": "O que acontece quando excedo os limites de taxa de requisições por minuto da API Zendesk?",
"answer": "A API retorna um código de status 429 Too Many Requests (Muitas Requisições) com um cabeçalho Retry-After (Tentar Novamente Após) indicando quantos segundos esperar antes de tentar novamente. Seu código deve lidar com isso de forma adequada e pausar as requisições até o tempo de reinicialização."
},
{
"question": "Os limites de taxa da API Zendesk são reiniciados no início de cada minuto?",
"answer": "Os limites de taxa são reiniciados de forma contínua, não em intervalos fixos. O cabeçalho ratelimit-reset fornece o timestamp Unix quando sua janela de limite de taxa atual é reiniciada."
},
{
"question": "Posso aumentar meu limite de taxa da API Zendesk sem atualizar meu plano?",
"answer": "O add-on High Volume API (API de Alto Volume) aumenta os limites para 2500 requisições por minuto em planos qualificados. Alternativamente, otimizar sua integração por meio de loteamento, cache e webhooks pode reduzir significativamente o uso da API."
},
{
"question": "Diferentes endpoints da API Zendesk têm diferentes limites de taxa?",
"answer": "Sim. Embora a maioria dos endpoints use o limite de toda a sua conta, alguns têm limites específicos. Os Incremental Exports (Exportações Incrementais) são limitados a 10 requisições por minuto, e o endpoint Update Ticket (Atualizar Ticket) permite 30 atualizações por 10 minutos por usuário por ticket."
},
{
"question": "Como posso monitorar meu uso da API Zendesk ao longo do tempo?",
"answer": "Use o painel de uso da API no Admin Center (Conta > Uso > API) para visualizar resumos de 7 dias, rastrear erros 429 e ver quais endpoints consomem mais requisições."
}
],
"supportLink": null
}
}
---
Se você estiver criando integrações com o Zendesk, receber um erro 429 Too Many Requests (Muitas Requisições) às 2 da manhã não é divertido. Entender os limites de taxa da API Zendesk antes de começar a codificar evita sessões de depuração frenéticas e stakeholders irritados se perguntando por que a sincronização de tickets deles parou de funcionar.
Este guia detalha tudo o que você precisa saber sobre os limites de taxa da API Zendesk. Abordaremos os limites escalonados por plano, como monitorar seu uso em tempo real e estratégias práticas para lidar com erros de limite de taxa de forma adequada. Seja para sincronizar dados de tickets, criar um painel personalizado ou automatizar fluxos de trabalho, você aprenderá como criar integrações que permaneçam dentro dos limites, oferecendo desempenho confiável.
Para equipes que preferem não lidar com limites de taxa, existe outro caminho. [eesel AI](https://www.eesel.ai/) se conecta diretamente ao [Zendesk](https://www.eesel.ai/integration/zendesk-ai) e lida com o limite de taxa automaticamente. Exploraremos ambas as abordagens para que você possa escolher o que se adapta à sua equipe.
## Entendendo os limites de taxa escalonados do Zendesk
O Zendesk aplica diferentes limites de taxa dependendo do seu tipo de plano e dos endpoints específicos da API que você está usando. Vamos detalhar o que você precisa saber.
### Limites de taxa por nível de plano
Os limites de taxa da API Support e Help Center variam significativamente com base no seu plano Zendesk:
| Plano | Requisições por minuto |
|------|---------------------|
| Team | 200 |
| Growth | 400 |
| Professional | 400 |
| Enterprise | 700 |
| Enterprise Plus | 2500 |
| Add-on High Volume API (API de Alto Volume) | 2500 |
Fonte: [Documentação de Limites de Taxa do Zendesk](https://developer.zendesk.com/api-reference/introduction/rate-limits/)
O add-on High Volume API (API de Alto Volume) aumenta seu limite para 2500 requisições por minuto. Ele está disponível nos planos Zendesk Suite Growth e superiores, e nos planos Zendesk Support Professional e superiores. Você precisará de um mínimo de 10 licenças de agentes para adquirir este add-on. Os planos Enterprise Plus incluem este add-on por padrão.
### Limites específicos do endpoint
Alguns endpoints têm seus próprios limites de taxa que substituem os limites de toda a conta:
| Endpoint | Limite de taxa |
|----------|------------|
| Incremental Exports (Exportações Incrementais) | 10 requisições por minuto |
| List Tickets (Listar Tickets) (páginas >500) | 50 requisições por minuto |
| Update Ticket (Atualizar Ticket) | 30 atualizações por 10 minutos por usuário por ticket |
| Chat API | 200 requisições por minuto (todos os planos) |
Fonte: [Documentação de Limites de Taxa do Zendesk](https://developer.zendesk.com/api-reference/introduction/rate-limits/)
O endpoint Incremental Export (Exportação Incremental) é particularmente importante se você estiver sincronizando grandes conjuntos de dados. Você só pode fazer 10 requisições por minuto para esses endpoints, embora isso aumente para 30 requisições por minuto se você tiver o add-on High Volume API (API de Alto Volume).
### Considerações sobre a API Help Center
A API Help Center usa os mesmos limites de taxa que a API Support. No entanto, as requisições para a API Help Center não contam para o seu limite de taxa da API Support, e vice-versa. Isso significa que você pode fazer 700 requisições para a API Support e outras 700 requisições para a API Help Center simultaneamente em um plano Enterprise.
## Monitorando as requisições por minuto do limite de taxa da API Zendesk em seu código
O Zendesk fornece cabeçalhos de resposta que permitem que você monitore o status do seu limite de taxa em tempo real. Isso é essencial para criar integrações que podem adaptar sua taxa de requisição dinamicamente.
### Entendendo os cabeçalhos de resposta
Cada resposta da API do Zendesk inclui cabeçalhos que informam o status atual do seu limite de taxa:
- **X-Rate-Limit** ou **ratelimit-limit**: O limite de taxa atual da sua conta (por exemplo, 700)
- **X-Rate-Limit-Remaining** ou **ratelimit-remaining**: Número de requisições restantes no minuto atual
- **ratelimit-reset**: Timestamp Unix quando a janela de limite de taxa atual é reiniciada
- **zendesk-ratelimit-tickets-index**: Informações adicionais de limite para endpoints de listagem de tickets
Para endpoints de listagem da API Ticketing, como List Tickets (Listar Tickets) ou Search Users (Pesquisar Usuários), você obtém cabeçalhos adicionais:
x-rate-limit: 700 ratelimit-limit: 700 x-rate-limit-remaining: 699 ratelimit-remaining: 699 ratelimit-reset: 41 zendesk-ratelimit-tickets-index: total=100; remaining=99; resets=41
Fonte: [Melhores Práticas do Zendesk para Evitar Limites de Taxa](https://developer.zendesk.com/documentation/api-basics/best-practices/best-practices-for-avoiding-rate-limiting/)
### Lendo cabeçalhos em Python
Veja como extrair e usar cabeçalhos de limite de taxa em Python:
```python
import requests
import time
def call_zendesk_api():
url = "https://subdomain.zendesk.com/api/v2/tickets"
headers = {"Authorization": "Bearer YOUR_ACCESS_TOKEN"}
response = requests.get(url, headers=headers)
should_continue = handle_rate_limits(response)
if should_continue:
# Process the API response
pass
def handle_rate_limits(response):
account_limit = response.headers.get("ratelimit-remaining")
endpoint_limit = response.headers.get("Zendesk-RateLimit-Endpoint")
account_limit_reset = response.headers.get("ratelimit-reset")
if account_limit:
account_remaining = int(account_limit)
if account_remaining > 0:
if endpoint_limit:
endpoint_remaining = int(endpoint_limit.split(";")[1].split("=")[1])
if endpoint_remaining > 0:
return True
else:
endpoint_reset = int(endpoint_limit.split(";")[2].split("=")[1])
handle_limit_exceeded(endpoint_reset)
else:
return True
else:
handle_limit_exceeded(account_limit_reset)
return False
def handle_limit_exceeded(reset_time):
wait_time = int(reset_time) - int(time.time()) + 1
print(f"Rate limit exceeded. Waiting {wait_time} seconds...")
time.sleep(wait_time)
Fonte: Documentação de Melhores Práticas do Zendesk
Lendo cabeçalhos em JavaScript
Aqui está a mesma lógica em JavaScript com async/await:
const axios = require('axios');
async function callZendeskAPI() {
const url = "https://subdomain.zendesk.com/api/v2/tickets";
const headers = {"Authorization": "Bearer YOUR_ACCESS_TOKEN"};
try {
const response = await axios.get(url, { headers });
const shouldContinue = handleRateLimits(response);
if (shouldContinue) {
// Process the API response
}
} catch (error) {
console.error(error);
}
}
function handleRateLimits(response) {
const accountLimit = response.headers["ratelimit-remaining"];
const endpointLimit = response.headers["Zendesk-RateLimit-endpoint"];
const accountLimitReset = response.headers["ratelimit-reset"];
if (accountLimit) {
const accountRemaining = parseInt(accountLimit);
if (accountRemaining > 0) {
if (endpointLimit) {
const endpointRemaining = parseInt(endpointLimit.split(";")[1].split("=")[1]);
if (endpointRemaining > 0) {
return true;
} else {
const endpointReset = parseInt(endpointLimit.split(";")[2].split("=")[1]);
handleLimitExceeded(endpointReset);
}
} else {
return true;
}
} else {
handleLimitExceeded(accountLimitReset);
}
}
return false;
}
async function handleLimitExceeded(resetTime) {
const waitTime = (resetTime || 60) - Math.floor(Date.now() / 1000) + 1;
console.log(`Rate limit exceeded. Waiting ${waitTime} seconds...`);
await new Promise(resolve => setTimeout(resolve, waitTime * 1000));
}
Fonte: Documentação de Melhores Práticas do Zendesk
Lidando com erros 429 Too Many Requests (Muitas Requisições)
Quando você excede as requisições por minuto do limite de taxa da API Zendesk, a API retorna um código de status 429. A forma como você lida com essa resposta determina se sua integração falha de forma adequada ou quebra completamente. Para obter mais contexto sobre a criação de integrações robustas, consulte nosso guia sobre melhores chatbots de IA para Zendesk.
O que significam os erros 429
Uma resposta 429 Too Many Requests (Muitas Requisições) indica que você atingiu o limite de taxa. A resposta inclui um cabeçalho Retry-After que informa quantos segundos esperar antes de tentar novamente:
HTTP/1.1 429
Status: 429
Retry-After: 93
Neste exemplo, você deve esperar 93 segundos antes de fazer outra requisição. Ignorar este cabeçalho e continuar fazendo requisições pode resultar em erros nulos que dificultarão a depuração.
Fonte: Documentação de Melhores Práticas do Zendesk
Implementando backoff exponencial
Para integrações de produção, implemente backoff exponencial para lidar com os limites de taxa de forma adequada:
import time
import random
def make_request_with_backoff(url, headers, max_retries=5):
for attempt in range(max_retries):
response = requests.get(url, headers=headers)
if response.status_code == 200:
return response
elif response.status_code == 429:
retry_after = int(response.headers.get('Retry-After', 60))
# Exponential backoff with jitter
wait_time = retry_after * (2 ** attempt) + random.uniform(0, 1)
print(f"Rate limited. Waiting {wait_time:.1f} seconds...")
time.sleep(wait_time)
else:
response.raise_for_status()
raise Exception("Max retries exceeded")
A abordagem de backoff exponencial aumenta o tempo de espera entre as tentativas, reduzindo a chance de sobrecarregar o servidor e, ao mesmo tempo, melhorando a probabilidade de requisições bem-sucedidas.
Melhores práticas para tratamento de erros
Aqui estão as principais práticas para lidar com limites de taxa em produção:
- Nunca ignore erros 429. Continuar fazendo requisições após atingir o limite pode fazer com que sua integração falhe com erros nulos inúteis.
- Sempre analise o cabeçalho Retry-After. Isso informa exatamente quanto tempo esperar.
- Implemente padrões de disjuntor para aplicações de alto volume. Se você atingir consistentemente os limites de taxa, pause temporariamente as requisições em vez de tentar novamente imediatamente.
- Registre eventos de limite de taxa. Rastreie quando e por que você atingiu os limites para identificar oportunidades de otimização.
- Projete para degradação adequada. Sua aplicação deve continuar funcionando mesmo quando as requisições da API estiverem atrasadas.
Monitorando o uso da API no Zendesk
Além de monitorar os cabeçalhos em seu código, o Zendesk fornece ferramentas para rastrear o uso da sua API ao longo do tempo.
Usando o painel do Admin Center
Você pode visualizar o uso da sua API no Zendesk Admin Center:
- Vá para Admin Center > Conta > Uso > API
- Visualize o resumo de 7 dias mostrando seu uso em relação ao seu limite de taxa
- Verifique a porcentagem de erros 429 durante os últimos sete dias
- Veja quantas vezes você se aproximou do seu limite (90-99% da capacidade)
O painel mostra as requisições da API ao longo do tempo com tabelas detalhando o total de requisições por chamadores e endpoints. O conteúdo é atualizado diariamente, embora possa levar até 72 horas para que o uso atual apareça.
Fonte: Gerenciando o uso da API em sua conta Zendesk
Observação: o painel de uso da API não está disponível para contas que usam mais de 2500 requisições por minuto ou contas independentes que não incluem o Support.
Notificações de uso da API
O Zendesk fornece notificações quando você se aproxima do seu limite de taxa:
- Avisos de quase violação: Alertas quando as chamadas da API medem entre 90-99% do limite do seu plano
- Rastreamento de erros 429: Monitore a porcentagem de requisições que retornam erros de limite de taxa
- Resumos diários: Rastreie as tendências nos últimos 7 dias
O monitoramento regular ajuda você a identificar padrões e planejar aumentos de capacidade antes que atingir os limites afete suas operações.
Otimizando sua integração de API
Um design de integração inteligente reduz o uso da sua API sem sacrificar a funcionalidade. Aqui estão estratégias comprovadas para permanecer dentro das requisições por minuto do limite de taxa da API Zendesk. Se você estiver procurando por uma compreensão mais profunda das ferramentas de suporte baseadas em IA, confira nossa análise do Zendesk AI.
Loteamento de requisições
Em vez de fazer chamadas de API individuais para cada ticket, use endpoints de lote:
- endpoints show_many: Busque vários tickets, usuários ou organizações em uma única requisição
- Side-loading: Use o parâmetro
includepara buscar dados relacionados (como comentários de tickets) em uma chamada - Atualizações em massa: Atualize vários tickets com uma única requisição quando possível
O loteamento pode reduzir o volume de chamadas da sua API em 50-90%, dependendo do seu caso de uso.
Implementando cache
Armazene em cache os dados que não mudam com frequência:
- Dados de usuário e organização: Armazene em cache por horas ou dias, pois isso muda com pouca frequência
- Metadados de ticket: Armazene em cache campos de ticket, tags e definições de campos personalizados
- Artigos da Central de Ajuda: Armazene em cache o conteúdo do artigo com cabeçalhos de cache apropriados
Implemente a invalidação de cache usando webhooks do Zendesk para limpar os dados armazenados em cache quando ocorrerem alterações, garantindo que sua integração permaneça atualizada sem polling excessivo.
Usando webhooks em vez de polling
Fazer polling da API para verificar se há alterações é ineficiente e consome rapidamente seu limite de taxa. Os webhooks do Zendesk notificam seu sistema quando os eventos ocorrem:
- Eventos de ticket: Seja notificado quando os tickets são criados, atualizados ou resolvidos
- Alterações de usuário: Receba atualizações quando os perfis de usuário mudarem
- Atualizações de organização: Rastreie as alterações na associação da organização
Os webhooks eliminam a necessidade de polling constante, reduzindo drasticamente o uso da API e, ao mesmo tempo, fornecendo atualizações em tempo real.
Exportações incrementais para grandes conjuntos de dados
Ao sincronizar grandes volumes de dados, use a API Incremental Export (Exportação Incremental):
- Solicite apenas os itens que foram alterados desde a sua última sincronização
- Use a paginação baseada em cursor para um tratamento eficiente de grandes conjuntos de dados
- Permaneça dentro do limite de 10 requisições por minuto (30 com o add-on High Volume)
Essa abordagem é muito mais eficiente do que buscar repetidamente todos os tickets, especialmente para contas com altos volumes de tickets.
Fonte: Documentação de Exportações Incrementais do Zendesk
Quando atualizar para a API High Volume (Alto Volume)
Às vezes, a otimização não é suficiente. Veja como saber quando você precisa do add-on High Volume API (API de Alto Volume). Para uma visão geral completa dos recursos do Zendesk, leia nossa análise do Zendesk.
Sinais de que você precisa do add-on
Considere atualizar se você tiver:
- Atingindo consistentemente 700 requisições por minuto em planos Enterprise
- Atrasos na integração que afetam as operações de negócios
- Volume crescente de tickets que ultrapassa seu limite atual
- Várias integrações competindo pelo mesmo pool de limite de taxa
- Erros 429 frequentes, apesar dos esforços de otimização
Preços e requisitos
O add-on High Volume API (API de Alto Volume):
- Aumenta seu limite para 2500 requisições por minuto
- Disponível nos planos Zendesk Suite Growth+ e Support Professional+
- Requer um mínimo de 10 licenças de agentes
- Incluído sem custo extra com os planos Enterprise Plus
Fonte: Sobre os Add-ons do Zendesk
Antes de atualizar, audite seu uso atual da API. Muitas equipes descobrem que podem otimizar para sair dos problemas de limite de taxa sem custos adicionais.
Alternativa: Deixe o eesel AI lidar com os limites de taxa para você
Criar e manter uma integração compatível com o limite de taxa exige um esforço de engenharia significativo. Se você preferir se concentrar em seu produto principal em vez de gerenciar cotas de API, oferecemos uma alternativa.
eesel AI se conecta diretamente ao Zendesk e lida com o limite de taxa automaticamente. Nosso sistema:
- Monitora os cabeçalhos de limite de taxa em tempo real
- Implementa enfileiramento e backoff inteligentes de requisições
- Usa loteamento otimizado para minimizar as chamadas da API
- Fornece atualizações baseadas em webhook em vez de polling
- Escala perfeitamente à medida que seu volume de tickets aumenta
Em vez de escrever código personalizado para lidar com erros 429 e backoff exponencial, você configura automações em linguagem simples. Lidamos com a complexidade técnica de permanecer dentro dos limites de taxa do Zendesk enquanto suas integrações são executadas de forma confiável. Saiba mais sobre nossos recursos do Agente de IA do Zendesk.
Para equipes que criam integrações personalizadas, nossa referência da API de automação do Zendesk fornece orientação técnica adicional.
Comece a criar integrações Zendesk confiáveis hoje mesmo
Entender os limites de taxa da API Zendesk é essencial para qualquer projeto de integração. As principais conclusões:
- Conheça os limites do seu plano: 200-2500 requisições por minuto, dependendo do seu nível
- Monitore os cabeçalhos de limite de taxa para rastrear o uso em tempo real
- Implemente backoff exponencial para erros 429
- Use o painel do Admin Center para rastrear padrões de uso
- Otimize com loteamento, cache e webhooks
- Considere o add-on High Volume API (API de Alto Volume) quando a otimização não for suficiente
Se você estiver criando uma integração personalizada ou procurando uma solução gerenciada, lidar com os limites de taxa adequadamente garante que seus fluxos de trabalho do Zendesk sejam executados sem problemas e sem interrupção.
Pronto para automatizar seus fluxos de trabalho do Zendesk sem se preocupar com os limites de taxa? Experimente o eesel AI e deixe-nos lidar com a complexidade da API enquanto você se concentra em oferecer ótimas experiências ao cliente.
Compartilhe esta postagem
Article by
