Saltar al contenido principal

Zendesk

¿Prefieres configuracion guiada con IA?

En lugar de seguir estos pasos manualmente, puedes usar el Asistente de Credenciales con IA — describe lo que quieres conectar y la IA te guiara paso a paso, adaptado a tu cuenta.

Descripción General​

Conecta tu cuenta de Zendesk a Nirvai para gestionar tickets, usuarios y flujos de trabajo de soporte al cliente programáticamente.

Métodos de Autenticación Soportados​

  • API Token - Recomendado para integraciones del lado del servidor (requiere subdominio y email)

Requisitos Previos​

  • Una cuenta de Zendesk con acceso de admin
  • Tu subdominio de Zendesk (de tu-empresa.zendesk.com)

Instrucciones de Configuración​

Autenticación con API Token​

  1. Inicia sesión en tu cuenta de Zendesk
  2. Ve a Admin Center (icono de engranaje) > Apps and integrations > APIs > Zendesk API
  3. Habilita Token Access si no está habilitado
  4. Haz clic en Add API token
  5. Ingresa una descripción (ej., "Integración Nirvai")
  6. Haz clic en Save
  7. Importante: Copia el token inmediatamente - no se mostrará de nuevo

En Nirvai​

Al crear la credencial, necesitarás proporcionar:

  • Subdomain: Tu subdominio de Zendesk (ej., miempresa)
  • Email: El email de tu cuenta de Zendesk
  • API Token: El token que generaste

Cómo Funciona la Autenticación​

La autenticación de API token de Zendesk usa Basic Auth con un formato especial:

{email}/token:{api_token}

Esto es manejado automáticamente por Nirvai cuando proporcionas el subdominio, email y token.

Encontrar tu Subdominio​

Tu subdominio es la primera parte de tu URL de Zendesk:

https://miempresa.zendesk.com
        ^^^^^^^^^
        Este es tu subdominio

Solución de Problemas​

Problemas Comunes​

  • 401 Unauthorized: Verifica que:
    • El acceso por token esté habilitado en Zendesk
    • La combinación de email y token sea correcta
    • El token no haya sido revocado
  • 403 Forbidden: Tu rol de cuenta puede no tener permiso para la acción solicitada
  • Subdominio incorrecto: Verifica tu URL de Zendesk e ingresa solo la parte del subdominio
  • 404 Not Found: El recurso no existe o no tienes acceso

Token vs Autenticación por Contraseña​

Zendesk soporta dos métodos de auth:

  • API Token (recomendado): {email}/token:{api_token}
  • Password (no recomendado): {email}:{password}

Siempre usa API tokens para integraciones - pueden ser revocados sin cambiar tu contraseña.

Límites de Tasa de API​

  • Los límites de tasa varían según el plan de Zendesk
  • Las respuestas incluyen headers X-Rate-Limit
  • Implementa lógica de reintento con backoff

Mejores Prácticas de Seguridad​

  • Usa tokens de API dedicados para cada integración
  • Revoca tokens que ya no necesites
  • No compartas tokens ni los commits a control de versiones
  • Considera crear un agente dedicado para acceso a la API

Recursos Relacionados​

Adaptado para la plataforma Nirvai

Siguientes Pasos​

¿Ya tienes tu credencial? Conectala a un agente

Usa el Creador de Herramientas con IA para convertir esta credencial en herramientas usables por el agente. Describe lo que tu agente deberia poder hacer y la IA investiga la API, configura los endpoints y te entrega un toolkit revisable antes de guardar nada.