n8n-nodes-waappa

Waappa community nodes for n8n. Use these nodes to send WhatsApp messages, upload media, manage selected group/contact utilities, and receive Waappa webhook events inside n8n workflows.

Installation

Install from n8n Community Nodes:

1. Open n8n.
2. Go to Settings > Community Nodes.
3. Select Install.
4. Enter:

n8n-nodes-waappa

For local development:

npm install
npm run build

Credentials

Create a credential named Waappa API.

Fields:

• API Key: your Waappa session API key.
• Session ID: your Waappa session name, for example default.
• Base URL: Waappa API base URL including /api.

Default base URL:

https://api.waappa.com/api

The credential sends the API key as the Authorization header.

The credential test checks the configured session by calling:

GET {baseUrl}/sessions/{session}

Waappa Node

The Waappa action node supports the selected Waappa API operations below.

Messages

• Send Text
• Send Image
• Send Video
• Send Audio (Voice)
• Send Document
• Send Contact VCard
• Send Location
• Send Poll
• Send List
• Edit Message
• Delete Message

Contact cards can be sent in two modes:

• Contact Fields: full name, organization, phone number, WhatsApp ID.
• Raw VCard: direct vCard string.

Media

• Upload File
• Download Media

Upload File accepts an n8n binary property, defaulting to data.

Download Media stores message media in Waappa temporary media storage through:

POST /api/media/download
{"message_id":"message-id"}

Groups

• Get All Groups
• Create Group
• Add Participants
• Get Group Participants

Contacts

• Get All Contacts

LID / Phone

• Get Phone from LID
• Get LID from Phone

Waappa Trigger

The Waappa Trigger node receives incoming webhook events from Waappa.

Outputs:

• Incoming Messages
• All Messages
• Message Status
• Other Events

Trigger options:

• Automatic production webhook registration and authentication.
• Local event filtering by Waappa event name.

For automatic-only production setup:

1. Select the shared Waappa API credential in Waappa Trigger.
2. Open Waappa Webhook Setup.
3. Configure the webhook in Waappa: select the session, choose the events, set any ignore options, and save.
4. Activate the n8n workflow. n8n automatically registers its production URL and a generated secret with Waappa.
5. Send a test webhook from Waappa and inspect the production execution history in n8n.

Automatic setup does not place the webhook URL or secret in a browser query string.
The secret is derived from the encrypted n8n credential and registration ID, while
Waappa stores it only as encrypted ciphertext.
Deactivating the workflow removes the destination only if that exact registration still
owns it. Automatic setup intentionally does not replace a different session URL unless
Replace Existing Session Webhook is enabled in n8n.
Deactivation retains the saved event and ignore preferences, so reactivating the
workflow reuses them.

Waappa stores one webhook URL per session. This setup does not create a separate
connected-app record, and changing the session URL replaces the existing destination.

Human Approval

Select Human Approval > Send Approval and Wait in the Waappa action node.
The node sends a WhatsApp decision request and pauses the n8n execution until Waappa
resumes its signed waiting webhook.

• HITL uses a WhatsApp list with opaque row IDs for explicit Accept and Reject actions.
• Only the configured reviewer chat can decide.
• The first valid decision wins; later list responses are ignored for HITL.
• Expired approvals resume the workflow with an expired decision.
• Accepted and rejected decisions resume through the main output with approvalId,
  status, decision, approved, reviewer, response time, and metadata.
• Add an IF or Switch node after Waappa and route on approved or status.

HITL consumes only matching message list responses internally. Poll messages and
poll.vote events remain ordinary Waappa functionality and continue through normal
webhook forwarding when selected in the session event list.

Common Usage

Send a Text Message

1. Add the Waappa node.
2. Select Messages.
3. Select Send Text.
4. Enter a WhatsApp chat ID, for example:

919876543210@c.us

5. Enter the message text.

Upload and Send Media

1. Use an n8n node that outputs binary data.
2. Add the Waappa node.
3. Select Media > Upload File.
4. Set Binary Property to the binary field name, usually data.
5. Use the returned URL in Messages > Send Image, Send Video, Send Audio, or Send Document.

Development

npm install
npm run build
npm run lint

Publishing

npm run build
npm publish

Before publishing, test credentials, at least one send message operation, media upload, and the trigger webhook in a real n8n workflow.

License

MIT