Recursos · Integración n8n

Integración Help Scout n8nAutomatiza Help Scout con n8n.

La bandeja de soporte también puede trabajar sola. La integración Help Scout n8n aporta dos nodos: uno que expone 13 operaciones repartidas en 4 recursos, conversaciones, clientes, buzones e hilos, y un trigger que escucha 12 eventos. Pensado para equipos que hoy copian tickets a mano.

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

Por qué automatizar

¿Qué resuelve la integración Help Scout n8n?

Son dos nodos que vienen dentro de n8n y se reparten el trabajo. El nodo Help Scout llama a la API Mailbox por ti: 13 operaciones sobre 4 recursos, o sea conversaciones, clientes, buzones e hilos. El Help Scout Trigger hace lo contrario, arranca un flujo de trabajo en cuanto Help Scout emite uno de sus 12 eventos.

Empieza por la señal que más cuesta cuando llega tarde: la valoración. El evento satisfaction.ratings se dispara cuando entra una puntuación, y leerla al día siguiente ya no sirve de nada. Mándala a un canal de Discord para que el responsable la vea al momento, o encadena conversation.get antes del aviso para que el mensaje lleve el asunto y el estado en lugar de un identificador suelto.

El segundo patrón va en la otra dirección: crear el ticket desde fuera. Un formulario enviado, un cobro rechazado, una fila marcada en una hoja. El flujo llama a conversation.create con buzón, asunto, estado y tipo, y después a thread.create para escribir el mensaje. El agente que abre la cola ve una conversación normal. Cuando el origen es el correo saliente, SendGrid y Gmail encajan antes de esa llamada.

El tercer patrón es el más callado y el que más se agradece a fin de mes: el reporte. Un flujo que arranca en convo.created y escribe una línea por ticket deja un backlog vivo sin que nadie toque el archivo. Con convo.assigned sabes quién coge qué, y con convo.status mides cuánto tarda un ticket en cerrarse.

Siempre quedará alguna llamada fuera de las 13 operaciones del catálogo. En n8n eso tiene una respuesta única: el nodo HTTP Request ataca cualquier endpoint de la API de Help Scout y reutiliza la misma credencial, es decir la conexión que guardas una sola vez en n8n, mediante la autenticación predefinida.

Dos detalles antes de construir. Las operaciones que devuelven listas están paginadas: Return All recorre todas las páginas de la API y, si lo dejas desactivado, la ejecución se detiene en Limit. Y los 12 eventos no se reparten por igual. Agrupados por familia salen 10 eventos convo, 1 customer y 1 satisfaction: 3 familias, 12 eventos, casi todo gira alrededor de la conversación. Si aún dudas de plataforma, la Reseña n8n lo desarrolla, y el Curso n8n monta estos flujos paso a paso.

Conexión

¿Cómo se conecta Help Scout con n8n?

  1. 01

    Crea una app en Help Scout

    Solo hay un método de autenticación admitido: OAuth2, el flujo en el que Help Scout entrega un token a n8n y tú no pegas ninguna contraseña. Necesitas una cuenta de Help Scout y después una app creada en su lado, siguiendo la documentación OAuth de Help Scout. Esa app es la que identifica a n8n cuando se emite el token, y es el único paso que ocurre fuera de n8n.

  2. 02

    Guarda la credencial una sola vez

    En n8n, entra en el menú Credentials y crea una credencial de Help Scout completando el flujo OAuth2. Una credencial es la conexión guardada que n8n reutiliza en todas partes, así no te autenticas nodo por nodo. La misma credencial vale para el nodo Help Scout y para el Help Scout Trigger, de modo que el flujo que escucha y el que escribe comparten conexión.

  3. 03

    Ejecuta una primera operación

    Coloca el nodo Help Scout en el lienzo, elige la credencial en el desplegable y selecciona un recurso y una operación. mailbox.getAll es la prueba menos arriesgada: devuelve tus buzones y confirma que el token funciona. Guarda el identificador de buzón que obtengas, porque conversation.create pide un Mailbox Name or ID, que el nodo también puede ofrecerte en una lista.

Disparadores

¿Qué pone en marcha un flujo de Help Scout ?

Help Scout Trigger es el nodo que arranca un workflow cuando algo ocurre en Help Scout. Escucha 12 eventos, listados abajo por familia. Eliges uno o varios, activas el workflow y n8n registra el webhook (la URL que Help Scout llama) en tu cuenta.

