GWhats
    Native Integration

    GWhats + n8n

    Automate customer service, billing, CRM sync, and more — without writing a single line of code — using the official GWhats Community Node for n8n.

    @clubmega/n8n-nodes-mega
    1-click installCommunity Node
    8 resourcesAvailable resources
    13 eventsTrigger events
    No codeReady-made workflows

    What it is

    What is n8n?

    n8n is an open-source workflow automation platform. With it, you connect hundreds of systems — ERPs, CRMs, databases, APIs — visually, creating powerful automations without programming.

    The GWhats Community Node

    The @clubmega/n8n-nodes-mega package adds native GWhats support to n8n. With it, you manage contacts, conversations, messages, agents and teams, and react to real-time events via triggers.

    Why use it instead of the direct API?

    No code

    Build complete automations by dragging nodes — no need to write scripts.

    Native triggers

    React to GWhats events in real time without manually configuring webhooks.

    Hundreds of integrations

    Connect GWhats to HubSpot, Slack, Google Sheets, ERPs and more in minutes.

    Installation

    The Community Node can be installed in two ways: through the n8n interface (recommended) or via CLI for self-hosted installations. Requires n8n v1.0.0+ and Node.js v18.10+.

    1

    Install via n8n interface (recommended)

    1. 1Open n8n and click the sidebar → Settings → Community Nodes
    2. 2Click "Install a community node"
    3. 3In the search field, type: @clubmega/n8n-nodes-mega
    4. 4Check the risk confirmation box and click "Install"
    5. 5Wait for installation. n8n will automatically restart the execution environment.
    2

    Install via CLI (self-hosted)

    1. 1Access the terminal of the server where n8n is running
    2. 2Run the command below in the n8n data folder (usually ~/.n8n):
    bash
    npm install @clubmega/n8n-nodes-mega
    1. 3Restart n8n: pm2 restart n8n (or docker restart n8n)
    2. 4The GWhats node will appear in the list of available nodes

    Verify installation

    Open a workflow, click + to add a node and search for GWhats. You will see two nodes: GWhats (actions) and GWhats Trigger (events).

    Configure credentials

    Before using any GWhats node, configure the API credentials. You only need to do this once — credentials are saved and reusable across all workflows.

    1

    Get the GWhats Access Token

    1. 1Access the GWhats dashboard at app3.gwhats.app
    2. 2Click your avatar (bottom left) → Profile Settings
    3. 3Scroll to Access Tokens and click Generate Token
    4. 4Copy the generated token — it is only shown once
    2

    Get the Account ID

    The Account ID is the number in the dashboard URL after login: app3.gwhats.app/app/accounts/123/.... That number is your Account ID.

    3

    Add credentials in n8n

    1. 1In n8n, go to Credentials (sidebar) → New Credential
    2. 2Search for GWhats API and select it
    3. 3Fill in: Host URL (https://app3.gwhats.app), Account ID and API Token
    4. 4Click Save — credentials are ready to use in any GWhats node

    GWhats API credential fields

    Host URL
    https://app3.gwhats.app

    GWhats platform base URL — do not change

    Account ID
    e.g.: 123

    Number visible in the URL after login

    API Token
    your_token_here

    Token generated in Profile Settings → Access Tokens

    GWhats Node — Actions

    The GWhats node is the main action node. Use it at any point in the workflow to create, fetch, update or delete resources in GWhats. Select the Resource and the desired Operation.

    Contacts

    CreateSearchUpdateListDeleteGet conversations

    Conversations

    CreateSearchUpdate statusListAssign agentAssign team

    Messages

    SendListCreate private note

    Agents

    CreateListUpdateDelete

    Teams

    CreateListUpdateDeleteList members

    Campaigns

    CreateListDelete

    Automations

    CreateListUpdateDeleteCopy

    Reports

    Account summaryAgent metricsTeam metricsChannel metrics

    Example: create a conversation with a message

    In the GWhats node, select Conversations → Create and fill in the fields. Use n8n expressions (between {{ }}) to reference data from previous nodes:

    Conversations → Create node fields

    Contact ID
    {{ $json.contact_id }}

    Contact ID (from a previous Contacts → Search node)

    Inbox ID
    42

    WhatsApp inbox ID (Settings → Inboxes)

    Message
    {{ $json.message }}

    Message text — can be dynamic

    Assigned To
    {{ $json.agent_id }}

    Optional: responsible agent ID

    GWhats Trigger — Events

    The GWhats Trigger node is the starting point of a workflow. It automatically registers a webhook in GWhats and fires the flow in real time whenever the selected event occurs.

    When you activate the workflow in n8n, the node automatically registers the webhook in GWhats. When deactivated, the webhook is removed. No manual webhook configuration needed.

    Available events (13)

    conversation_created

    New conversation started from any channel

    conversation_updated

    A conversation's data was changed

    conversation_status_changed

    Status changed: open, resolved, pending

    message_created

    New message received or sent

    message_updated

    Message was edited or its status changed

    contact_created

    New contact created on the platform

    contact_updated

    Contact data was changed

    conversation_resolved

    Conversation marked as resolved

    agent_typing_on

    Agent started typing in the conversation

    agent_typing_off

    Agent stopped typing

    webwidget_triggered

    Chat widget triggered on the website

    label_created

    New label created in the account

    team_member_added

    Member added to a team

    How to use GWhats Trigger

    1In the workflow editor, click + → search for GWhats Trigger and select it
    2Choose the GWhats credentials configured earlier
    3Select the desired event in the Events field (e.g.: message_created)
    4Connect the trigger to the next nodes in the workflow
    5Click Activate Workflow — the webhook is automatically registered in GWhats
    6To test: send a WhatsApp message and watch the workflow fire in real time

    Workflow examples

    Ready-made automation recipes you can replicate in n8n in minutes, combining GWhats nodes with other services.

    Tips & best practices

    Use the Error Trigger node

    Add an Error Trigger node to catch failures and notify your team via Slack or email before the customer notices.

    Filter events with an IF node

    The GWhats Trigger fires for all events of the selected type. Use an IF node right after to filter by inbox, channel or status.

    Search contact before creating

    Before creating a conversation, use GWhats → Contacts → Search by phone. If it already exists, reuse the ID instead of duplicating.

    Use environment variables

    Save Account ID and Inbox IDs as variables in n8n (Settings → Variables) to simplify maintenance and environment switching.

    Rate limiting

    The GWhats API has request limits. Use a Wait node between iterations of large batches to avoid 429 errors.

    Private notes for the team

    Use GWhats → Messages → Create Private Note to log internal context without the customer seeing it — ideal for automated triage.

    Ready to get started?

    Install the Community Node in n8n and create your first GWhats automation in minutes.

    bash
    npm install @clubmega/n8n-nodes-mega