{
"title": "Cómo crear un token de la API de Zendesk: Guía paso a paso para 2026",
"slug": "zendesk-api-token-create",
"locale": "es",
"date": "2026-02-27",
"updated": "2026-02-27",
"template": "default",
"excerpt": "Una guía completa para generar tokens de la API de Zendesk, desde habilitar el acceso mediante tokens hasta realizar tu primera solicitud de API autenticada.",
"categories": [
"Zendesk",
"Guides"
],
"tags": [
"Zendesk",
"API",
"Authentication",
"Customer Support",
"Integration"
],
"readTime": 9,
"author": 16,
"reviewer": 14,
"seo": {
"title": "Cómo crear un token de la API de Zendesk: Guía paso a paso para 2026",
"description": "Una guía completa para generar tokens de la API de Zendesk, desde habilitar el acceso mediante tokens hasta realizar tu primera solicitud de API autenticada.",
"image": "https://wmeojibgfvjvinftolho.supabase.co/storage/v1/object/public/public_assets/blog-gen/banner-ed185a04-7e1e-4379-a2e5-59950289bca3"
},
"coverImage": "https://wmeojibgfvjvinftolho.supabase.co/storage/v1/object/public/public_assets/blog-gen/banner-ed185a04-7e1e-4379-a2e5-59950289bca3",
"coverImageAlt": "Imagen de banner para Cómo crear un token de la API de Zendesk: Guía paso a paso para 2026",
"coverImageWidth": 1920,
"coverImageHeight": 1080,
"faqs": {
"heading": "Preguntas Frecuentes",
"type": "blog",
"answerType": "html",
"faqs": [
{
"question": "¿Quién puede crear un token de la API de Zendesk?",
"answer": "Solo los administradores pueden generar tokens de la API. Si necesita un token pero no es administrador, pídale a su administrador de Zendesk que cree uno para usted o que le otorgue privilegios de administrador."
},
{
"question": "¿Cómo creo un token de la API de Zendesk si el acceso mediante tokens está desactivado?",
"answer": "Primero, habilite el acceso mediante tokens en el Centro de administración en Aplicaciones e integraciones > API > API de Zendesk > Configuración. Active el acceso mediante tokens y luego siga los pasos para generar su token."
},
{
"question": "¿Existe alguna forma de crear un token de la API de Zendesk sin ser administrador?",
"answer": "No, se requieren privilegios de administrador para generar tokens de la API. Esta es una medida de seguridad para evitar el acceso no autorizado a la API."
},
{
"question": "¿Cuál es la diferencia entre un token de la API de Zendesk y un token de OAuth?",
"answer": "Los tokens de la API son contraseñas generadas automáticamente que pueden suplantar a cualquier usuario. Los tokens de OAuth son específicos del usuario, utilizan permisos con ámbito y son más seguros para aplicaciones de terceros."
},
{
"question": "¿Puedo usar un token de la API de Zendesk con la autenticación de dos factores habilitada?",
"answer": "Sí, los tokens de la API funcionan independientemente de la autenticación de dos factores. Están diseñados específicamente para el acceso a la API cuando la 2FA bloquearía las solicitudes automatizadas."
},
{
"question": "¿Cuántos tokens de la API puedo tener en Zendesk?",
"answer": "Puede tener hasta 256 tokens activos por cuenta. Las cuentas que ya exceden este límite pueden tener hasta 2048 tokens."
},
{
"question": "¿Qué debo hacer si mi token de la API de Zendesk está comprometido?",
"answer": "Elimine el token comprometido inmediatamente en el Centro de administración > Aplicaciones e integraciones > API > Tokens de API. Luego, genere un nuevo token y actualice cualquier aplicación que use el anterior."
}
],
"supportLink": null
}
}
---
Los tokens de la API son las claves que desbloquean todo el potencial de Zendesk. Ya sea que esté creando integraciones personalizadas, automatizando flujos de trabajo o conectando herramientas de terceros, necesitará un token de la API para autenticar sus solicitudes. Piense en ello como una contraseña que permite que las aplicaciones se comuniquen de forma segura con su cuenta de Zendesk.
¿Las buenas noticias? Crear un token de la API de Zendesk solo lleva unos minutos. ¿Las malas noticias? Si no sigue las mejores prácticas de seguridad, podría exponer datos confidenciales de los clientes o comprometer todo su sistema de soporte.
En esta guía, lo guiaré a través de todo el proceso: desde habilitar el acceso mediante tokens hasta generar su primer token, probarlo e implementar medidas de seguridad que mantengan sus datos seguros. También le mostraré cómo herramientas como [eesel AI](https://www.eesel.ai) utilizan estos tokens para crear potentes agentes de IA que gestionan los tickets de soporte de forma autónoma.
## Lo que necesitará
Antes de comenzar, asegúrese de tener:
- **Acceso de administrador** a su cuenta de Zendesk (solo los administradores pueden generar tokens de la API)
- **Acceso mediante tokens habilitado** en la configuración de su cuenta (le mostraré cómo verificar esto)
- **Un lugar seguro para almacenar el token** (administrador de contraseñas, variables de entorno o bóveda segura)
Si no es administrador, deberá pedirle a su administrador de Zendesk que genere un token para usted o que le otorgue privilegios de administrador.
## Paso 1: Habilite el acceso mediante tokens en el Centro de administración
Antes de que pueda generar cualquier token, debe asegurarse de que el acceso mediante tokens esté activado a nivel de cuenta. Esta es una función de seguridad que evita el acceso no autorizado a la API.
Aquí le mostramos cómo verificarlo y habilitarlo:
1. Inicie sesión en su cuenta de Zendesk
2. Haga clic en el **icono de engranaje** en la barra lateral izquierda, luego seleccione **Ir al Centro de administración**
3. En la barra lateral izquierda, haga clic en **Aplicaciones e integraciones**, luego seleccione **API** > **API de Zendesk**
4. Haga clic en la pestaña **Configuración**
5. Active **Acceso mediante tokens** a **ACTIVADO**
Si el acceso mediante tokens ya está habilitado, verá el interruptor configurado en ACTIVADO y una lista de los tokens existentes a continuación. Si no ve esta opción, es posible que su cuenta no tenga [acceso a la API incluido en su plan](https://support.zendesk.com/hc/en-us/articles/4408835338138-Zendesk-Suite-plans-and-features).
**Importante:** Solo los usuarios verificados pueden usar tokens de la API. Si alguien deja su organización, sus tokens permanecen activos hasta que los desactive manualmente. Esta es la razón por la que las auditorías periódicas de tokens son importantes.
## Paso 2: Genere un nuevo token de la API
Ahora que el acceso mediante tokens está habilitado, puede crear su primer token de la API. Cada token debe tener un nombre descriptivo para que sepa para qué sirve más adelante.
1. En el **Centro de administración**, vaya a **Aplicaciones e integraciones** > **API** > **Tokens de API**
2. Haga clic en el botón **Agregar token de API** (o el icono más junto a "Tokens de API activos")
3. Ingrese una **Descripción** para el token (por ejemplo: "Integración de eesel AI" o "Script de informes internos")
4. Haga clic en **Guardar** para generar el token
La descripción es opcional pero muy recomendable. Dentro de seis meses, no recordará para qué era el "Token #7". Las buenas descripciones incluyen el nombre de la herramienta, el propósito y la fecha de creación.
Puede tener hasta 256 tokens activos por cuenta (o 2048 si su cuenta ya excede los 256). Si alcanza el límite, deberá [eliminar un token existente](https://support.zendesk.com/hc/en-us/articles/4408889192858-Managing-API-token-access-to-the-Zendesk-API) antes de crear uno nuevo.
## Paso 3: Copie y almacene su token de forma segura
Aquí está la parte crítica: **el token completo solo se muestra una vez**. Después de cerrar esta ventana, nunca más volverá a ver el token completo. Si lo pierde, deberá generar uno nuevo.
1. Haga clic en el botón **Copiar** para copiar el token al portapapeles
2. Péguelo en un lugar seguro inmediatamente (su administrador de contraseñas, una variable de entorno segura o una bóveda encriptada)
3. Haga clic en **Guardar** nuevamente para volver a la lista de tokens
**Nunca almacene tokens de la API en:**
- Repositorios de código (GitHub, GitLab, etc.)
- Documentos u hojas de cálculo compartidos
- Mensajes de correo electrónico o chat
- Archivos de texto sin formato en su computadora
Si expone accidentalmente un token, [elimínelo inmediatamente](https://support.zendesk.com/hc/en-us/articles/4408889192858-Managing-API-token-access-to-the-Zendesk-API) y cree uno nuevo. Los tokens de la API pueden suplantar a cualquier usuario en su cuenta, incluidos los administradores, así que trátelos como contraseñas.
## Paso 4: Pruebe su token de la API
Antes de usar su token en producción, verifique que funcione con una solicitud de API simple. La forma más fácil es usar curl desde su línea de comandos:
```bash
curl https://your-subdomain.zendesk.com/api/v2/users.json \
-u your-email@example.com/token:your-api-token
Reemplace:
your-subdomaincon su subdominio de Zendesk (la parte anterior a.zendesk.com)your-email@example.comcon su correo electrónico de administrador de Zendeskyour-api-tokencon el token que acaba de copiar
Si todo funciona, verá una respuesta JSON con datos del usuario. Si recibe un error de autenticación, verifique lo siguiente:
- Su dirección de correo electrónico es correcta
- Incluyó
/token:entre su correo electrónico y el token de la API - El token no ha sido eliminado o desactivado
- El acceso mediante tokens todavía está habilitado en el Centro de administración
También puede probar su token usando Postman o cualquier cliente HTTP. Establezca el tipo de autenticación en "Basic Auth" y use su dirección de correo electrónico con /token anexado como nombre de usuario, y su token de la API como contraseña.
Token de la API vs token de acceso de OAuth
Zendesk ofrece dos métodos de autenticación, y elegir el correcto es importante para la seguridad.
Los tokens de la API son mejores para:
- Scripts internos y automatización
- Integraciones de una sola cuenta
- Pruebas y desarrollo rápidos
- Herramientas que necesitan acceso amplio
Los tokens de acceso de OAuth son mejores para:
- Aplicaciones de terceros
- Acceso específico del usuario
- Permisos con ámbito (que limitan lo que el token puede hacer)
- Aplicaciones distribuidas a múltiples clientes
¿La diferencia clave? Los tokens de la API actúan como contraseñas maestras. Pueden suplantar a cualquier usuario y acceder a todo lo que ese usuario puede acceder. Los tokens de OAuth están vinculados a usuarios específicos y pueden limitarse a permisos específicos (ámbitos).
Si está creando algo solo para uso interno, los tokens de la API son más simples. Si está creando un producto que otras empresas usarán, OAuth es la opción segura.
Mejores prácticas de seguridad
Los tokens de la API son poderosos. Siga estas prácticas para mantener seguros sus datos de Zendesk:
Almacene los tokens en variables de entorno, no en el código
export ZENDESK_API_TOKEN="your-token-here"
import os
token = os.environ.get('ZENDESK_API_TOKEN')
Rote los tokens regularmente Establezca un recordatorio en el calendario para rotar los tokens cada 90 días. Genere un nuevo token, actualice sus aplicaciones y luego elimine el token anterior.
Desactive los tokens no utilizados Si deja de usar una integración, desactive su token inmediatamente. No espere hasta que "pueda necesitarlo de nuevo".
Use los permisos mínimos necesarios A diferencia de los tokens de OAuth, los tokens de la API no admiten permisos con ámbito. Esto significa que cualquier token de la API puede hacer cualquier cosa que pueda hacer un administrador. Considere crear una cuenta de administrador dedicada con permisos limitados para el acceso a la API.
Supervise el uso de tokens con registros de auditoría En los planes Enterprise, Zendesk registra la actividad del token de la API en el registro de auditoría. Puede ver cuándo se crearon, desactivaron o usaron los tokens. Revise estos registros mensualmente para detectar actividades sospechosas.
Elimine los tokens comprometidos inmediatamente Si sospecha que un token ha sido expuesto, elimínelo inmediatamente. No hay "deshacer" para la eliminación de tokens, así que asegúrese de que sus aplicaciones estén listas para usar un nuevo token.
Solución de problemas comunes
Error "El acceso mediante tokens está desactivado" Esto significa que el acceso mediante tokens no se ha habilitado en el Centro de administración. Siga el Paso 1 anterior para activarlo.
Fallos de autenticación
Verifique el formato de su autenticación. Debe ser email@example.com/token:api_token (con el separador /token:). Los errores comunes incluyen usar dos puntos en lugar de una barra o olvidar la parte /token por completo.
Limitación de velocidad Zendesk limita las solicitudes de API según su plan. Si alcanza los límites de velocidad, obtendrá una respuesta 429. El complemento de API de alto volumen puede aumentar sus límites si es necesario.
Caducidad del token Los tokens de la API no caducan automáticamente, pero pueden volverse inválidos si:
- El administrador que los creó pierde los privilegios de administrador
- El acceso mediante tokens está desactivado a nivel de cuenta
- El token se elimina o desactiva manualmente
Uso de su token con eesel AI
Una vez que tenga su token de la API, puede conectar Zendesk a potentes herramientas de automatización. En eesel AI, utilizamos tokens de la API de Zendesk para crear agentes de IA que gestionan los tickets de soporte de forma autónoma.
Así es como funciona: usted proporciona su token de la API y nuestra IA aprende de sus tickets anteriores, artículos del centro de ayuda y macros. En cuestión de minutos, comprende el contexto de su negocio y puede comenzar a gestionar el soporte de primera línea. La IA redacta respuestas, busca información de pedidos en Shopify, procesa reembolsos y escala los problemas complejos a su equipo humano.
A diferencia de los chatbots básicos, eesel AI opera como un verdadero compañero de equipo. Comienza con la supervisión (la IA redacta respuestas para su revisión), luego amplía gradualmente su alcance a medida que se demuestra. Las implementaciones maduras alcanzan hasta un 81% de resolución autónoma.
El token de la API de Zendesk es lo que permite a nuestra IA leer tickets, actualizar campos y enviar respuestas directamente en su help desk. Es seguro, está limitado solo a su cuenta y usted mantiene el control total sobre a lo que puede acceder la IA.
Comience a automatizar su soporte de Zendesk hoy mismo
Crear un token de la API de Zendesk es sencillo, pero usarlo de manera efectiva es donde reside el verdadero valor. Ya sea que esté creando integraciones personalizadas o conectando herramientas impulsadas por IA como eesel AI, su token de la API es el puente entre sus datos de soporte y la automatización que puede transformar su flujo de trabajo.
Recuerde: la seguridad es lo primero. Almacene los tokens de forma segura, rótelos regularmente y supervise su uso. Con estas prácticas implementadas, desbloqueará todo el poder de la API de Zendesk mientras mantiene protegidos los datos de sus clientes.
¿Listo para ver lo que la IA puede hacer por su equipo de soporte? Pruebe eesel AI gratis y conéctelo a su cuenta de Zendesk en minutos. Nuestra IA aprende su negocio al instante y comienza a ayudar con los tickets desde el primer día.
Compartir esta entrada
Article by
