INTEGRACIÓN HELPSCOUT n8n: AUTOMATIZAR HELPSCOUT CON N8N

Esta acción recupera múltiples threads de una conversación específica en HelpScout, permitiéndote extraer el historial de mensajes para procesamiento externo, análisis o sincronización con otras herramientas.

Parámetros clave: Credential to connect with: Selección de las credenciales OAuth2 de tu cuenta HelpScout para autenticar la solicitud. Requerido. Conversation ID: Campo de texto donde especificas el ID único de la conversación cuyos threads deseas recuperar. Opcional – si lo dejas vacío, el comportamiento puede variar según la API. Return All: Interruptor on/off que determina si recuperar todos los threads sin límite (cuando está activado) o respetar el límite definido (cuando está desactivado). Limit: Campo numérico que establece el número máximo de threads a recuperar. En el ejemplo, está configurado a 50, devolviendo hasta 50 threads de la conversación.

Casos de uso típicos: Extraer todos los mensajes de una conversación para alimentar un sistema de análisis de sentimiento. Sincronizar threads hacia una base de datos externa para auditoría o archivado. Recuperar los últimos 10 mensajes de una conversación activa para mostrarlos en un dashboard interno.

Cuándo usarlo: Perfecto cuando necesitas acceder al contenido detallado de las conversaciones, ya sea para análisis, integración con CRM o generación de informes de actividad de soporte.

Esta acción crea un nuevo thread dentro de una conversación existente en HelpScout, permitiéndote añadir mensajes, notas o respuestas automáticamente desde tus workflows.

Parámetros clave: Credential to connect with: Credenciales de autenticación de tu cuenta HelpScout. Requerido. Conversation ID: ID de la conversación a la que se añadirá el thread. Requerido – el thread debe estar vinculado a una conversación existente. Type: Tipo de thread a crear (correspondencia, nota interna, etc.). Debe especificarse para definir correctamente la naturaleza del thread. Text: Campo de texto para proporcionar el contenido o mensaje del thread. Opcional pero comúnmente usado para detallar el mensaje. Additional Fields: Sección expandible para añadir propiedades opcionales como autor, fecha de creación o campos personalizados soportados por HelpScout. Attachments: Permite adjuntar archivos relacionados con el thread. Puedes añadir uno o múltiples archivos mediante el botón "Add Attachments".

Casos de uso típicos: Añadir automáticamente una nota interna cuando un cliente escala un ticket. Crear una respuesta automática en una conversación cuando se cumple cierta condición en tu CRM. Documentar automáticamente acciones realizadas por otros sistemas (ej: "Pedido creado en Shopify #12345").

Cuándo usarlo: Ideal para automatizar la documentación de interacciones, añadir contexto a conversaciones activas o generar respuestas automáticas sin intervención manual del equipo de soporte.

Esta acción recupera múltiples mailboxes (buzones) de tu cuenta HelpScout, permitiéndote obtener una lista de todos los buzones configurados para procesamiento o sincronización.

Parámetros clave: Credential to connect with: Credenciales de tu cuenta HelpScout para autenticar la solicitud. Requerido. Return All: Interruptor on/off para especificar si devolver todos los registros de mailboxes o limitar el número de entradas retornadas. En el ejemplo, está desactivado, limitando los resultados. Limit: Campo numérico que restringe el número máximo de mailboxes recuperados en una sola ejecución. Configurado a 50 en la captura, devuelve hasta 50 buzones.

Casos de uso típicos: Listar todos los mailboxes disponibles para seleccionar dinámicamente en qué buzón crear conversaciones. Sincronizar la estructura de mailboxes hacia una base de datos externa para reporting. Obtener IDs de mailboxes para utilizarlos como parámetros en otras acciones HelpScout.

Cuándo usarlo: Útil cuando necesitas obtener información sobre la configuración de buzones, especialmente en workflows que gestionan conversaciones de manera dinámica según el mailbox de destino.

Esta acción recupera los detalles de un mailbox específico en HelpScout mediante su ID único, permitiéndote acceder a información detallada sobre un buzón particular.

Parámetros clave: Credential to connect with: Credenciales de autenticación de tu cuenta HelpScout. Requerido. Mailbox ID: Campo de texto donde introduces el identificador único del mailbox que deseas recuperar. Requerido para especificar qué buzón consultar. Puede proporcionarse como valor fijo o dinámicamente mediante una expresión n8n.

Casos de uso: Verificar la configuración de un mailbox antes de crear una conversación en él. Obtener propiedades de un buzón específico para validación o logging.

Cuándo usarlo: Cuando necesitas información detallada sobre un buzón en particular, especialmente para validar configuraciones antes de ejecutar otras acciones relacionadas con ese mailbox.

