> ## Documentation Index
> Fetch the complete documentation index at: https://help.goghl.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# Integración con n8n

> La integración de GoGHL con n8n te permite conectar tu capa de mensajería de WhatsApp directamente con . Esto permite automatizaciones avanzadas como disparadores basados en mensajes, envío de mensajes salientes, sincronización de conversaciones y construcción de lógica personalizada que va más allá de los flujos de trabajo estándar de HighLevel.

Con esta integración, puedes:

* Activar flujos de trabajo con mensajes de WhatsApp entrantes o salientes
* Enviar mensajes de WhatsApp programáticamente
* Construir lógica de automatización compleja usando el ecosistema de n8n
* Combinar la mensajería de GoGHL con herramientas externas, APIs, CRMs y bases de datos

***

## Requisitos Previos[​](#requisitos-previos "Enlace directo al Requisitos Previos")

Antes de comenzar, asegúrate de tener:

* Una cuenta activa de **GoGHL.ai**
* Una **sub-cuenta de HighLevel** para integrar con n8n
* Acceso a **n8n** (auto-hospedado)
* Permiso para crear claves API en GoGHL

***

## Paso 1: Instalar el Nodo Comunitario de GoGHL en n8n[​](#paso-1-instalar-el-nodo-comunitario-de-goghl-en-n8n "Enlace directo al Paso 1: Instalar el Nodo Comunitario de GoGHL en n8n")

<Steps>
  <Step>
    Inicia sesión en tu **panel de n8n**
  </Step>

  <Step>
    Abre **Configuración**
  </Step>

  <Step>
    Navega a **Community Nodes** (Nodos Comunitarios)
  </Step>

  <Step>
    Haz clic en **Install** (Instalar)
  </Step>

  <Step>
    Pega la siguiente URL del paquete:

    ```text theme={null}
    n8n-nodes-message-sync-ai
    ```
  </Step>

  <Step>
    Completa la instalación y reinicia n8n si se solicita
  </Step>
</Steps>

<Frame>
  <img src="https://mintcdn.com/goghl/JZJa2MoUHOf9Nw9w/images/n8n-Integration/assets/images/n8n-step-1-364ab9368e018849a4a68c6a734f8663.gif?s=21aa09edbbd6fec03eeb773d6d6515ea" alt="Instalar el Nodo Comunitario MessageSync.ai en n8n" width="1920" height="977" data-path="images/n8n-Integration/assets/images/n8n-step-1-364ab9368e018849a4a68c6a734f8663.gif" />
</Frame>

Agrega rápidamente el Nodo Comunitario MessageSync.ai a tu instancia de n8n a través del panel de Nodos Comunitarios.

***

## Paso 2: Crear Credenciales en n8n[​](#paso-2-crear-credenciales-en-n8n "Enlace directo al Paso 2: Crear Credenciales en n8n")

Una vez que el paquete esté instalado, necesitas configurar las credenciales.

<Steps>
  <Step>
    Ve a **Credentials** (Credenciales) en n8n
  </Step>

  <Step>
    Haz clic en **MessageSync.ai** o Agregar Credencial y busca MessageSync.ai
  </Step>

  <Step>
    Abre la credencial de **MessageSync.ai Account**
  </Step>
</Steps>

<Frame>
  <img src="https://mintcdn.com/goghl/JZJa2MoUHOf9Nw9w/images/n8n-Integration/assets/images/n8n-step-2-ccd537203662cf02dcb570baca9a200a.gif?s=51a221414a0feb1ea9979204ab095be2" alt="Instalar el Nodo Comunitario MessageSync.ai en n8n" width="1920" height="977" data-path="images/n8n-Integration/assets/images/n8n-step-2-ccd537203662cf02dcb570baca9a200a.gif" />
</Frame>

Abre el panel de credenciales de MessageSync.ai en n8n para comenzar la configuración.

***

## Paso 3: Generar Clave API desde GoGHL[​](#paso-3-generar-clave-api-desde-goghl "Enlace directo al Paso 3: Generar Clave API desde GoGHL")

Ahora generarás la clave API requerida para n8n.

<Steps>
  <Step>
    Inicia sesión en tu **panel de GoGHL.ai**
  </Step>

  <Step>
    Selecciona la **sub-cuenta** que deseas conectar
  </Step>

  <Step>
    Ve a **Configuración**
  </Step>

  <Step>
    Desplázate hasta la sección de **Claves API**
  </Step>

  <Step>
    Crea una nueva **Clave API** para n8n
  </Step>

  <Step>
    Copia:

    * **Clave API**
    * **ID de Sub-cuenta**
  </Step>