Lo que ves en n8n

Todos los eventos, por familia

Una fila por objeto, un chip por acción. El evento que marcas en el nodo se escribe objeto.acción; pasa el cursor por un chip para leer cuándo se dispara.

convo.*10
  • convo.
    • assigned
    • created
    • deleted
    • merged
    • moved
    • status
    • tags
  • convo.agent.reply.
    • created
  • convo.customer.reply.
    • created
  • convo.note.
    • created
customer.*1
  • customer.
    • created
satisfaction.*1
  • satisfaction.
    • ratings

Notas de configuración

01Set up the Help Scout TriggerEl trigger funciona por webhook, es decir una URL que Help Scout llama en el instante en que ocurre algo. n8n registra esa URL en Help Scout al activar el flujo de trabajo y cada evento llega en unos segundos. No hay frecuencia que ajustar.

El trigger funciona por webhook, es decir una URL que Help Scout llama en el instante en que ocurre algo. n8n registra esa URL en Help Scout al activar el flujo de trabajo y cada evento llega en unos segundos. No hay frecuencia que ajustar.

Parámetros clave

  • Events: la lista de tipos de evento que escucha el trigger. Hay doce disponibles y marcas los que te interesan. Si marcas demasiados, un solo flujo acaba tratando payloads que no tienen nada que ver entre sí, así que suele compensar separarlos.
Cuándo usarlo
siempre que el punto de partida sea algo que una persona hizo dentro de Help Scout. Un agente contestó, un cliente puntuó la atención, un ticket cambió de manos. Versión 1 del nodo trigger.
02Customer and satisfaction eventsDos eventos ocupan cada uno su propia familia. customer.created forma la familia customer y se dispara cuando aparece una ficha de cliente nueva. satisfaction.ratings forma la familia satisfaction y se dispara al recibirse una puntuación. Sumados a los diez eventos de conversación, la cuenta cuadra: 10 más 1 más 1, 12 eventos en 3 familias.

Dos eventos ocupan cada uno su propia familia. customer.created forma la familia customer y se dispara cuando aparece una ficha de cliente nueva. satisfaction.ratings forma la familia satisfaction y se dispara al recibirse una puntuación. Sumados a los diez eventos de conversación, la cuenta cuadra: 10 más 1 más 1, 12 eventos en 3 familias.

Casos de uso
customer.created es el enganche natural del onboarding, porque la ficha existe antes de que nadie la haya enriquecido; encadena customer.update detrás para volcar lo que otra herramienta ya sabe. satisfaction.ratings alimenta la revisión de calidad y pone el comentario delante del equipo el mismo día. Ninguno de los dos comparte campos con los diez eventos de conversación, así que un flujo que se ramifica sobre la familia necesita su propio mapeo.
03Conversation lifecycle eventsSiete de los diez eventos convo siguen la vida del ticket, no lo que se escribe dentro. convo.created al abrirse, convo.assigned al asignarse, convo.status al cambiar de estado, convo.moved al cambiar de buzón, convo.tags al etiquetarse, convo.merged cuando dos tickets se fusionan y convo.deleted al borrarse.

Siete de los diez eventos convo siguen la vida del ticket, no lo que se escribe dentro. convo.created al abrirse, convo.assigned al asignarse, convo.status al cambiar de estado, convo.moved al cambiar de buzón, convo.tags al etiquetarse, convo.merged cuando dos tickets se fusionan y convo.deleted al borrarse.

Casos de uso
la asignación y el estado concentran casi todo el valor de gestión. Arranca en convo.assigned para registrar quién coge cada caso, o en convo.status para medir el tiempo hasta el cierre. Añade convo.moved si el equipo enruta entre varios buzones y quieres ver a dónde va el volumen real. Ninguno de estos siete eventos lleva el texto del mensaje, solo el cambio en la ficha del ticket, así que una regla que también necesite el contenido encadena conversation.get justo después.
04Reply and note eventsLos tres eventos convo restantes hablan del contenido añadido a una conversación. convo.customer.reply.created salta cuando responde el cliente, convo.agent.reply.created cuando responde un agente y convo.note.created cuando alguien añade una nota interna. Distinguirlos importa: una respuesta del cliente y una del agente no piden la misma regla de seguimiento.

