messaging-gateway

n8n community nodes for Unified Messaging Gateway — send and receive messages across WhatsApp, Telegram, Email, and SMS

Documentation

n8n-nodes-messaging-gateway

Community nodes for n8n to integrate with Unified Messaging Gateway — send and receive messages across WhatsApp, Telegram, Email, and SMS from your n8n workflows.

Installation

In n8n Desktop / Self-hosted

  1. Go to Settings > Community Nodes
  2. Enter n8n-nodes-messaging-gateway
  3. Click Install

Manual

cd ~/.n8n
npm install n8n-nodes-messaging-gateway

Then restart n8n.

Configuration

  1. In n8n, go to Credentials > New Credential
  2. Search for Messaging Gateway API
  3. Enter:
    • Base URL: The URL of your Messaging Gateway instance (e.g., http://localhost:3123)
    • API Key: Your gateway API key

Nodes

Messaging Gateway (Action Node)

Perform operations against the Messaging Gateway API.

Resource Operation Description
Message Send Send text, image, video, document, or location messages
Message Get Status Retrieve the delivery status of a sent message
Account List List all configured messaging accounts
Account Get Get details for a specific account
Account Connect Start a session / generate QR code
Account Disconnect Stop an active session
Group List List groups for an account
Group Get Get detailed group information
Webhook List List registered webhooks
Webhook Add Register a new webhook endpoint
Webhook Remove Delete a webhook by ID

Messaging Gateway Trigger (Trigger Node)

Starts a workflow when the gateway receives an inbound message or event.

  1. Add the Message Received trigger to your workflow
  2. Activate the workflow to obtain the webhook URL
  3. Register that URL in your Messaging Gateway via the Webhook > Add operation or the gateway API
  4. Incoming messages will trigger the workflow with the full UnifiedEnvelope payload

Supported events:

  • message.inbound — New incoming message
  • message.status — Delivery status update (sent, delivered, read, failed)
  • connection.update — Account connection state change

Example Workflows

Auto-reply to WhatsApp messages

  1. Message Received trigger (events: message.inbound)
  2. IF node to check {{$json.content.type}} === 'text'
  3. Messaging Gateway Send node to reply with a text message

Forward Telegram messages to Slack

  1. Message Received trigger (events: message.inbound)
  2. Slack node to post the message content to a channel

Monitor account health

  1. Schedule Trigger (every 5 minutes)
  2. Messaging Gateway Account > List
  3. IF node to filter disconnected accounts
  4. Email node to alert the operations team

Development

# Install dependencies
npm install

# Type-check
npm run lint

# Build
npm run build

License

MIT

Discussion