Recursos · Integración n8n

Integración Freshdesk n8nAutomatiza Freshdesk con n8n.

El historial de soporte vale más cuando sale del helpdesk. La integración Freshdesk n8n lo mueve: 10 operaciones repartidas en 2 recursos, tickets y contactos, detrás de una sola clave API. Freshdesk no tiene nodo trigger en n8n, así que el flujo arranca desde otro sitio.

Reseñas verificadas en Trustpilot · Agencia de IA, automatización y growth

Por qué automatizar

¿Qué aporta la integración Freshdesk n8n?

El nodo Freshdesk viene incluido en n8n y habla con la API de Freshdesk mediante una clave API y el subdominio de tu cuenta. Cubre 2 recursos, Ticket y Contact, con las mismas acciones en cada uno: crear, leer una ficha, listar varias, actualizar y borrar. Son 10 operaciones en total, suficientes para abrir un ticket desde cualquier canal, recuperar a la persona que hay detrás y dejar el resultado donde tu equipo sí mira cada día.

El primer patrón resuelve la entrada de tickets. Cuando el mensaje llega por un canal que tus clientes ya usan a diario, ticket.create lo convierte en ticket sin que nadie lo transcriba. Es justo lo que hace la plantilla comunitaria 368: detecta el mensaje en Telegram, abre el ticket y deja constancia en otra herramienta dentro de la misma ejecución. El campo Source guarda de dónde vino el aviso, y esa información sigue con el ticket hasta que se cierra.

Otro uso frecuente es el informe automático. En vez de exportar a mano, un Schedule Trigger, el disparador que se activa a intervalos regulares, dispara ticket.getAll con la opción Updated Since para traer solo lo que cambió, y el resultado aterriza en Google Sheets listo para revisar. La plantilla 4238 aprovecha la misma operación de otra manera: envía una encuesta de satisfacción cuando el ticket se resuelve y guarda las respuestas recibidas.

Los contactos también se mantienen ordenados desde aquí. contact.getAll filtrado por State detecta quién nunca confirmó su dirección, y contact.update añade una etiqueta o un identificador de empresa en cuanto llega ese dato desde otro sistema. Con un resumen breve en Slack, el responsable ve el estado de la cola sin entrar en Freshdesk, y esa misma lista de contactos puede nutrir después una campaña en Mautic.

Antes de construir conviene saber dónde acaba el nodo. Como Freshdesk no tiene trigger propio en n8n, ningún flujo arranca solo desde su lado: hace falta un Schedule Trigger, el nodo Webhook (que expone una URL para que otro servicio avise cuando pasa algo) o el disparador de otra herramienta de tu stack. El nodo tampoco sale de tickets y contactos: para el resto de la API de Freshdesk, el nodo HTTP Request llama al endpoint que haga falta reutilizando el mismo credential, así la clave queda guardada en un solo sitio.

Un último detalle que conviene revisar pronto: algunos campos opcionales dependen del plan de Freshdesk contratado. Language y Time Zone solo funcionan con la función multiidioma o multihorario (plan Garden en adelante), y Other Companies exige Multiple Companies (plan Estate en adelante); si un campo se queda sin efecto, suele ser por eso. El curso n8n repasa este montaje completo, paso a paso.

Conexión

¿Cómo conectar Freshdesk con n8n?

  1. 01

    Consigue tu clave API en Freshdesk

    Freshdesk autentica a n8n con una clave API, una cadena larga que sustituye a tu usuario y contraseña. Se obtiene desde tu perfil de Freshdesk, siguiendo la documentación de autenticación de la API de Freshdesk. Trátala como una contraseña: quien la tenga puede leer y escribir tickets en tu helpdesk. Cópiala en cuanto aparezca, porque es el único valor que el credential no puede deducir por su cuenta.

  2. 02

    Localiza el dominio, solo el subdominio

    El segundo campo se llama Domain y es el que tumba casi todos los primeros intentos. Freshdesk espera el subdominio a secas, no la dirección entera. Si entras a tu helpdesk por https://n8n.freshdesk.com, el valor que hay que escribir es n8n. Mira la URL del navegador con la sesión abierta, toma la parte anterior a .freshdesk.com y deja fuera el protocolo y la barra final.

  3. 03

    Guarda el credential una sola vez

    En n8n, abre el menú Credentials y crea un credential de Freshdesk con esos 2 valores: API Key y Domain. Un credential es un acceso que se guarda una vez y luego se elige en un desplegable desde cada nodo que lo necesita, así que la clave nunca se pega dentro de un flujo. Ese mismo credential sirve además al nodo HTTP Request a través de su autenticación predefinida.

Acciones

¿Qué sabe hacer el nodo Freshdesk ?

El nodo Freshdesk expone 10 operaciones en 2 recursos. Para cada una: el nodo tal como lo configuras en n8n, los campos obligatorios y nuestras notas de campo.

