Freshdesk | ElevenLabs Documentation

Con una herramienta de webhook, tu recepcionista puede abrir un ticket de Freshdesk cada vez que una persona que llama informa de un problema o pide ayuda, para que tu equipo pueda atenderlo. En los planes Growth, Pro y Enterprise, también puedes conectar el servidor MCP de Freshdesk para consultar tickets existentes.

Crear tickets

Obtén tu clave de API

En Freshdesk, selecciona tu foto de perfil, abre Profile settings y selecciona View API key. Copia la clave. Actúa como tu cuenta de agente, por lo que los tickets se crean con tus permisos.

Crea la cabecera de autorización

Freshdesk usa la clave de API como nombre de usuario y X como contraseña. Codifícala en una terminal y sustituye YOUR_API_KEY por tu clave:

printf 'YOUR_API_KEY:X' | base64

El valor de la cabecera es Basic seguido del resultado.

No pegues tu clave de API en un codificador online. Cualquiera que tenga la clave o la cabecera codificada puede leer y modificar tus tickets.

Crea la herramienta de webhook

Ve a Integrations, selecciona Add integration y elige Webhook Tool.

Campo	Valor
Nombre	`create_freshdesk_ticket`
Descripción	”Abre un ticket de asistencia cuando una persona que llama informa de un problema o necesita ayuda del equipo.”
Método	POST
URL	`https://YOURDOMAIN.freshdesk.com/api/v2/tickets`
Cabeceras de solicitud	`Authorization`: `Basic` seguido de la clave codificada
Parámetros del cuerpo	`name` (string, obligatorio): “El nombre completo de la persona que llama.” `phone` (string): “El número de teléfono de la persona que llama.” `email` (string): “La dirección de correo electrónico de la persona que llama, si la facilitó.” `subject` (string, obligatorio): “Un breve resumen del problema.” `description` (string, obligatorio): “Lo que informó la persona que llama, con sus propias palabras y con los detalles que facilitó.” `status` (number, obligatorio): “Siempre el valor exacto `2`.” `priority` (number, obligatorio): “Siempre el valor exacto `1`.” `source` (number, obligatorio): “Siempre el valor exacto `3`.”
Asignar a agentes	Recepcionista

Sustituye YOURDOMAIN por tu subdominio de Freshdesk. Selecciona Enable.

Pruébala

Prueba tu recepcionista informando de un problema. El ticket aparecerá en Freshdesk.

Los valores fijos crean el ticket como Open (estado 2) con prioridad Low (prioridad 1) y lo marcan como procedente de Phone (origen 3). Para que la recepcionista establezca la prioridad, describe los valores en su lugar, por ejemplo: “1 para baja, 2 para media, 3 para alta, 4 para urgente”.

Freshdesk necesita un número de teléfono o un correo electrónico para encontrar o crear la persona solicitante. Indica a tu recepcionista que recopile siempre el número de teléfono de quien llama.

Consultar tickets con el servidor MCP

El servidor MCP de Freshdesk está disponible en los planes Growth, Pro y Enterprise. Úsalo para que tu recepcionista consulte los tickets existentes de quien llama. Las acciones MCP consumen una asignación anual que depende de tu plan.

En Reception.ai, ve a Integrations, selecciona Add integration y elige MCP Server.

Campo	Valor
Nombre	Freshdesk
Tipo de servidor	HTTP transmisible
URL del servidor	`https://YOURDOMAIN.freshdesk.com/mcp`
Cabeceras HTTP	`Authorization`: tu clave de API, sin prefijo

Deja Secret Token vacío para que Reception.ai envíe la cabecera Authorization exactamente como la has introducido. Usa tu subdominio freshdesk.com incluso si tienes un dominio personalizado. Selecciona Enable.

Abre la pestaña Tools y asigna las herramientas de consulta de tickets, como fetchSearchTickets y fetchTicket, al Client (recepcionista). Deja sin asignar las herramientas que actualizan tickets, agentes, grupos o artículos.

Solución de problemas

Problema	Qué comprobar
401 de Freshdesk	Codifica la clave con `:X` después y comienza el valor de la cabecera con `Basic` y un espacio.
400 sobre la persona solicitante	El ticket necesita un número de teléfono o correo electrónico, además del nombre. Asegúrate de que la recepcionista los recopila.
400 sobre el estado o la prioridad	`status`, `priority` y `source` deben ser parámetros de tipo number, no strings.
El servidor MCP no muestra herramientas	Usa tu subdominio `freshdesk.com` e introduce la clave de API sin procesar en la cabecera `Authorization`, sin `Basic` ni `Bearer`.