Esta acción actualiza los detalles de un cliente existente en HelpScout, permitiéndote modificar información como nombre, email, teléfono u otras propiedades personalizadas.

Parámetros clave: Credential to connect with: Credenciales de tu cuenta HelpScout. Requerido. Customer ID: Campo de texto donde introduces el ID único del cliente que deseas actualizar. Requerido para identificar correctamente el registro a modificar. Update Fields: Sección dinámica donde puedes añadir múltiples campos a actualizar. Haz clic en "Add Field" para especificar las propiedades a modificar (nombre, email, teléfono, dirección, etc.).

Casos de uso típicos: Sincronizar automáticamente cambios de información de clientes desde tu CRM hacia HelpScout. Enriquecer perfiles de clientes con datos provenientes de formularios o interacciones en otras plataformas. Actualizar el email de contacto de un cliente cuando cambia en tu base de datos principal, como HubSpot.

Cuándo usarlo: Perfecto para mantener la coherencia de datos entre sistemas, asegurando que la información de clientes en HelpScout esté siempre actualizada con tus fuentes de verdad externas.

Esta acción permite acceder o manipular las propiedades de un cliente en HelpScout, ofreciendo flexibilidad para gestionar atributos personalizados o estándar de los perfiles de clientes.

Parámetros clave: Credential to connect with: Credenciales de autenticación de tu cuenta HelpScout. Requerido. Resource: Tipo de recurso HelpScout sobre el que actuar, aquí configurado en "Customer". Operation: Acción específica a realizar, aquí establecida en "Properties", indicando que la acción gestiona propiedades de clientes.

Casos de uso: Consultar propiedades disponibles de clientes para mapear campos en sincronizaciones. Gestionar atributos personalizados de perfiles de clientes de manera programática.

Cuándo usarlo: Útil cuando necesitas trabajar con metadatos o propiedades específicas de clientes, especialmente en workflows de sincronización avanzada o personalización de perfiles.

Esta acción recupera múltiples registros de clientes de tu cuenta HelpScout, permitiéndote extraer listas de contactos para procesamiento, análisis o sincronización con otros sistemas.

Parámetros clave: Credential to connect with: Credenciales de autenticación de tu cuenta HelpScout. Requerido. Return All: Interruptor on/off que, cuando está activado, devuelve todos los registros de clientes sin límite. En el ejemplo, está desactivado, activando el parámetro Limit. Limit: Campo numérico que especifica el número máximo de clientes a recuperar. Configurado a 50 en la captura, devuelve hasta 50 registros de clientes. Options: Sección donde puedes añadir propiedades opcionales adicionales para filtrado o control más granular. Actualmente muestra "No properties" con opción de "Add option" para personalización.

Casos de uso típicos: Exportar una lista de clientes de HelpScout hacia una hoja de cálculo o base de datos externa. Sincronizar perfiles de clientes hacia tu CRM en lotes de 50 para procesamiento controlado. Recuperar los últimos 100 clientes creados para análisis de crecimiento.

Cuándo usarlo: Ideal para operaciones de sincronización masiva, generación de informes de base de clientes o migración de datos hacia otras plataformas.

Esta acción recupera los detalles de un cliente específico en HelpScout mediante su ID único, permitiéndote acceder a toda la información de un contacto particular.

Parámetros clave: Credential to connect with: Credenciales de autenticación de tu cuenta HelpScout. Requerido. Customer ID: Campo de texto donde introduces el identificador único del cliente cuyos detalles deseas recuperar. Requerido para especificar qué cliente consultar.

Casos de uso: Verificar la información de un cliente antes de crear una conversación vinculada a él. Enriquecer datos de un contacto en tu CRM con información actualizada de HelpScout. Obtener emails, teléfonos o direcciones de un cliente para utilizarlos en otros pasos del workflow.

Cuándo usarlo: Cuando necesitas información completa y actualizada de un cliente específico, especialmente antes de realizar operaciones que requieren validación o enriquecimiento de datos.

Esta acción crea un nuevo registro de cliente en HelpScout, permitiéndote añadir contactos con información detallada como direcciones, emails múltiples y handles de chat.

Parámetros clave: Credential to connect with: Credenciales de autenticación de tu cuenta HelpScout. Requerido. Resolve Data: Interruptor activado que procesa y resuelve automáticamente los datos devueltos para facilitar su uso en pasos posteriores del workflow. Additional Fields: Sección expandible para añadir propiedades personalizadas opcionales. Haz clic en "Add Field" para incluir más campos. Address: Sección que permite añadir una o múltiples direcciones asociadas al cliente mediante "Add Address". Chat Handles: Permite añadir detalles de handles de chat haciendo clic en "Add Chat Handle". Emails: Sección para introducir múltiples direcciones de email mediante "Add Email". Actualmente muestra "Currently no items exist", indicando que no hay datos prellenados pero pueden añadirse opcionalmente.

