n8n-nodes-wasapress

This is an n8n community node that lets you use Wasapress Wordpress Plugin for your WhatsApp Marketing in your n8n workflows.

Wasapress is a WordPress plugin for WhatsApp marketing automation. This package provides both action and trigger nodes, allowing you to send messages, media, validate WhatsApp numbers, and receive incoming messages directly in n8n.

n8n is a fair-code licensed workflow automation platform.

Nodes Included

• WasaPress - Action node for sending messages and media
• WasaPress Trigger - Webhook trigger for receiving incoming WhatsApp messages

Installation

Follow the installation guide in the n8n community nodes documentation.

Community Nodes (Recommended)

1. Go to Settings > Community Nodes in n8n
2. Select Install
3. Enter n8n-nodes-wasapress in the npm Package Name field
4. Click Install

Manual Installation

npm install n8n-nodes-wasapress

Credentials

To use this node, you need to configure your WasaPress API credentials:

1. Base URL - Your WasaPress server URL (default: https://server.wasapress.com)
2. Secret Key - Your WasaPress API secret key (format: wsk-...)
3. API Key - Your WasaPress API key (used as ID in all requests)

You can get your API credentials from your WasaPress WordPress plugin settings.

Note: The API Key is configured once in the credentials and automatically used in all operations, so you don't need to enter it repeatedly.

WasaPress Trigger Node

The WasaPress Trigger node starts your workflow when incoming WhatsApp messages are received.

Setup

1. Add the WasaPress Trigger node to your workflow
2. Configure your Wasapress API credentials
3. Copy the webhook URL from the node
4. Configure your Wasapress WordPress plugin to send webhooks to this URL
5. Activate the workflow

Trigger Features

Number Filtering

• No Filter - Accept messages from all numbers
• Only From Number - Only trigger for messages from a specific number
• Exclude Number - Accept all messages except from a specific number

Keyword Filtering

• No Keyword Filter - Accept all messages
• Contains Keyword - Message must contain the keyword (e.g., "help me" contains "help")
• Exact Match - Message must exactly match the keyword

Time-based Filter

• Set business hours (e.g., 09:00 to 17:00)
• Configure timezone (e.g., Asia/Kuala_Lumpur)
• Only trigger during specified hours

Additional Options

• Trigger Once Per Number - Only trigger once per phone number (resets on workflow restart)
• Extract Phone Number - Automatically extracts clean phone number from webhook data

Webhook Payload

The trigger receives webhook data with the following structure:

{
  "whatsapp_number": "[email protected]",
  "display_name": "John Doe",
  "message": "Hello",
  "phone_number": "60123456789"
}

The phone_number field is automatically added when "Extract Phone Number" is enabled.

WasaPress Action Node

The WasaPress action node supports the following operations:

Send Audio (MP3)

Send an MP3 audio file to a WhatsApp number.

Required Fields:

• ID - Your API key
• Number - WhatsApp number (with country code, no + or spaces)
• File URL - URL of the MP3 audio file

Optional Fields:

• Pin Time - Time to pin the message in seconds (default: 7)
• View Once - Whether the audio can only be viewed once (default: false)

Send Audio (PTT)

Send a voice message (Push-to-Talk format) to a WhatsApp number.

Required Fields:

• ID - Your API key
• Number - WhatsApp number (with country code, no + or spaces)
• File URL - URL of the audio file (PTT/voice message format, typically .opus)

Optional Fields:

• Pin Time - Time to pin the message in seconds (default: 7)
• View Once - Whether the audio can only be viewed once (default: false)

Send Contact

Share a contact card to a WhatsApp number.

Required Fields:

• ID - Your API key
• Number - WhatsApp number to send to (with country code, no + or spaces)
• Contact Name - Name of the contact to share
• Contact Number - Phone number of the contact (with country code, no + or spaces)

Optional Fields:

• Pin Time - Time to pin the message in seconds (default: 7)

Send Document

Send a document file (PDF, DOC, etc.) to a WhatsApp number.

Required Fields:

• ID - Your API key
• Number - WhatsApp number (with country code, no + or spaces)
• File URL - URL of the document file

Optional Fields:

• Caption - Caption for the document
• Filename - Filename to display
• Pin Time - Time to pin the message in seconds (default: 7)

Send Image

Send an image to a WhatsApp number.

Required Fields:

• ID - Your API key
• Number - WhatsApp number (with country code, no + or spaces)
• File URL - URL of the image file

Optional Fields:

• Caption - Caption for the image
• Pin Time - Time to pin the message in seconds (default: 7)
• View Once - Whether the image can only be viewed once (default: false)

Send Location

Share a GPS location to a WhatsApp number.

Required Fields:

• ID - Your API key
• Number - WhatsApp number (with country code, no + or spaces)
• Location Name - Name of the location
• Latitude - Latitude coordinate (e.g., "40.7128")
• Longitude - Longitude coordinate (e.g., "-74.0060")

Optional Fields:

• Pin Time - Time to pin the message in seconds (default: 7)

Send Message

Send a text message to a WhatsApp number.

Required Fields:

• Number - WhatsApp number (with country code, no + or spaces)
• Message - The text message to send

Optional Fields:

• Pin Time - Time to pin the message in seconds (default: 7)

Send Video

Send a video with caption to a WhatsApp number.

Required Fields:

• ID - Your API key
• Number - WhatsApp number (with country code, no + or spaces)
• File URL - URL of the video file

Optional Fields:

• Caption - Caption for the video
• Pin Time - Time to pin the message in seconds (default: 7)
• View Once - Whether the video can only be viewed once (default: true)

Send Video Note

Send a video note (without caption) to a WhatsApp number.

Required Fields:

• ID - Your API key
• Number - WhatsApp number (with country code, no + or spaces)
• File URL - URL of the video file

Optional Fields:

• Pin Time - Time to pin the message in seconds (default: 7)

Validate

Validate a WhatsApp number.

Required Fields:

• ID - The ID to validate
• Number - WhatsApp number to validate (with country code, no + or spaces)

Usage Examples

Example 1: Auto-Reply to Incoming Messages

1. Add a Wasapress Trigger node
2. Set keyword filter to "Contains Keyword" with keyword "help"
3. Add a Wasapress action node
4. Select Send Message operation
5. Use {{$json.phone_number}} for the Number field
6. Type your reply message
7. Activate the workflow

Now whenever someone sends a message containing "help", they'll automatically receive your reply.

Example 2: Business Hours Auto-Responder

1. Add a Wasapress Trigger node
2. Enable Time-based Filter
3. Set Start Time: 09:00, End Time: 17:00
4. Set your timezone
5. Add an IF node to check if message is outside business hours
6. Add a Wasapress node to send "We're closed" message
7. Activate the workflow

Example 3: Send a Simple Text Message

1. Configure your WasaPress credentials (including API Key)
2. Add the WasaPress node to your workflow
3. Select Send Message operation
4. Enter the recipient's WhatsApp number (e.g., 60123456789)
5. Type your message in the Message field
6. Execute the node

Example 4: Send an Image with Caption

1. Add the Wasapress node to your workflow
2. Select Send Image operation
3. Enter your API key in the ID field
4. Enter the recipient's WhatsApp number
5. Enter the image URL in the File URL field
6. Add a caption in the Caption field
7. Execute the node

Example 5: Validate a Number Before Sending

1. Add a Wasapress node and select Validate operation
2. Enter your API key and the number to validate
3. Add an IF node to check the response status code
4. If valid (status code 200), add another Wasapress node to send your message
5. If invalid (status code 422), handle the error appropriately

Response Format

All operations return a response with the following structure:

{
  "statusCode": 200,
  "message": "Success message from API",
  // ... other response data from Wasapress API
}

Status Codes:

• 200 - Success
• 422 - Validation error (e.g., invalid WhatsApp number)
• 4xx/5xx - Other errors

The node handles errors gracefully and includes the status code in the response, so you can use IF nodes to handle different scenarios.

Phone Number Format

All phone numbers must be in international format:

• ✅ Include country code
• ✅ No spaces, dashes, or special characters
• ✅ No plus (+) sign

Examples:

• ✅ 60123456789 (Malaysia)
• ✅ 14155552671 (USA)
• ✅ 447700900123 (UK)
• ❌ +60123456789 (has + sign)
• ❌ 0123456789 (missing country code)
• ❌ 60 123 456 789 (has spaces)

Compatibility

• Minimum n8n version: 0.200.0
• Tested with n8n version: 1.0.0+

Resources

• n8n community nodes documentation
• Wasapress Website
• Wasapress Documentation

License

MIT