n8n-nodes-rapiwa

Official Rapiwa integration for n8n
Send and verify WhatsApp messages, and receive incoming webhooks — all powered by the Rapiwa.

---

📑 Table of Contents

• Overview
• Features
• Installation
• Credentials Setup
• Common Use Cases
• Node Operations
  • Send WhatsApp Message
  • Verify WhatsApp Number
• Trigger: Incoming Webhooks
• Support
• License
• Resources
• Running Locally

---

Overview

Rapiwa Node for n8n allows you to integrate the Rapiwa API directly into your n8n workflows.

You can:

• Send automated WhatsApp messages (text, image, video, document)
• Verify whether a number is active on WhatsApp
• Trigger workflows from incoming Rapiwa webhooks

This package follows the official n8n custom node development standards.

---

Features

• Send WhatsApp Messages — Send text or media messages directly via the Rapiwa API.
• Verify Numbers — Check if a given phone number is active on WhatsApp.
• Incoming Webhooks — Trigger n8n workflows when messages arrive.
• Secure Authentication — Uses your Rapiwa API Key with Bearer Token.
• Error Handling — Follows n8n’s native error behavior and continueOnFail() support.

---

Installation

Follow the installation guide in the n8n community nodes documentation.

To install this node in your n8n environment:

From npm:

npm install n8n-nodes-rapiwa

Credentials Setup

Before using the node, you must configure your Rapiwa API Key:

1. In n8n, navigate to Credentials → New → Rapiwa API.
2. Enter your API key (found in your Rapiwa Dashboard )
3. Click Test — it should verify successfully.

Note: Keep your API key secure and never share it publicly.

---

Common Use Cases

• Smart Support Automation: Instantly respond to customers, automate FAQs, and collect feedback via WhatsApp.
• Instant Business Alerts: Send real-time updates, reminders, and critical notifications directly to users.
• AI Chat Assistants: Handle inquiries, returns, and support 24/7 with AI-driven bots.
• Lead Nurturing: Automate personalized follow-ups and turn prospects into customers seamlessly.
• E-Commerce Updates: Send order, shipping, and delivery alerts to boost customer engagement.
• Analytics & Insights: Sync WhatsApp data with your CRM for real-time performance tracking.

---

Node Operations

1. Send WhatsApp Message

Send WhatsApp messages to your users directly from n8n.

Fields:

• Number → Recipient’s number (e.g. 88017XXXXXXXX)
• Product Operation → Choose between Welcome Message or Promotional Offer
• Message Type → Text, Image, Video, or Document
• Message → Text body or caption (for media)
• Media URL → Public link for the media file

Example use case:

• Triggered when a new order is placed
• Sends a WhatsApp confirmation message to the customer

For detailed documentation, visit Rapiwa Integration with n8n

2. Verify WhatsApp Number

Check if a given number is registered on WhatsApp before sending messages.

Fields:

• Number → Recipient’s number (e.g. 88017XXXXXXXX)

The node will return:

• exists: true/false
• jid (WhatsApp unique ID)
• message (response description)

Example use case:

• Validate WhatsApp numbers before sending campaigns
• Clean your contact list automatically

For detailed documentation, visit Rapiwa Integration with n8n

---

Trigger: Incoming Webhooks

Rapiwa Trigger: Incoming Webhooks allows you to receive incoming WhatsApp messages directly into n8n workflows.

Use this to:

• Build chatbots
• Capture inbound messages for automation
• Log WhatsApp replies in databases or CRMs

---

Support

For technical support and assistance:

• Email Support: Contact our dedicated support team
• Implementation Help: Get expert assistance with workflows

For enterprise-level support or custom solutions, contact our solution engineers at support@rapiwa.com

---

License

MIT

---

Resources

• Rapiwa Website
• n8n Documentation
• Rapiwa n8n Overview

---

Running Locally

To run and test this node on your local machine:

1. Clone the repository

   git clone https://github.com/rapiwa/n8n-nodes-rapiwa
   cd n8n-nodes-rapiwa
   

2. Install dependencies

   npm install
   

3. Build the project

   npm run build
   

4. Run Tests:

   npm run test
   

   Note: Unit tests are included to ensure code quality. Please run tests before submitting a pull request.

5. Install the node into your local n8n instance:

   npm link n8n-nodes-rapiwa
   

6. Start n8n:

   n8n start
   

7. Test your node

   • Open n8n in your browser (usually at http://localhost:5678)
   • Create a workflow and add your custom node to test its functionality

Note: Make sure you have Node.js and pnpm installed on your machine.

---

Reporting Issues

• If you find a bug or have a feature request, please open an issue with details and steps to reproduce.

Code of Conduct

• Please be respectful and follow our Code of Conduct when participating in this project.