Los tres eventos convo restantes hablan del contenido añadido a una conversación. convo.customer.reply.created salta cuando responde el cliente, convo.agent.reply.created cuando responde un agente y convo.note.created cuando alguien añade una nota interna. Distinguirlos importa: una respuesta del cliente y una del agente no piden la misma regla de seguimiento.

Casos de uso
el caso clásico es la reapertura. Un cliente que escribe sobre un ticket ya cerrado pasa desapercibido, y este evento permite avisar al responsable antes de que el mensaje se quede sin leer. Por dentro, convo.note.created alimenta un canal donde una mención en una nota basta para traer a un compañero. Ninguno de los tres dice en qué estado está el ticket, solo lo que se acaba de añadir, así que una regla que también necesite el estado encadena conversation.get justo después del trigger.
Acciones

Las 13 operaciones del nodo, una a una

El nodo Help Scout expone 13 operaciones en 4 recursos. Para cada una: el nodo tal como lo configuras en n8n, los campos obligatorios y nuestras notas de campo.

Matriz recursos × operaciones
RecursoCreateGetGet ManyUpdateDeleteProperties
Conversation✓✓✓✓
Customer✓✓✓✓✓
Mailbox✓✓
Thread✓✓

Conversation

4 operaciones
01

Create a conversation

conversation.create

Lo que ves en n8n

Notas y casos de uso

Abre una conversación en un buzón y devuelve la conversación creada. Es la operación que convierte un evento nacido en otro sitio en un ticket que un agente puede trabajar.

Parámetros clave

  • Mailbox Name or ID: el buzón donde se crea la conversación. Se elige de la lista o se pasa por expresión con {{ $json.field }}.
  • Status: active, closed o pending.
  • Subject: el asunto, la línea que los agentes leen en la cola.
  • Type: chat, email o phone.
  • Resolve Data: desactivado, la respuesta solo trae el ID del recurso; activado, n8n resuelve los datos automáticamente.
Casos de uso
un pago rechazado se convierte en ticket de email en estado pending dentro del buzón de facturación.
02

Delete a conversation

conversation.delete

Lo que ves en n8n

Notas y casos de uso

Elimina una conversación de Help Scout. El nodo no incluye ningún paso de confirmación: lo que llega hasta aquí sale del buzón.

Parámetros clave

  • Conversation ID: la conversación que se borra, normalmente heredada de un nodo anterior con {{ $json.field }}.
Casos de uso
limpieza de spam. Un flujo que lee un buzón, puntúa asuntos y borra solo lo que cumple una regla estricta mantiene la cola legible. Pon un nodo IF delante y prueba la rama sobre una conversación de descarte antes de activar nada.
03

Get a conversation

conversation.get

Lo que ves en n8n

Notas y casos de uso

Recupera una conversación a partir de su identificador, para que un flujo que solo conoce un ID pueda trabajar con la ficha completa.

Parámetros clave

  • Conversation ID: el identificador de la conversación que se lee, a menudo tomado del payload del trigger con {{ $json.field }}.
Casos de uso
enriquecer entre el trigger y el aviso. Un flujo que arranca en una puntuación o en un cambio de estado solo lleva un identificador, y esta operación rellena el hueco antes del envío para que la notificación tenga contexto real.
04

Get many conversations

conversation.getAll

Lo que ves en n8n

Notas y casos de uso

Lista conversaciones. Es el arranque de los flujos de reporte, porque los filtros trabajan antes de que los datos entren en n8n.

Parámetros clave

  • Return All: activado, n8n recorre todas las páginas; desactivado, se detiene en Limit.
  • Modified Since: devuelve solo las conversaciones modificadas después de esa fecha, el freno habitual de una ejecución programada.
  • Status: active, all, closed, open, pending o spam.
  • Mailbox ID: restringe la lista a un buzón.
  • Embed: con el valor threads, carga las subentidades junto a la conversación.
Casos de uso
una exportación nocturna de todo lo modificado desde ayer en un solo buzón.

Customer

5 operaciones
05

Create a customer

customer.create

Lo que ves en n8n

Notas y casos de uso

Añade una ficha de cliente en Help Scout. Ningún campo es obligatorio, así que la forma de la ficha depende por completo de lo que decidas enviar.

Parámetros clave

  • Emails: una colección donde cada entrada añade una dirección a la ficha.
  • First Name: si se rellena, debe tener entre 1 y 40 caracteres.
  • Job Title: 60 caracteres como máximo.
  • Organization: la empresa a la que pertenece el contacto.
  • Phones, Websites, Social Profiles, Chat Handles, Address: una colección cada uno, que se rellena entrada por entrada.
