n8n-nodes-bahalap

This is an n8n community node that allows you to integrate Bahalap WhatsApp Gateway with your n8n workflows.

n8n is a fair-code licensed workflow automation platform.

Bahalap is a WhatsApp Gateway service that allows you to send and receive WhatsApp messages programmatically.

Installation

Follow the installation guide in the n8n community nodes documentation.

Community Nodes Installation

1. Go to Settings > Community Nodes
2. Select Install
3. Enter n8n-nodes-bahalap in Enter npm package name
4. Agree to the risks of using community nodes
5. Select Install

Manual Installation

To install manually:

npm install n8n-nodes-bahalap

After installing the node, restart n8n to register it.

Credentials

You need the following credentials to use this node:

• API URL: Your Bahalap API base URL (default: https://api.bahalap.com)
• Device Token: Your device token from Bahalap
• User ID: Your user ID from Bahalap

Nodes

This package includes two nodes:

1. Bahalap Node

The Bahalap node allows you to perform actions with the Bahalap API:

Message Operations

• Send Text: Send a text message to a phone number
• Send File: Send a file with optional caption using a file URL

Device Operations

• Get Status: Get the connection status of your device
• Get QR Code: Get the QR code for device initialization
• Initialize: Initialize a new device connection
• Logout: Logout and disconnect the device

Group Operations

• Get Groups: Get all WhatsApp groups
• Get Group Info: Get information about a specific group
• Send Message: Send a message to a WhatsApp group

2. Bahalap Trigger Node

The Bahalap Trigger node starts a workflow when specific events occur:

Supported Events

• Message: Triggered when a new message is received
• Connection Update: Triggered when connection status changes
• QR Code: Triggered when a QR code is generated
• Group Update: Triggered on group updates

Options

• Download Media: Automatically download media files from messages
• Only From Me: Only process messages sent by your device
• Only To Me: Only process messages received by your device (default)
• Filter Phone Numbers: Comma-separated list of phone numbers to filter
• Filter Groups: Comma-separated list of group IDs to filter

Usage

Example: Send a WhatsApp Message

1. Add the Bahalap node to your workflow
2. Configure your credentials
3. Select Message as the resource
4. Select Send Text as the operation
5. Enter the phone number (format: 628123456789)
6. Enter your message text

Example: Receive WhatsApp Messages

1. Add the Bahalap Trigger node to your workflow
2. Configure your credentials
3. Select the events you want to listen to (e.g., "Message")
4. Configure any filters or options
5. Activate the workflow
6. Copy the webhook URL provided by n8n
7. Configure the webhook in your Bahalap server (see WEBHOOK_IMPLEMENTATION.md)

Example: Send to Group

1. Add the Bahalap node to your workflow
2. Configure your credentials
3. Select Group as the resource
4. Select Send Message as the operation
5. Enter the group ID (format: 123456789@g.us)
6. Enter your message text

Webhook Setup

To receive incoming messages and events, you need to configure webhooks in your Bahalap server.

See WEBHOOK_IMPLEMENTATION.md for detailed implementation instructions.

API Endpoints

The node uses the following Bahalap API endpoints:

Messages

• POST /send - Send message or file
• POST /send/group - Send message to group

Devices

• GET /device/status - Get device status
• GET /device/qr - Get QR code
• POST /device/init - Initialize device
• POST /device/logout - Logout device

Groups

• GET /groups - Get all groups
• GET /group/info - Get group information

Resources

• n8n community nodes documentation
• Bahalap API Documentation

Version history

1.0.0

• Initial release
• Support for sending text messages and files
• Support for device management
• Support for group operations
• Webhook trigger for incoming messages and events

License

MIT