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:

• Optional header authentication.
• Event filtering by Waappa event name.

Use the trigger webhook URL as the webhook URL in your Waappa session configuration.

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:

[email protected]

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