Casos de uso
un alta empuja nombre, correo y empresa, y el primer ticket ya llega asociado a un contacto conocido.
06

Get a customer

customer.get

Lo que ves en n8n

Notas y casos de uso

Lee una ficha de cliente y la pasa al resto del flujo de trabajo.

Parámetros clave

  • Customer ID: el identificador de la ficha que se lee, heredado casi siempre del nodo anterior como {{ $json.field }}.
Casos de uso
deduplicar antes de escribir. Un flujo a punto de crear algo lee primero la ficha existente y se ramifica según lo que encuentre, y así el mismo cliente no acaba dos veces en la cuenta. También sirve como búsqueda simple cuando un aviso necesita el contacto que hay detrás de un identificador.
07

Get many customers

customer.getAll

Lo que ves en n8n

Notas y casos de uso

Devuelve una lista de clientes, con filtros aplicados por la API en lugar de por un nodo de filtrado colocado más abajo.

Parámetros clave

  • Return All: activado, vuelven todas las páginas de clientes; desactivado, la ejecución para en Limit.
  • Query: la búsqueda avanzada, para lo que los filtros simples no expresan.
  • Mailbox ID: deja solo los clientes de un buzón.
  • Sort Field y Sort Order: el orden del resultado, por ejemplo modifiedAt en desc.
Casos de uso
una sincronización mensual que recoge los clientes modificados desde la última vuelta y actualiza un CRM sin pasos manuales.
08

Get customer properties

customer.properties

Lo que ves en n8n

Notas y casos de uso

Devuelve las definiciones de propiedades de cliente de la cuenta, o sea los campos personalizados que un administrador configuró en Help Scout, no los valores guardados en un contacto. No pide ningún parámetro: colocas el nodo y ejecutas.

Casos de uso
el reconocimiento previo a un proyecto de sincronización. Con una ejecución ya sabes qué propiedades existen antes de mapear nada desde otra herramienta. También vale como control en un flujo que lleva meses en marcha, donde una propiedad renombrada pasaría inadvertida.
09

Update a customer

customer.update

Lo que ves en n8n

Notas y casos de uso

Modifica una ficha de cliente que ya existe. Solo se envían los campos que rellenes en la colección, así que un flujo puede tocar un atributo sin reescribir el contacto entero.

Parámetros clave

  • Customer ID: la ficha que se edita, pasada a menudo como {{ $json.field }} desde el nodo anterior.
  • Organization, Job Title, Location: los atributos que más se refrescan desde otro sistema.
  • Notes: el texto libre de contexto sobre el contacto.
  • Photo Url: la URL de la foto del cliente.
Casos de uso
un cambio de puesto detectado en el CRM actualiza el cargo y la empresa en Help Scout el mismo día.

Mailbox

2 operaciones
10

Get a mailbox

mailbox.get

Lo que ves en n8n

Notas y casos de uso

Devuelve los datos de un buzón. Útil cuando un flujo solo tiene un identificador y debe describir ese buzón en un mensaje que va a leer una persona.

Parámetros clave

  • Mailbox ID: el buzón que se consulta, escrito directamente o construido con una expresión.
Casos de uso
avisos con varios buzones en juego. Un evento convo.moved indica que un ticket cambió de buzón, y esta operación convierte el identificador del payload en algo legible antes de que salga la notificación.
11

Get many mailboxes

mailbox.getAll

Lo que ves en n8n

Notas y casos de uso

Lista los buzones de la cuenta. Es la operación más sencilla del nodo, y por eso la primera prueba lógica después de guardar una credencial.

Parámetros clave

  • Return All: activado, vuelven todos los buzones; desactivado, el nodo se detiene en Limit.
Casos de uso
reunir los identificadores que necesita el resto del montaje. Casi todas las demás operaciones piden un buzón, y aquí es donde salen esos valores. La biblioteca de plantillas de n8n ya trae justo eso, Get all mailboxes from Help Scout, workflow 567.

Thread

2 operaciones
12

Create a thread

thread.create

Lo que ves en n8n

Notas y casos de uso

Añade un mensaje a una conversación existente. Es la operación que escribe el contenido, mientras que conversation.create solo abre el contenedor.

