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

# Integración con n8n

> La integración de MessageSync 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 CRM.

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 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
* Acceso a **n8n** (auto-hospedado)
* Permiso para crear claves API en el panel de integración

***

## Paso 1: Instalar el Nodo Comunitario de MessageSync en n8n[​](#paso-1-instalar-el-nodo-comunitario-de-messagesync-en-n8n "Enlace directo al Paso 1: Instalar el Nodo Comunitario de MessageSync 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-whitelable/d0UJrCwlyc8wzaxE/images/n8n-Integration/assets/images/n8n-step-1-364ab9368e018849a4a68c6a734f8663.gif?s=a9b59b7550bf9c5bb0ff825732da0d3c" 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-whitelable/d0UJrCwlyc8wzaxE/images/n8n-Integration/assets/images/n8n-step-2-ccd537203662cf02dcb570baca9a200a.gif?s=8c24bfec89ffef5e6efe7c88bb0126b1" 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 el panel[​](#paso-3-generar-clave-api-desde-el-panel "Enlace directo al Paso 3: Generar Clave API desde el panel")

Ahora generarás la clave API requerida para n8n.

<Steps>
  <Step>
    Inicia sesión en tu **panel**
  </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-whitelable/d0UJrCwlyc8wzaxE/images/n8n-Integration/assets/images/n8n-step-3-c104262b73148474d45be21f47352a6b.gif?s=49c2409dba0bbeedc6c9525e866f6975" 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 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-whitelable/d0UJrCwlyc8wzaxE/images/n8n-Integration/assets/images/n8n-step-4-b84fc8d879814d9f427b00172c4fa1e0.png?fit=max&auto=format&n=d0UJrCwlyc8wzaxE&q=85&s=d398eda582f843d548e4e4d9d6ab5ded" 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 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 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-whitelable/d0UJrCwlyc8wzaxE/images/n8n-Integration/assets/images/n8n-workflow-setup-557209ebf9f5e44db158eb2141cf4ca7.png?fit=max&auto=format&n=d0UJrCwlyc8wzaxE&q=85&s=2eaca868f74cc691813d14a2b262f8bf" 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.

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.

Casos de uso:

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

<Frame>
  <img src="https://mintcdn.com/goghl-whitelable/d0UJrCwlyc8wzaxE/images/n8n-Integration/assets/images/n8n-available-triggers-2aa1dbf105f0fe171d3b654ed8a09016.gif?s=a691d0112ed0bec6f7081bc2ff6cc857" 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 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 CRM) o Número de Teléfono
    * Contenido del mensaje
  </Step>
</Steps>

<Frame>
  <img src="https://mintcdn.com/goghl-whitelable/d0UJrCwlyc8wzaxE/images/n8n-Integration/assets/images/n8n-sending-message-11a51f246405bd845bfc036872250138.gif?s=9821e481f47a744b471516c80b8e0d12" 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 CRM[​](#ejemplo-enviar-mensaje-usando-id-de-contacto-de-crm "Enlace directo al Ejemplo: Enviar Mensaje Usando ID de Contacto de CRM")

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

***

## 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 el panel

**Los mensajes no se envían**

* Confirma que el contacto existe en el CRM
* 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@messagesync.ai**](mailto:support@messagesync.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="¿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 CRM?">
    No. n8n complementa los flujos de trabajo de CRM y permite automatizaciones avanzadas.
  </Accordion>
</AccordionGroup>

***

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