baileys-gateway

n8n community node for the local WhatsApp Gateway built on Baileys

Documentation

@jep182/n8n-nodes-baileys-gateway

n8n community node for a local WhatsApp gateway built with Baileys.

What it includes

  • WhatsApp Gateway: send text, media, document, reaction, location, contact, and poll messages
  • WhatsApp Gateway Trigger: receive webhook events from the gateway
  • credential test against the gateway API
  • channel linking from discovered chats/groups

Requirements

This package talks to a separate HTTP service. It does not run Baileys inside n8n.

You need a gateway exposing endpoints such as:

  • POST /api/v1/send
  • GET /api/v1/channels
  • POST /api/v1/webhooks/subscriptions

Install

In n8n, install the community node package:

npm install @jep182/n8n-nodes-baileys-gateway

If you run n8n in Docker, install it in the image or mount it as a custom extension package.

Credentials

Create WhatsApp Gateway API credentials with:

  • Base URL
  • API Key

Group registration flow

The intended flow is:

  1. a WhatsApp group sends /connetti-n8n monitoring
  2. the gateway registers that group under alias monitoring
  3. the node uses the alias from the channel dropdown

You can also link a discovered chat/group directly from the node UI with the Connect Target operation.

Development

pnpm install
pnpm build
npm pack --dry-run

Discussion