</Steps>

<Frame>
  <img src="https://mintcdn.com/goghl/JZJa2MoUHOf9Nw9w/images/n8n-Integration/assets/images/n8n-step-3-c104262b73148474d45be21f47352a6b.gif?s=5b74a7c325775058fbd37f98e25d1ac4" alt="Instalar el Nodo Comunitario MessageSync.ai en n8n" width="1920" height="977" data-path="images/n8n-Integration/assets/images/n8n-step-3-c104262b73148474d45be21f47352a6b.gif" />
</Frame>

Abre tu panel de GoGHL y copia la Clave API y el ID de Sub-cuenta en el panel de credenciales de MessageSync.ai desde el panel de n8n.

***

## Paso 4: Configurar Credenciales en n8n[​](#paso-4-configurar-credenciales-en-n8n "Enlace directo al Paso 4: Configurar Credenciales en n8n")

<Steps>
  <Step>
    Regresa a la **credencial de MessageSync.ai** en n8n
  </Step>

  <Step>
    Pega:

    * Clave API
    * ID de Sub-cuenta
  </Step>

  <Step>
    Guarda la credencial
  </Step>
</Steps>

<Frame>
  <img src="https://mintcdn.com/goghl/JZJa2MoUHOf9Nw9w/images/n8n-Integration/assets/images/n8n-step-4-b84fc8d879814d9f427b00172c4fa1e0.png?fit=max&auto=format&n=JZJa2MoUHOf9Nw9w&q=85&s=940d1d1fb21c90a2495c1b90c7ebc0ad" alt="Instalar el Nodo Comunitario MessageSync.ai en n8n" width="3456" height="1758" data-path="images/n8n-Integration/assets/images/n8n-step-4-b84fc8d879814d9f427b00172c4fa1e0.png" />
</Frame>

Pega tu Clave API de GoGHL y el ID de Sub-cuenta en el panel de credenciales de MessageSync.ai en n8n y guarda para completar la integración.

Una vez guardado, tu cuenta de GoGHL ahora está conectada de forma segura a n8n.

***

## Paso 5: Crear Tu Primer Flujo de Trabajo[​](#paso-5-crear-tu-primer-flujo-de-trabajo "Enlace directo al Paso 5: Crear Tu Primer Flujo de Trabajo")

<Steps>
  <Step>
    Ve a **Workflows** (Flujos de Trabajo)
  </Step>

  <Step>
    Haz clic en **Create Workflow** (Crear Flujo de Trabajo)
  </Step>

  <Step>
    Haz clic en **Add Node** (Agregar Nodo)
  </Step>

  <Step>
    Busca **MessageSync**
  </Step>
</Steps>

<Frame>
  <img src="https://mintcdn.com/goghl/JZJa2MoUHOf9Nw9w/images/n8n-Integration/assets/images/n8n-workflow-setup-557209ebf9f5e44db158eb2141cf4ca7.png?fit=max&auto=format&n=JZJa2MoUHOf9Nw9w&q=85&s=cb3518e5c1d05876d2b5930db719699d" alt="Instalar el Nodo Comunitario MessageSync.ai en n8n" width="3456" height="1758" data-path="images/n8n-Integration/assets/images/n8n-workflow-setup-557209ebf9f5e44db158eb2141cf4ca7.png" />
</Frame>

***

## Disparadores Disponibles[​](#disparadores-disponibles "Enlace directo al Disparadores Disponibles")

Puedes iniciar flujos de trabajo usando los siguientes disparadores:

### Disparador de Mensaje Entrante[​](#disparador-de-mensaje-entrante "Enlace directo al Disparador de Mensaje Entrante")

Se activa cuando se recibe un mensaje de WhatsApp en GoGHL.

Casos de uso:

* Respuestas automáticas
* Calificación de prospectos
* Reenvío de webhooks
* Actualizaciones de CRM

### Disparador de Mensaje Saliente[​](#disparador-de-mensaje-saliente "Enlace directo al Disparador de Mensaje Saliente")

Se activa cuando se envía un mensaje de WhatsApp desde GoGHL.

Casos de uso:

* Registro de mensajes
* Analíticas
* Sincronización con sistemas externos

<Frame>
  <img src="https://mintcdn.com/goghl/JZJa2MoUHOf9Nw9w/images/n8n-Integration/assets/images/n8n-available-triggers-2aa1dbf105f0fe171d3b654ed8a09016.gif?s=3106684b0419189d713e6ec5a7d89003" alt="Instalar el Nodo Comunitario MessageSync.ai en n8n" width="1920" height="977" data-path="images/n8n-Integration/assets/images/n8n-available-triggers-2aa1dbf105f0fe171d3b654ed8a09016.gif" />