Matriz recursos × operaciones
RecursoCreateGetGet ManyUpdateDelete
Contact✓✓✓✓✓
Ticket✓✓✓✓✓

Contact

5 operaciones
01

Create a contact

contact.create

Lo que ves en n8n

Notas y casos de uso

Añade una persona a la lista de contactos de Freshdesk y devuelve la ficha creada con su identificador, lista para el nodo siguiente.

Parámetros clave

  • Name: el único campo obligatorio, el nombre visible del contacto, a menudo {{ $json.name }} venido de un formulario o del CRM.
  • Email: la dirección principal. Las direcciones adicionales van en Other Emails, no aquí.
  • Additional Fields: 17 atributos opcionales, entre ellos Phone, Company ID, Tags y Unique External ID, útil para conservar el identificador de tu propia base.
Casos de uso
alguien se registra y su contacto ya existe en Freshdesk antes del primer ticket.
02

Delete a contact

contact.delete

Lo que ves en n8n

Notas y casos de uso

Cuando alguien pide desaparecer de tus registros de soporte, esta operación borra su ficha de contacto en Freshdesk.

Parámetros clave

  • Contact ID: el identificador de Freshdesk de esa persona, no su nombre ni su correo. Tráelo de un paso Get many contacts anterior con una expresión como {{ $json.id }}, que lee un campo del elemento entrante.
Casos de uso
entra una solicitud de borrado, el flujo busca el contacto por correo, lo elimina y anota la fecha en tu registro interno.
03

Get a contact

contact.get

Lo que ves en n8n

Notas y casos de uso

Lee una ficha concreta y devuelve todos sus campos, para que los nodos posteriores no trabajen a ciegas.

Parámetros clave

  • Contact ID: el identificador de la ficha que se va a leer. Un campo marcado como obligatorio detiene la ejecución del nodo si queda vacío, así que confirma que el paso anterior entrega ese identificador.
Casos de uso
llega un ticket con el identificador del solicitante y la lectura aporta la empresa y el teléfono antes de asignarlo al agente adecuado.
04

Get many contacts

contact.getAll

Lo que ves en n8n

Notas y casos de uso

Trae contactos por lotes, con filtros que recortan el volumen antes de que cruce el resto del flujo.

Parámetros clave

  • Filters: 6 criterios opcionales, Company ID, Email, Mobile, Phone, State y Updated Since.
  • State: uno entre verified, unverified, blocked y deleted, la vía rápida para aislar cuentas que nunca confirmaron su correo.
  • Updated Since: una fecha que evita que una ejecución programada repase toda la base cada vez.
Casos de uso
una sincronización nocturna recoge los contactos modificados desde ayer y actualiza a esas mismas personas en marketing.
05

Update a contact

contact.update

Lo que ves en n8n

Notas y casos de uso

La gente cambia de puesto, de número y de empresa. Esta operación escribe esos cambios sobre una ficha existente, sin duplicarla.

Parámetros clave

  • Contact ID: la ficha que se modifica, normalmente heredada de una búsqueda previa.
  • Additional Fields: los mismos 17 atributos que en la creación. Solo se escribe lo que rellenas, así que una ejecución puede tocar únicamente Job Title.
  • View All Tickets: permite al contacto ver todos los tickets de su empresa, práctico para un interlocutor único.
Casos de uso
el CRM marca a un cliente como perdido y la etiqueta aparece en Freshdesk en el siguiente ticket.

Ticket

5 operaciones
06

Create a ticket

ticket.create

Lo que ves en n8n

Notas y casos de uso

Abre un ticket en Freshdesk a partir de lo que acaba de recibir el flujo, y devuelve el ticket creado para el resto de la ejecución.

Parámetros clave

  • Requester Identification y Value: cómo reconoce Freshdesk a la persona, por email, phone, requesterId, twitterId, facebookId o uniqueExternalId. Con un correo desconocido, Freshdesk crea el contacto de paso.
  • Status, Priority, Source: los tres son obligatorios, y Source guarda el canal, de chat a portal.
  • Options: 13 campos extra, entre ellos Subject, Description en HTML, Due By y Agent Name or ID.
Casos de uso
una alerta de caída se convierte en ticket urgente asignado al grupo de guardia.
07

Delete a ticket

ticket.delete

Lo que ves en n8n

Notas y casos de uso

Hay tickets que nunca debieron entrar en la cola. Spam, un duplicado nacido de una ejecución repetida, una prueba olvidada. A ese se le quita de en medio.

Parámetros clave

  • Ticket ID: el identificador del ticket que se borra. Aliméntalo con el ticket recién creado, {{ $json.id }}, cuando una rama del flujo concluye que fue un error.
Casos de uso
una campaña de pruebas generó varios tickets falsos y un flujo de limpieza los borra por identificador en vez de un agente uno a uno.
08

Get a ticket

ticket.get

Lo que ves en n8n

Notas y casos de uso

Relee un ticket concreto y devuelve su estado actual, que es lo que hace falta antes de decidir nada sobre él.