Casos de uso típicos: Crear automáticamente un cliente en HelpScout cuando un nuevo contacto se registra en tu aplicación. Importar contactos desde un CSV o base de datos externa hacia HelpScout en lotes. Sincronizar nuevos leads de tu CRM hacia HelpScout para gestión de soporte.

Cuándo usarlo: Perfecto para workflows de onboarding de clientes, sincronización de bases de datos o importación masiva de contactos desde fuentes externas.

Esta acción recupera múltiples registros de conversaciones de tu cuenta HelpScout, permitiéndote extraer listas de tickets o intercambios para análisis, reporting o sincronización.

Parámetros clave: Credential to connect with: Credenciales de autenticación de tu cuenta HelpScout. Requerido. Return All: Interruptor on/off que, cuando está activado, devuelve todas las conversaciones sin límite. En el ejemplo, está desactivado, activando el parámetro Limit. Limit: Campo numérico que establece el número máximo de conversaciones a recuperar en esta ejecución. Configurado a 50 en la captura. Options: Sección para añadir propiedades opcionales que permiten filtrado o control más granular. Actualmente muestra "No properties" con opción "Add option" para configuración adicional.

Casos de uso típicos: Exportar las últimas 100 conversaciones hacia un sistema de analytics para medir tiempos de respuesta. Sincronizar conversaciones activas hacia un dashboard de seguimiento en tiempo real. Recuperar conversaciones de un período específico para auditoría o generación de informes.

Cuándo usarlo: Ideal para operaciones de análisis de soporte, generación de reportes de actividad o sincronización periódica de datos de conversaciones con herramientas externas.

Esta acción recupera los detalles de una conversación específica en HelpScout mediante su ID único, permitiéndote acceder a toda la información de un ticket o intercambio particular.

Parámetros clave: Credential to connect with: Credenciales de autenticación de tu cuenta HelpScout. Requerido. Conversation ID: Campo de texto donde introduces el ID específico de la conversación que deseas consultar. Requerido para identificar de manera única qué conversación recuperar.

Casos de uso: Verificar el estado de una conversación antes de crear un thread adicional. Extraer detalles de una conversación para enriquecer un registro en tu CRM. Obtener información de asunto, estado o participantes de una conversación específica para lógica condicional en tu workflow.

Cuándo usarlo: Cuando necesitas información completa y actualizada de una conversación en particular, especialmente para tomar decisiones automatizadas basadas en su estado o contenido.

Esta acción elimina una conversación específica de HelpScout mediante su ID, permitiéndote borrar tickets o intercambios de manera programática desde tus workflows.

Parámetros clave: Credential to connect with: Credenciales de autenticación de tu cuenta HelpScout. Requerido. Conversation ID: Campo de texto donde introduces el ID de la conversación a eliminar. Requerido para identificar qué conversación borrar.

Casos de uso: Eliminar automáticamente conversaciones marcadas como spam después de validación. Borrar conversaciones de prueba creadas durante procesos de testing. Implementar políticas de retención eliminando conversaciones antiguas según criterios definidos.

Cuándo usarlo: Útil para gestión de limpieza de datos, implementación de políticas de retención o automatización de eliminación de conversaciones no deseadas según reglas específicas.

Esta acción crea una nueva conversación en HelpScout, permitiéndote iniciar tickets o intercambios automáticamente desde tus workflows sin intervención manual.

Parámetros clave: Credential to connect with: Credenciales de autenticación de tu cuenta HelpScout. Requerido. Mailbox Name or ID: Campo para especificar el mailbox donde se creará la conversación. Acepta el nombre o ID único del buzón. En el ejemplo, muestra un error al obtener opciones, pero normalmente permite selección o entrada de texto. Status: Menú desplegable para seleccionar el estado de la conversación. Actualmente sin valor seleccionado. Subject: Campo de texto donde especificas el asunto de la conversación. Type: Menú desplegable para categorizar el tipo de conversación. Sin valor seleccionado en el ejemplo. Resolve Data: Interruptor activado que procesa y resuelve datos necesarios durante la ejecución. Additional Fields: Sección donde puedes añadir propiedades opcionales extra para la conversación. Actualmente sin campos configurados, con botón "Add Field" para personalización.

Casos de uso típicos: Crear automáticamente un ticket de soporte cuando un formulario de contacto se envía en tu sitio web. Iniciar una conversación en HelpScout cuando se detecta un error crítico en tu aplicación. Generar tickets desde integraciones con chat en vivo o redes sociales.

Cuándo usarlo: Perfecto para automatizar la creación de conversaciones desde fuentes externas, centralizar solicitudes de soporte de múltiples canales o iniciar tickets basados en eventos específicos en tus sistemas.