Parámetros clave

  • Conversation ID: la conversación a la que se añade el hilo.
  • Type: chat, customer, note, phone o reply. Esa elección decide si el mensaje se lee como nota interna o como respuesta.
  • Text: el texto del mensaje.
  • Attachments: una colección donde cada entrada lleva FileName, Mime Type y Data, un flujo codificado en Base64.
Casos de uso
una comprobación de stock deja su resultado como nota en el ticket abierto y el agente lo ve sin cambiar de herramienta.
13

Get many threads

thread.getAll

Lo que ves en n8n

Notas y casos de uso

Devuelve los hilos de una conversación, es decir el intercambio en sí y no solo la cabecera del ticket.

Parámetros clave

  • Conversation ID: la conversación cuyos hilos quieres leer.
  • Return All: activado para el intercambio completo, desactivado para parar en Limit.
Casos de uso
alimentar un paso de IA. Una plantilla de n8n ya lo hace, Park Help Scout retro-tagged tickets for review with OpenAI and TeamRetro, workflow 18453, donde los datos de Help Scout pasan por un nodo Code y una Basic LLM Chain con Structured Output Parser.
Necesitas ayuda

¿Necesitas ayuda para automatizar Help Scout con n8n?

El equipo te responde directamente.

Cada mensaje lo lee una persona.

FAQ

Dudas frecuentes sobre la integración Help Scout n8n

01¿La integración Help Scout n8n es gratuita?
Sí por el lado de n8n. El nodo Help Scout y el Help Scout Trigger vienen incluidos con n8n, así que no hay nada que instalar ni nada extra que pagar por el conector. Esto vale tanto en n8n Cloud, la oferta alojada por n8n, como en una instancia autoalojada con la Community Edition y su licencia Sustainable Use. Un flujo construido en un sitio funciona igual en el otro, algo que importa si prototipas en Cloud y luego te mueves a tu propio servidor. Lo que cuesta una cuenta de Help Scout es otra conversación y se resuelve con Help Scout.
02¿Qué credenciales hacen falta para conectar Help Scout con n8n?
Una sola credencial, con OAuth2. Es el único método de autenticación admitido aquí, así que no existe camino por clave de API. Necesitas una cuenta de Help Scout, después una app creada en Help Scout siguiendo su documentación OAuth, y por último el flujo OAuth2 completado una vez en el menú Credentials de n8n. Esa credencial se reutiliza en todas partes: el nodo Help Scout la ofrece en un desplegable, el Help Scout Trigger usa la misma y un nodo HTTP Request puede reutilizarla mediante la autenticación predefinida. Se configura una vez y ya está.
03¿Qué límites tiene el nodo Help Scout en n8n?
Dos cosas conviene tener claras. La primera, el nodo expone 13 operaciones repartidas en 4 recursos: conversaciones, clientes, buzones e hilos. Lo que quede fuera de ese catálogo pasa por el nodo HTTP Request, que llama a cualquier endpoint de la API de Help Scout reutilizando la misma credencial con autenticación predefinida, sin gestionar una segunda conexión. La segunda, las operaciones de lista están paginadas. Return All recorre todas las páginas de la API y, desactivado, la ejecución se detiene en Limit. En un buzón grande ese ajuste decide si tu exportación es completa o solo una muestra.
04¿El Help Scout Trigger reacciona en tiempo real?
Sí. El Help Scout Trigger funciona por webhook: Help Scout llama a una URL de n8n en cuanto ocurre algo, en lugar de que n8n vaya a comprobarlo cada cierto tiempo. n8n registra esa URL en Help Scout al activar el flujo y cada evento llega en unos segundos. No hay frecuencia que configurar ni latencia que ajustar. Eliges qué eventos escuchar entre los 12 disponibles en el parámetro Events, y el trigger permanece en reposo hasta que uno de ellos salta. Agrupados por familia son 10 eventos de conversación, 1 de cliente y 1 de satisfacción.
05¿n8n o Make para automatizar Help Scout?
Depende de tres criterios. El alojamiento: n8n se autoaloja con Docker o npm, o corre en n8n Cloud, mientras que Make solo existe alojado, así que si los datos de soporte deben quedarse en una infraestructura que controlas, la decisión ya está tomada. El modelo de coste: Make factura por operación, algo que merece una simulación contra tu volumen de tickets, porque un buzón activo genera muchos eventos. La lógica visual: ambas construyen sobre un lienzo, y gana la que tu equipo vaya a mantener de verdad. La comparación detallada vive en otra página del sitio.