</Frame>

Disparadores de Ejemplo: Configura automatizaciones que se inician cuando recibes o envías un mensaje de WhatsApp a través de GoGHL usando el nodo MessageSync.ai en n8n.

***

## Enviar un Mensaje Usando n8n[​](#enviar-un-mensaje-usando-n8n "Enlace directo al Enviar un Mensaje Usando n8n")

También puedes enviar mensajes de WhatsApp directamente desde n8n.

<Steps>
  <Step>
    Agrega un nodo **MessageSync → Send Message** (Enviar Mensaje)
  </Step>

  <Step>
    Selecciona tus credenciales configuradas
  </Step>

  <Step>
    Proporciona los campos requeridos:

    * ID de Contacto (de GoHighLevel) o Número de Teléfono
    * Contenido del mensaje
  </Step>
</Steps>

<Frame>
  <img src="https://mintcdn.com/goghl/JZJa2MoUHOf9Nw9w/images/n8n-Integration/assets/images/n8n-sending-message-11a51f246405bd845bfc036872250138.gif?s=67bd80b0fad713849181ea9f608b41ab" alt="Instalar el Nodo Comunitario MessageSync.ai en n8n" width="1920" height="977" data-path="images/n8n-Integration/assets/images/n8n-sending-message-11a51f246405bd845bfc036872250138.gif" />
</Frame>

Envía un mensaje de WhatsApp configurando el ID de contacto (o Número de Teléfono) y el mensaje en el nodo MessageSync.ai.

### Ejemplo: Enviar Mensaje Usando ID de Contacto de GHL[​](#ejemplo-enviar-mensaje-usando-id-de-contacto-de-ghl "Enlace directo al Ejemplo: Enviar Mensaje Usando ID de Contacto de GHL")

Esto te permite:

* Enviar mensajes a contactos existentes
* Activar mensajes de WhatsApp desde cualquier lógica de n8n
* Combinar con webhooks, formularios o bases de datos

***

## Mejores Prácticas[​](#mejores-prácticas "Enlace directo al Mejores Prácticas")

* Usa disparadores entrantes para automatizaciones basadas en eventos
* Mantén las claves API limitadas a sub-cuentas específicas
* Registra los flujos de trabajo durante las pruebas para evitar envíos duplicados
* Combina la lógica de n8n con las funciones de goteo y limitación de velocidad de GoGHL

***

## Solución de Problemas[​](#solución-de-problemas "Enlace directo al Solución de Problemas")

**El nodo no es visible después de la instalación**

* Reinicia n8n
* Asegúrate de que los nodos comunitarios estén habilitados

**Error de autenticación**

* Vuelve a verificar la clave API y el ID de sub-cuenta
* Asegúrate de que la clave esté activa en GoGHL

**Los mensajes no se envían**

* Confirma que el contacto existe en GHL
* Valida que el número de WhatsApp esté conectado

***

## Soporte[​](#soporte "Enlace directo al Soporte")

Si necesitas ayuda para configurar esto o construir flujos de trabajo:

* Contáctanos por **Chat de WhatsApp**
* Escribe a [**support@goghl.ai**](mailto:support@goghl.ai)

Estaremos encantados de ayudarte a diseñar flujos de trabajo o depurar configuraciones.

***

## Preguntas Frecuentes[​](#preguntas-frecuentes "Enlace directo al Preguntas Frecuentes")

<AccordionGroup>
  <Accordion title="¿Necesito una sub-cuenta de HighLevel para usar esta integración?">
    Sí. La integración se conecta a nivel de sub-cuenta, por lo que necesitarás una sub-cuenta de HighLevel para integrar con n8n. La clave API y el ID de sub-cuenta utilizados en las credenciales se generan desde esa sub-cuenta.
  </Accordion>

  <Accordion title="¿Puedo usar esto con múltiples sub-cuentas?">
    Sí. Cada sub-cuenta requiere su propia clave API y credencial.
  </Accordion>

  <Accordion title="¿Esto reemplaza los flujos de trabajo de GoHighLevel?">
    No. n8n complementa los flujos de trabajo de GHL y permite automatizaciones avanzadas.
  </Accordion>
</AccordionGroup>

***

Ya estás listo para construir poderosas automatizaciones de WhatsApp usando **GoGHL + n8n**.
