n8n-nodes-sambungan

Sambungan community node for n8n. Use it to send WhatsApp, Instagram DM, and Facebook Messenger messages from your n8n workflows.

Features

• Create Customer - Create a WhatsApp-ready customer.
• Get Customer - Fetch customer details by ID.
• List Customers - List and filter customers.
• Get Message Status - Check message delivery/read status.
• Send Message - Send text, image, document, audio, video, template, or interactive messages.
• List WhatsApp Numbers - List active WhatsApp numbers usable by the Public API.
• List Templates - List WhatsApp message templates.
• Get Template - Fetch template details by ID.
• Mark as Read - Mark inbound messages as read.
• Send Typing Indicator - Send a typing indicator to an active conversation.

Installation

Using n8n Community Nodes

1. Open Settings > Community Nodes in your n8n instance.
2. Click Install.
3. Enter the package name n8n-nodes-sambungan and confirm the installation.

The package must be available on the npm registry before it can be installed directly from the n8n UI.

Credentials

1. Log in to your Sambungan dashboard.
2. Open Developers > API Keys.
3. Create a new API key.
4. In n8n, create a new Sambungan credential and paste the API key.

Operations

Create Customer

Create a customer with phone number, name, email, consent status, tags, and notes.

Get Customer

Fetch a customer by ID.

List Customers

List customers with optional search, consent status, blacklist status, limit, and offset filters.

Get Message Status

Fetch message status by message ID. Optionally filter by WhatsApp, Instagram, or Messenger.

Send Message

Send a message to a customer through WhatsApp, Instagram, or Messenger.

For WhatsApp workspaces with more than one active business number, select WhatsApp Number. This sends whatsapp_phone_number_id to Sambungan so the message is sent from the correct number. If the workspace only has one active WhatsApp number, Sambungan can use it automatically.

Customer Lookup

| Method | Example | | ------------------ | ---------------- | | Customer ID | cust_abc123 | | Phone Number | +6281234567890 | | Instagram Username | johndoe |

Message Types

| Channel | Types | | --------- | ---------------------------------------------------------- | | WhatsApp | text, image, document, audio, video, template, interactive | | Instagram | text, image, media_share | | Messenger | text, image, video, audio, file |

List Templates

Filter WhatsApp templates by:

• Status: APPROVED, PENDING, REJECTED
• Category: MARKETING, UTILITY, AUTHENTICATION
• WhatsApp Number: limits templates to the WhatsApp Business Account that owns the selected number

List WhatsApp Numbers

Returns active WhatsApp business numbers. Use the returned whatsapp_phone_number_id in Send Message, Create Customer, List Customers, List Templates, or Send Typing Indicator when a workspace has multiple WhatsApp numbers.

Get Template

Fetch a single WhatsApp template by ID.

Mark as Read

Send a read receipt for an inbound message.

Send Typing Indicator

Show a typing indicator for a customer conversation. Rate limit: once every 3 seconds per customer.

Requirements

• Self-hosted n8n for unverified community node installation.
• A Sambungan paid plan with Developer/API access enabled.
• A valid Sambungan API key.

Security Notes

• Store API keys in n8n credentials only.
• Do not hard-code API keys in workflow nodes or public repositories.
• Only change the API Base URL if you trust the target server.

License

MIT