Freshdesk
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 Freshdesk a Nirvai para gestionar tickets, contactos y flujos de trabajo de soporte al cliente programáticamente.
Métodos de Autenticación Soportados
- API Key - Recomendado (requiere subdominio)
Requisitos Previos
- Una cuenta de Freshdesk con acceso de admin
- Tu subdominio de Freshdesk (de
tu-empresa.freshdesk.com)
Instrucciones de Configuración
Obtener tu API Key
- Inicia sesión en tu cuenta de Freshdesk
- Haz clic en tu foto de perfil (arriba a la derecha)
- Ve a Profile Settings
- En el lado derecho, encuentra tu API Key
- Copia la API key
- En Nirvai, crea una nueva credencial de Freshdesk:
- Subdomain: Tu subdominio de Freshdesk (ej.,
miempresa) - API Key: La clave que copiaste
- Subdomain: Tu subdominio de Freshdesk (ej.,
Encontrar tu Subdominio
Tu subdominio es la primera parte de tu URL de Freshdesk:
https://miempresa.freshdesk.com
^^^^^^^^^
Este es tu subdominio
Cómo Funciona la Autenticación
La API de Freshdesk usa Basic Auth con tu API key como nombre de usuario y X como contraseña:
Username: tu_api_key
Password: X
Esto es manejado automáticamente por Nirvai cuando proporcionas el subdominio y la API key.
Solución de Problemas
Problemas Comunes
- 401 Unauthorized: Verifica que tu API key sea correcta y no haya sido regenerada.
- 403 Forbidden: Tu rol de cuenta puede no tener permiso para la acción solicitada.
- Subdominio incorrecto: Verifica tu URL de Freshdesk e ingresa solo la parte del subdominio.
- 404 Not Found: El recurso no existe o no tienes acceso.
Regenerar tu API Key
Si tu API key está comprometida:
- Ve a Profile Settings
- Haz clic en Regenerate API Key
- Actualiza tus integraciones con la nueva clave
- La clave anterior se invalida inmediatamente
Permisos Basados en Roles
El acceso a la API está limitado por tu rol de Freshdesk:
| Rol | Nivel de Acceso |
|---|---|
| Admin | Acceso completo a la API |
| Agent | Limitado a tickets asignados |
| Supervisor | Acceso a nivel de equipo |
Límites de Tasa de API
Freshdesk aplica límites de tasa según tu plan:
| Plan | Límite de Tasa |
|---|---|
| Sprout/Blossom | 50 solicitudes/minuto |
| Garden | 200 solicitudes/minuto |
| Estate | 400 solicitudes/minuto |
| Forest | 700 solicitudes/minuto |
Las respuestas incluyen headers X-RateLimit-*.
Mejores Prácticas de Seguridad
- Mantén tu API key confidencial
- No commits claves a control de versiones
- Regenera claves si sospechas compromiso
- Considera crear una cuenta de agente dedicada para acceso a la API
Recursos Relacionados
Adaptado para la plataforma Nirvai
Siguientes Pasos
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.