zendesk-api-rate-limit-requests-per-minute
eesel Team
Last edited 27 febrero 2026
{
"title": "Límites de velocidad de la API de Zendesk: Una guía completa para desarrolladores para 2026",
"slug": "zendesk-api-rate-limit-requests-per-minute",
"locale": "es",
"date": "2026-02-27",
"updated": "2026-02-27",
"template": "default",
"excerpt": "Domine los límites de velocidad de la API escalonada de Zendesk con esta guía para desarrolladores que cubre los límites específicos del plan, el manejo de errores, las estrategias de monitoreo y las técnicas de optimización.",
"categories": [
"Zendesk",
"Guides"
],
"tags": [
"Zendesk API",
"Rate Limits",
"API Development",
"429 Errors",
"Integration"
],
"readTime": 12,
"author": 16,
"reviewer": 14,
"seo": {
"title": "Límites de velocidad de la API de Zendesk: Una guía completa para desarrolladores para 2026",
"description": "Domine los límites de velocidad de la API escalonada de Zendesk con esta guía para desarrolladores que cubre los límites específicos del plan, el manejo de errores, las estrategias de monitoreo y las técnicas de optimización.",
"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": "Imagen de banner para los límites de velocidad de la API de Zendesk: Una guía completa para desarrolladores para 2026",
"coverImageWidth": 1920,
"coverImageHeight": 1080,
"faqs": {
"heading": "Preguntas frecuentes",
"type": "blog",
"answerType": "html",
"faqs": [
{
"question": "¿Qué sucede cuando excedo los límites de velocidad de la API de Zendesk (solicitudes por minuto)?",
"answer": "La API devuelve un código de estado 429 Too Many Requests (Demasiadas solicitudes) con un encabezado Retry-After que indica cuántos segundos esperar antes de volver a intentarlo. Su código debe manejar esto con elegancia y pausar las solicitudes hasta el tiempo de restablecimiento."
},
{
"question": "¿Los límites de velocidad de la API de Zendesk se restablecen al principio de cada minuto?",
"answer": "Los límites de velocidad se restablecen de forma continua, no a intervalos fijos. El encabezado ratelimit-reset proporciona la marca de tiempo Unix cuando se restablece su ventana de límite de velocidad actual."
},
{
"question": "¿Puedo aumentar mi límite de velocidad de la API de Zendesk sin actualizar mi plan?",
"answer": "El complemento High Volume API (API de alto volumen) aumenta los límites a 2500 solicitudes por minuto en los planes que califican. Alternativamente, optimizar su integración mediante la agrupación, el almacenamiento en caché y los webhooks puede reducir significativamente el uso de la API."
},
{
"question": "¿Los diferentes endpoints de la API de Zendesk tienen diferentes límites de velocidad?",
"answer": "Sí. Si bien la mayoría de los endpoints usan el límite de toda su cuenta, algunos tienen límites específicos. Las exportaciones incrementales están limitadas a 10 solicitudes por minuto, y el endpoint Update Ticket (Actualizar ticket) permite 30 actualizaciones por cada 10 minutos por usuario por ticket."
},
{
"question": "¿Cómo puedo monitorear mi uso de la API de Zendesk a lo largo del tiempo?",
"answer": "Use el panel de uso de la API en el Centro de administración (Cuenta > Uso > API) para ver resúmenes de 7 días, rastrear errores 429 y ver qué endpoints consumen la mayor cantidad de solicitudes."
}
],
"supportLink": null
}
}
---
Si está creando integraciones con Zendesk, recibir un error 429 Too Many Requests (Demasiadas solicitudes) a las 2 AM no es divertido. Comprender los límites de velocidad de la API de Zendesk antes de comenzar a codificar le evita sesiones de depuración frenéticas y partes interesadas enojadas que se preguntan por qué su sincronización de tickets dejó de funcionar.
Esta guía desglosa todo lo que necesita saber sobre los límites de velocidad de la API de Zendesk. Cubriremos los límites escalonados por plan, cómo monitorear su uso en tiempo real y estrategias prácticas para manejar los errores de límite de velocidad con elegancia. Ya sea que esté sincronizando datos de tickets, creando un panel personalizado o automatizando flujos de trabajo, aprenderá a crear integraciones que se mantengan dentro de los límites y, al mismo tiempo, ofrezcan un rendimiento confiable.
Para los equipos que prefieren no lidiar con los límites de velocidad, existe otro camino. [eesel AI](https://www.eesel.ai/) se conecta directamente a [Zendesk](https://www.eesel.ai/integration/zendesk-ai) y maneja la limitación de velocidad automáticamente. Exploraremos ambos enfoques para que pueda elegir el que mejor se adapte a su equipo.
## Comprender los límites de velocidad escalonados de Zendesk
Zendesk aplica diferentes límites de velocidad según su tipo de plan y los endpoints de API específicos que esté utilizando. Analicemos lo que necesita saber.
### Límites de velocidad por nivel de plan
Los límites de velocidad de la API de Support y Help Center varían significativamente según su plan de Zendesk:
| Plan | Solicitudes por minuto |
|------|---------------------|
| Team | 200 |
| Growth | 400 |
| Professional | 400 |
| Enterprise | 700 |
| Enterprise Plus | 2500 |
| Complemento High Volume API (API de alto volumen) | 2500 |
Fuente: [Documentación de límites de velocidad de Zendesk](https://developer.zendesk.com/api-reference/introduction/rate-limits/)
El complemento High Volume API (API de alto volumen) aumenta su límite a 2500 solicitudes por minuto. Está disponible en los planes Zendesk Suite Growth y superiores, y en los planes Zendesk Support Professional y superiores. Necesitará un mínimo de 10 puestos de agente para comprar este complemento. Los planes Enterprise Plus incluyen este complemento de forma predeterminada.
### Límites específicos del endpoint
Algunos endpoints tienen sus propios límites de velocidad que anulan los límites de toda la cuenta:
| Endpoint | Límite de velocidad |
|----------|------------|
| Exportaciones incrementales | 10 solicitudes por minuto |
| Listar tickets (páginas >500) | 50 solicitudes por minuto |
| Actualizar ticket | 30 actualizaciones por cada 10 minutos por usuario por ticket |
| API de chat | 200 solicitudes por minuto (todos los planes) |
Fuente: [Documentación de límites de velocidad de Zendesk](https://developer.zendesk.com/api-reference/introduction/rate-limits/)
El endpoint Incremental Export (Exportación incremental) es particularmente importante si está sincronizando grandes conjuntos de datos. Solo puede realizar 10 solicitudes por minuto a estos endpoints, aunque esto aumenta a 30 solicitudes por minuto si tiene el complemento High Volume API (API de alto volumen).
### Consideraciones sobre la API de Help Center
La API de Help Center utiliza los mismos límites de velocidad que la API de Support. Sin embargo, las solicitudes a la API de Help Center no cuentan para su límite de velocidad de la API de Support, y viceversa. Esto significa que puede realizar 700 solicitudes a la API de Support y otras 700 solicitudes a la API de Help Center simultáneamente en un plan Enterprise.
## Monitoreo de las solicitudes por minuto del límite de velocidad de la API de Zendesk en su código
Zendesk proporciona encabezados de respuesta que le permiten monitorear el estado de su límite de velocidad en tiempo real. Esto es esencial para crear integraciones que puedan adaptar su tasa de solicitudes de forma dinámica.
### Comprender los encabezados de respuesta
Cada respuesta de la API de Zendesk incluye encabezados que le indican el estado actual de su límite de velocidad:
- **X-Rate-Limit** o **ratelimit-limit**: El límite de velocidad actual de su cuenta (por ejemplo, 700)
- **X-Rate-Limit-Remaining** o **ratelimit-remaining**: Número de solicitudes restantes en el minuto actual
- **ratelimit-reset**: Marca de tiempo Unix cuando se restablece la ventana de límite de velocidad actual
- **zendesk-ratelimit-tickets-index**: Información de límite adicional para los endpoints de la lista de tickets
Para los endpoints de la lista de la API de Ticketing como List Tickets (Listar tickets) o Search Users (Buscar usuarios), obtiene encabezados adicionales:
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
Fuente: [Mejores prácticas de Zendesk para evitar la limitación de velocidad](https://developer.zendesk.com/documentation/api-basics/best-practices/best-practices-for-avoiding-rate-limiting/)
### Lectura de encabezados en Python
Aquí se explica cómo extraer y usar los encabezados de límite de velocidad en 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)
Fuente: Documentación de mejores prácticas de Zendesk
Lectura de encabezados en JavaScript
Aquí está la misma lógica en JavaScript con 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));
}
Fuente: Documentación de mejores prácticas de Zendesk
Manejo de errores 429 Too Many Requests (Demasiadas solicitudes)
Cuando excede las solicitudes por minuto del límite de velocidad de la API de Zendesk, la API devuelve un código de estado 429. La forma en que maneje esta respuesta determina si su integración falla con elegancia o se interrumpe por completo. Para obtener más contexto sobre la creación de integraciones sólidas, consulte nuestra guía sobre los mejores chatbots de IA para Zendesk.
Qué significan los errores 429
Una respuesta 429 Too Many Requests (Demasiadas solicitudes) indica que ha alcanzado el límite de velocidad. La respuesta incluye un encabezado Retry-After que le indica cuántos segundos esperar antes de volver a intentarlo:
HTTP/1.1 429
Status: 429
Retry-After: 93
En este ejemplo, querrá esperar 93 segundos antes de realizar otra solicitud. Ignorar este encabezado y continuar realizando solicitudes puede provocar errores nulos que dificultarán la depuración.
Fuente: Documentación de mejores prácticas de Zendesk
Implementación de retroceso exponencial
Para las integraciones de producción, implemente el retroceso exponencial para manejar los límites de velocidad con elegancia:
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")
El enfoque de retroceso exponencial aumenta el tiempo de espera entre reintentos, lo que reduce la posibilidad de sobrecargar el servidor al tiempo que mejora la probabilidad de solicitudes exitosas.
Mejores prácticas para el manejo de errores
Aquí hay prácticas clave para manejar los límites de velocidad en la producción:
- Nunca ignore los errores 429. Continuar realizando solicitudes después de alcanzar el límite puede hacer que su integración falle con errores nulos inútiles.
- Siempre analice el encabezado Retry-After. Esto le indica exactamente cuánto tiempo esperar.
- Implemente patrones de interruptor de circuito para aplicaciones de alto volumen. Si alcanza constantemente los límites de velocidad, pause temporalmente las solicitudes en lugar de volver a intentarlo de inmediato.
- Registre los eventos de límite de velocidad. Realice un seguimiento de cuándo y por qué alcanza los límites para identificar oportunidades de optimización.
- Diseñe para una degradación elegante. Su aplicación debe seguir funcionando incluso cuando las solicitudes de la API se retrasen.
Monitoreo del uso de la API en Zendesk
Más allá de monitorear los encabezados en su código, Zendesk proporciona herramientas para rastrear su uso de la API a lo largo del tiempo.
Uso del panel del Centro de administración
Puede ver el uso de su API en el Centro de administración de Zendesk:
- Vaya a Centro de administración > Cuenta > Uso > API
- Vea el resumen de 7 días que muestra su uso en comparación con su límite de velocidad
- Verifique el porcentaje de errores 429 durante los últimos siete días
- Vea cuántas veces se acercó a su límite (90-99% de la capacidad)
El panel muestra las solicitudes de la API a lo largo del tiempo con tablas que desglosan las solicitudes totales por llamantes y endpoints. El contenido se actualiza diariamente, aunque pueden pasar hasta 72 horas para que aparezca el uso actual.
Fuente: Administración del uso de la API en su cuenta de Zendesk
Nota: El panel de uso de la API no está disponible para las cuentas que utilizan más de 2500 solicitudes por minuto o las cuentas independientes que no incluyen Support.
Notificaciones de uso de la API
Zendesk proporciona notificaciones cuando se acerca a su límite de velocidad:
- Advertencias de casi incumplimiento: Alertas cuando las llamadas a la API miden entre el 90 y el 99% del límite de su plan
- Seguimiento de errores 429: Supervise el porcentaje de solicitudes que devuelven errores de límite de velocidad
- Resúmenes diarios: Realice un seguimiento de las tendencias durante los últimos 7 días
El monitoreo regular le ayuda a identificar patrones y planificar aumentos de capacidad antes de que alcanzar los límites afecte sus operaciones.
Optimización de su integración de API
El diseño de integración inteligente reduce el uso de su API sin sacrificar la funcionalidad. Aquí hay estrategias comprobadas para mantenerse dentro de las solicitudes por minuto del límite de velocidad de la API de Zendesk. Si está buscando una comprensión más profunda de las herramientas de soporte impulsadas por IA, consulte nuestra revisión de Zendesk AI.
Solicitudes por lotes
En lugar de realizar llamadas API individuales para cada ticket, use endpoints por lotes:
- endpoints show_many: Obtenga varios tickets, usuarios u organizaciones en una sola solicitud
- Carga lateral: Use el parámetro
includepara obtener datos relacionados (como comentarios de tickets) en una sola llamada - Actualizaciones masivas: Actualice varios tickets con una sola solicitud cuando sea posible
El procesamiento por lotes puede reducir el volumen de llamadas a la API en un 50-90% según su caso de uso.
Implementación de almacenamiento en caché
Almacene en caché los datos que no cambian con frecuencia:
- Datos de usuario y organización: Almacene en caché durante horas o días, ya que esto cambia con poca frecuencia
- Metadatos de tickets: Almacene en caché los campos de tickets, las etiquetas y las definiciones de campos personalizados
- Artículos del Centro de ayuda: Almacene en caché el contenido del artículo con los encabezados de caché apropiados
Implemente la invalidación de caché utilizando webhooks de Zendesk para borrar los datos almacenados en caché cuando se produzcan cambios, asegurando que su integración se mantenga actualizada sin un sondeo excesivo.
Uso de webhooks en lugar de sondeo
Sondear la API en busca de cambios es ineficiente y consume rápidamente su límite de velocidad. Los webhooks de Zendesk notifican a su sistema cuando ocurren eventos:
- Eventos de tickets: Reciba notificaciones cuando se creen, actualicen o resuelvan tickets
- Cambios de usuario: Reciba actualizaciones cuando cambien los perfiles de usuario
- Actualizaciones de la organización: Realice un seguimiento de los cambios en la membresía de la organización
Los webhooks eliminan la necesidad de un sondeo constante, lo que reduce drásticamente el uso de la API al tiempo que proporciona actualizaciones en tiempo real.
Exportaciones incrementales para grandes conjuntos de datos
Cuando sincronice grandes volúmenes de datos, use la API de exportación incremental:
- Solicite solo los elementos que hayan cambiado desde su última sincronización
- Use la paginación basada en cursor para un manejo eficiente de grandes conjuntos de datos
- Manténgase dentro del límite de 10 solicitudes por minuto (30 con el complemento High Volume)
Este enfoque es mucho más eficiente que obtener repetidamente todos los tickets, especialmente para las cuentas con altos volúmenes de tickets.
Fuente: Documentación de exportaciones incrementales de Zendesk
Cuándo actualizar a High Volume API (API de alto volumen)
A veces, la optimización no es suficiente. Aquí se explica cómo saber cuándo necesita el complemento High Volume API (API de alto volumen). Para obtener una descripción completa de las capacidades de Zendesk, lea nuestra revisión de Zendesk.
Señales de que necesita el complemento
Considere la posibilidad de actualizar si experimenta:
- Alcanzar constantemente 700 solicitudes por minuto en los planes Enterprise
- Retrasos en la integración que afectan las operaciones comerciales
- Volumen de tickets creciente que supera su límite actual
- Múltiples integraciones que compiten por el mismo grupo de límite de velocidad
- Errores 429 frecuentes a pesar de los esfuerzos de optimización
Precios y requisitos
El complemento High Volume API (API de alto volumen):
- Aumenta su límite a 2500 solicitudes por minuto
- Disponible en los planes Zendesk Suite Growth+ y Support Professional+
- Requiere un mínimo de 10 puestos de agente
- Incluido sin costo adicional con los planes Enterprise Plus
Fuente: Acerca de los complementos de Zendesk
Antes de actualizar, audite su uso actual de la API. Muchos equipos descubren que pueden optimizar para salir de los problemas de límite de velocidad sin costos adicionales.
Alternativa: Deje que eesel AI maneje los límites de velocidad por usted
Crear y mantener una integración que cumpla con los límites de velocidad requiere un esfuerzo de ingeniería significativo. Si prefiere concentrarse en su producto principal en lugar de administrar las cuotas de la API, le ofrecemos una alternativa.
eesel AI se conecta directamente a Zendesk y maneja la limitación de velocidad automáticamente. Nuestro sistema:
- Monitorea los encabezados de límite de velocidad en tiempo real
- Implementa colas de solicitudes y retroceso inteligentes
- Utiliza el procesamiento por lotes optimizado para minimizar las llamadas a la API
- Proporciona actualizaciones basadas en webhook en lugar de sondeo
- Se escala sin problemas a medida que crece el volumen de sus tickets
En lugar de escribir código personalizado para manejar los errores 429 y el retroceso exponencial, configura las automatizaciones en un lenguaje sencillo. Manejamos la complejidad técnica de mantenerse dentro de los límites de velocidad de Zendesk mientras sus integraciones se ejecutan de manera confiable. Obtenga más información sobre nuestras capacidades de Agente de IA de Zendesk.
Para los equipos que crean integraciones personalizadas, nuestra referencia de la API de automatización de Zendesk proporciona orientación técnica adicional.
Comience a crear integraciones de Zendesk confiables hoy mismo
Comprender los límites de velocidad de la API de Zendesk es esencial para cualquier proyecto de integración. Las conclusiones clave:
- Conozca los límites de su plan: 200-2500 solicitudes por minuto según su nivel
- Supervise los encabezados de límite de velocidad para rastrear el uso en tiempo real
- Implemente el retroceso exponencial para los errores 429
- Use el panel del Centro de administración para rastrear los patrones de uso
- Optimice con procesamiento por lotes, almacenamiento en caché y webhooks
- Considere el complemento High Volume API (API de alto volumen) cuando la optimización no sea suficiente
Ya sea que esté creando una integración personalizada o buscando una solución administrada, manejar los límites de velocidad correctamente garantiza que sus flujos de trabajo de Zendesk se ejecuten sin problemas y sin interrupciones.
¿Listo para automatizar sus flujos de trabajo de Zendesk sin preocuparse por los límites de velocidad? Pruebe eesel AI y permítanos manejar la complejidad de la API mientras usted se concentra en brindar excelentes experiencias al cliente.
Compartir esta entrada
Article by