Parámetros clave

  • Ticket ID: el ticket que se lee. Guárdalo al crearlo y reutilízalo más adelante, en el mismo flujo o en uno de seguimiento.
Casos de uso
un recordatorio comprueba, 3 días después de la apertura, si el ticket sigue abierto antes de avisar al agente responsable.
09

Get many tickets

ticket.getAll

Lo que ves en n8n

Notas y casos de uso

Saca tickets por lotes, el punto de partida de todos los informes y de todas las encuestas que se montan sobre este nodo.

Parámetros clave

  • Return All: activado, n8n encadena las páginas de la API y trae todos los tickets que coinciden; desactivado, Limit fija el número máximo devuelto.
  • Options: 7 ajustes, entre ellos Updated Since, Requester Email, Order By e Include, que adjunta requester, company, description o stats a cada ticket.
Casos de uso
una exportación semanal ordenada por createdAt alimenta la tabla que el equipo revisa los lunes.
10

Update a ticket

ticket.update

Lo que ves en n8n

Notas y casos de uso

Casi toda automatización de soporte termina aquí: el ticket ya existe y algo tiene que cambiar en él sin que un agente lo abra.

Parámetros clave

  • Ticket ID: el ticket que se modifica, el único valor obligatorio.
  • Update Fields: 16 atributos, entre ellos Status, Priority, Agent Name or ID, Group Name or ID, Tags y Type (Incident, Problem, Question, Feature Request, Refund).
  • Due By y FR Due By: el plazo de resolución y el de la primera respuesta, si tu proceso los recalcula.
Casos de uso
un cliente responde en otra herramienta y el flujo reabre el ticket poniendo Status en open.
Necesitas ayuda

¿Necesitas ayuda para automatizar Freshdesk con n8n?

El equipo te responde directamente.

Cada mensaje lo lee una persona.

FAQ

Freshdesk y n8n: preguntas frecuentes

01¿La integración Freshdesk n8n es gratuita?
Sí por el lado de n8n. El nodo Freshdesk viene incluido: no hay nada que instalar ni nada extra que pagar, tanto en n8n Cloud como en una instancia autoalojada con la Community Edition y su licencia Sustainable Use. Un flujo se comporta igual en los dos casos. Lo que cuesta Freshdesk depende de tu propio plan, y algunos campos del nodo también: los atributos Language y Time Zone de un contacto necesitan la función multiidioma o multihorario (plan Garden en adelante), y Other Companies necesita Multiple Companies (plan Estate en adelante).
02¿Qué credentials hacen falta para conectar Freshdesk con n8n?
Un solo credential de clave API, con 2 valores. La API Key se genera desde tu cuenta de Freshdesk siguiendo la documentación de autenticación de la API de Freshdesk, y lleva los mismos permisos que el usuario al que pertenece. Domain es únicamente el subdominio: para un helpdesk accesible en https://acme.freshdesk.com, el valor es acme. El credential se crea una vez en el menú Credentials de n8n y luego se elige en un desplegable desde cada nodo Freshdesk. Ese mismo credential autentica también un nodo HTTP Request mediante su autenticación predefinida.
03¿Qué límites tiene el nodo Freshdesk en n8n?
El nodo cubre 2 recursos, Ticket y Contact, y 10 operaciones: cuatro verbos sobre cada recurso más las dos lecturas por lotes. Todo lo demás que ofrece la API de Freshdesk queda fuera del nodo. La salida es HTTP Request, que llama a cualquier endpoint de la API reutilizando el mismo credential, así que la clave sigue en un único sitio. En las lecturas por lotes, vigila la paginación: Get many tickets solo trae todo si Return All está activado; si no, Limit recorta el lote y un informe pierde filas sin avisar.
04¿Freshdesk puede disparar un flujo de n8n en tiempo real?
Desde el nodo Freshdesk no, porque no existe un trigger de Freshdesk en n8n. Un flujo que toque Freshdesk tiene que arrancar de otra forma, y tres opciones cubren casi todo. El Schedule Trigger se ejecuta a intervalo fijo y lee los tickets con Get many tickets y la opción Updated Since. El nodo Webhook de n8n da una URL que otro servicio llama cuando ocurre algo de su lado. Y el trigger de otra herramienta tuya también vale, por ejemplo una app de mensajería cuyos mensajes conviertes en tickets.
05¿n8n o Make para Freshdesk?
Depende de cuatro criterios y ninguno de los dos gana en todos. Alojamiento: n8n corre en tu servidor o en n8n Cloud, Make solo en la nube de Make. Control de los datos: autoalojar deja el contenido de los tickets y los datos de contacto en una infraestructura tuya, algo que pesa cuando los mensajes de soporte llevan datos personales. Modelo de coste: Make factura por operación, así que recorrer una lista larga de tickets es una línea de presupuesto, mientras que un n8n autoalojado se paga por servidor. Lógica visual: los dos dibujan el flujo en un lienzo y ahí manda la costumbre.