n8n-nodes-sambungan

Sambungan community node for n8n. Use it to send WhatsApp and Instagram DM messages from your n8n workflows, and to start workflows when Sambungan receives a message.

The package ships two nodes: Sambungan (actions) and Sambungan Trigger (webhook events).

Features

• Create Customer - Create a WhatsApp-ready customer.
• Get Customer - Fetch customer details by ID.
• List Customers - List and filter customers.
• Update Customer - Change name, email, tags, notes, pipeline stage, or custom fields.
• List Pipelines - List sales pipelines and their stages.
• Get Pipeline - Fetch one pipeline with its stages by ID.
• List Custom Fields - List the workspace's custom field definitions.
• Get Message Status - Check message delivery/read status.
• List Messages - Read message history, oldest first, for one conversation or the whole workspace.
• 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.
• Sambungan Trigger - Start a workflow on message.received, message.sent, message.delivered, message.read, or message.failed, with signature verification.

Full API reference: docs.sambungan.com

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, notes, pipeline stage, and custom fields. Select WhatsApp Number when the workspace has more than one active number.

Get Customer

Fetch a customer by ID.

List Customers

List customers with optional search, consent status, blacklist status, pipeline stage, WhatsApp number, limit, and offset filters.

Update Customer

Update name, email, tags, notes, pipeline stage, or custom fields. Only the fields you fill in are sent; set the pipeline stage to empty to remove the customer from its stage.

List Pipelines

List the workspace's sales pipelines with their stages. Use a stage ID from here in Create Customer or Update Customer.

Get Pipeline

Fetch a single pipeline and its stages by pipeline ID.

List Custom Fields

List the custom field definitions (key, label, type) you can set through Create Customer or Update Customer.

Get Message Status

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

List Messages

Read WhatsApp or Instagram message history, oldest first, one output item per message. Set Conversation ID or Customer ID for a single conversation; leave both empty to read the whole workspace (for example an export for analysis). Since / Until narrow the time range. Return All follows every page, paces requests to stay under the API limit (100 requests/minute per API key and per workspace), and waits out a rate-limit response (429, honouring Retry-After) instead of failing; otherwise Limit caps the result (max 200). Each message carries sender_type (customer, ai, auto_reply, agent, broadcast, business_app, business) so AI replies can be told apart from agents on WhatsApp.

Send Message

Send a message to a customer through WhatsApp or Instagram.

For Instagram workspaces with more than one connected account, select Instagram Account when the customer has messaged several of them; the account ID also arrives as data.instagram_account_id on every Instagram webhook event, so a Sambungan Trigger → Send Message reply can use it directly.

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.

When a WhatsApp template is sent to a phone number Sambungan does not know yet, a customer record is created automatically. Use Customer Name to name that record, or turn Auto-Create Customer off to reject unknown numbers instead.

Customer Lookup

Message Types

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.

Sambungan Trigger

Starts a workflow when Sambungan delivers a webhook event.

1. Add Sambungan Trigger to a workflow and copy its Production URL (use the Test URL while listening for a test event).
2. In the Sambungan dashboard open Developers → Webhooks, create an endpoint with that URL, and subscribe it to the events you want.
3. Paste the endpoint's secret into the node's Webhook Secret field. The node then verifies X-Sambungan-Signature (HMAC-SHA256 of the raw body) and rejects anything else with 401.
4. Pick the Events and Channels that should start the workflow. Deliveries that do not match are acknowledged with 200 and dropped, so Sambungan does not retry them.

Each item is the webhook payload (event_type, event_id, timestamp, data) plus delivery_id and idempotency_key from the headers. Use idempotency_key to deduplicate retries. Test deliveries sent from the dashboard (event_type: "test") always pass through so you can inspect the shape.

Payload reference: docs.sambungan.com/docs/developer/webhooks/events

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