> This is a page from the ElevenLabs documentation. For a complete page index, fetch https://elevenlabs.io/docs/llms.txt. For the full documentation in a single file, fetch https://elevenlabs.io/docs/llms-full.txt. # Freshdesk Con una [herramienta de webhook](/docs/es/reception-ai/integrations/webhooks), 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](#look-up-tickets-with-the-mcp-server) 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: ```bash printf 'YOUR_API_KEY:X' | base64 ``` El valor de la cabecera es `Basic ` seguido del resultado. > **Warning** > > 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](/docs/es/reception-ai/receptionist/testing) 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](/docs/es/reception-ai/integrations/mcp-server) 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`. |