GWhats
    Integración Nativa

    GWhats + n8n

    Automatiza atención, cobros, sincronización con CRM y más — sin escribir una sola línea de código — usando el Community Node oficial de GWhats para n8n.

    @clubmega/n8n-nodes-mega
    Instalación en 1 clicCommunity Node
    8 recursosRecursos disponibles
    13 eventosEventos de trigger
    Sin códigoFlujos listos

    Qué es

    ¿Qué es n8n?

    n8n es una plataforma open-source de automatización de flujos de trabajo. Con ella, conectas cientos de sistemas — ERPs, CRMs, bases de datos, APIs — de forma visual, creando automatizaciones potentes sin programar.

    El Community Node de GWhats

    El paquete @clubmega/n8n-nodes-mega agrega soporte nativo de GWhats a n8n. Con él, gestionas contactos, conversaciones, mensajes, agentes y equipos, y reaccionas a eventos en tiempo real vía triggers.

    ¿Por qué usarlo en lugar de la API directa?

    Sin código

    Monta automatizaciones completas arrastrando nodos — no necesitas escribir scripts.

    Triggers nativos

    Reacciona a eventos de GWhats en tiempo real sin configurar webhooks manualmente.

    Cientos de integraciones

    Conecta GWhats a HubSpot, Slack, Google Sheets, ERPs y más en minutos.

    Instalación

    El Community Node se instala de dos formas: mediante la interfaz de n8n (recomendado) o vía CLI para instalaciones self-hosted. Requiere n8n v1.0.0+ y Node.js v18.10+.

    1

    Instalar mediante la interfaz de n8n (recomendado)

    1. 1Abre n8n y haz clic en el menú lateral → Settings → Community Nodes
    2. 2Haz clic en "Install a community node"
    3. 3En el campo de búsqueda, escribe: @clubmega/n8n-nodes-mega
    4. 4Marca la casilla de confirmación de riesgo y haz clic en "Install"
    5. 5Espera la instalación. n8n reiniciará automáticamente el entorno de ejecución.
    2

    Instalar vía CLI (self-hosted)

    1. 1Accede al terminal del servidor donde corre n8n
    2. 2Ejecuta el comando en la carpeta de datos de n8n (generalmente ~/.n8n):
    bash
    npm install @clubmega/n8n-nodes-mega
    1. 3Reinicia n8n: pm2 restart n8n (o docker restart n8n)
    2. 4El nodo GWhats aparecerá en la lista de nodos disponibles

    Verificar instalación

    Abre un flujo, haz clic en + para agregar un nodo y busca GWhats. Verás dos nodos: GWhats (acciones) y GWhats Trigger (eventos).

    Configurar credenciales

    Antes de usar cualquier nodo GWhats, configura las credenciales de acceso a la API. Solo necesitas hacerlo una vez — se guardan y pueden reutilizarse en todos los flujos.

    1

    Obtener el Token de Acceso de GWhats

    1. 1Accede al panel de GWhats en app3.gwhats.app
    2. 2Haz clic en tu avatar (esquina inferior izquierda) → Configuración del Perfil
    3. 3Desplázate hasta Tokens de Acceso y haz clic en Generar Token
    4. 4Copia el token generado — solo se muestra una vez
    2

    Obtener el Account ID

    El Account ID es el número en la URL del panel tras el login: app3.gwhats.app/app/accounts/123/.... Ese número es tu Account ID.

    3

    Agregar las credenciales en n8n

    1. 1En n8n, ve a Credentials (menú lateral) → New Credential
    2. 2Busca GWhats API y selecciónalo
    3. 3Rellena: Host URL (https://app3.gwhats.app), Account ID y API Token
    4. 4Haz clic en Save — las credenciales están listas para usar en cualquier nodo GWhats

    Campos de la credencial GWhats API

    Host URL
    https://app3.gwhats.app

    URL base de la plataforma GWhats — no modificar

    Account ID
    ej: 123

    Número visible en la URL tras el login

    API Token
    tu_token_aquí

    Token generado en Configuración del Perfil → Tokens de Acceso

    Nodo GWhats — Acciones

    El nodo GWhats es el nodo de acción principal. Úsalo en cualquier punto del flujo para crear, buscar, actualizar o eliminar recursos en GWhats. Selecciona el Resource y la Operation deseada.

    Contactos

    CrearBuscarActualizarListarEliminarBuscar conversaciones

    Conversaciones

    CrearBuscarActualizar estadoListarAsignar agenteAsignar equipo

    Mensajes

    EnviarListarCrear nota privada

    Agentes

    CrearListarActualizarEliminar

    Equipos

    CrearListarActualizarEliminarListar miembros

    Campañas

    CrearListarEliminar

    Automatizaciones

    CrearListarActualizarEliminarCopiar

    Informes

    Resumen de cuentaMétricas por agenteMétricas por equipoMétricas por canal

    Ejemplo: crear una conversación con mensaje

    En el nodo GWhats, selecciona Conversaciones → Crear y rellena los campos. Usa expresiones de n8n (entre {{ }}) para referenciar datos de nodos anteriores:

    Campos del nodo Conversaciones → Crear

    Contact ID
    {{ $json.contact_id }}

    ID del contacto (de un nodo Contactos → Buscar anterior)

    Inbox ID
    42

    ID de la bandeja de entrada de WhatsApp (Configuración → Bandejas)

    Message
    {{ $json.mensaje }}

    Texto del mensaje — puede ser dinámico

    Assigned To
    {{ $json.agent_id }}

    Opcional: ID del agente responsable

    GWhats Trigger — Eventos

    El nodo GWhats Trigger es el punto de partida de un flujo. Registra automáticamente un webhook en GWhats y dispara el flujo en tiempo real cada vez que ocurre el evento seleccionado.

    Al activar el flujo en n8n, el nodo registra el webhook automáticamente en GWhats. Al desactivarlo, el webhook se elimina. No es necesario configurar webhooks manualmente.

    Eventos disponibles (13)

    conversation_created

    Nueva conversación iniciada desde cualquier canal

    conversation_updated

    Los datos de una conversación fueron modificados

    conversation_status_changed

    Estado cambiado: abierta, resuelta, pendiente

    message_created

    Nuevo mensaje recibido o enviado

    message_updated

    Mensaje editado o su estado cambió

    contact_created

    Nuevo contacto creado en la plataforma

    contact_updated

    Los datos del contacto fueron modificados

    conversation_resolved

    Conversación marcada como resuelta

    agent_typing_on

    El agente comenzó a escribir en la conversación

    agent_typing_off

    El agente dejó de escribir

    webwidget_triggered

    Widget de chat activado en el sitio web

    label_created

    Nueva etiqueta creada en la cuenta

    team_member_added

    Miembro agregado a un equipo

    Cómo usar GWhats Trigger

    1En el editor de flujos, haz clic en + → busca GWhats Trigger y selecciónalo
    2Elige las credenciales de GWhats configuradas anteriormente
    3Selecciona el evento deseado en el campo Events (ej: message_created)
    4Conecta el trigger a los siguientes nodos del flujo
    5Haz clic en Activate Workflow — el webhook se registra automáticamente en GWhats
    6Para probar: envía un mensaje de WhatsApp y observa el flujo dispararse en tiempo real

    Ejemplos de flujo

    Recetas de automatización listas para replicar en n8n en minutos, combinando nodos GWhats con otros servicios.

    Consejos y buenas prácticas

    Usa el nodo Error Trigger

    Agrega un nodo Error Trigger para capturar fallos y notificar a tu equipo vía Slack o email antes de que el cliente lo note.

    Filtra eventos con nodo IF

    El GWhats Trigger se dispara para todos los eventos del tipo seleccionado. Usa un nodo IF justo después para filtrar por bandeja, canal o estado.

    Busca el contacto antes de crearlo

    Antes de crear una conversación, usa GWhats → Contactos → Buscar por teléfono. Si ya existe, reutiliza el ID en lugar de duplicar.

    Usa variables de entorno

    Guarda Account ID e Inbox IDs como variables en n8n (Settings → Variables) para facilitar el mantenimiento y cambio de entorno.

    Rate limiting

    La API de GWhats tiene límite de solicitudes. Usa el nodo Wait entre iteraciones de grandes lotes para evitar errores 429.

    Notas privadas para el equipo

    Usa GWhats → Mensajes → Crear Nota Privada para registrar contexto interno sin que el cliente lo vea — ideal para triaje automatizado.

    ¿Listo para comenzar?

    Instala el Community Node en n8n y crea tu primera automatización con GWhats en minutos.

    bash
    npm install @clubmega/n8n-nodes-mega