Description
n8n-nodes-chatery-whatsapp
!Chatery
!n8n.io – Workflow Automation
This is an n8n community node for integrating with Chatery WhatsApp API. It allows you to automate WhatsApp messaging, manage sessions, retrieve chat history, and handle groups directly from your n8n workflows.
n8n is a fair-code licensed workflow automation platform.
Table of Contents
- Installation
- Credentials
- Nodes
- Resources & Operations
- Compatibility
- Usage Examples
- License
– Chatery WhatsApp Trigger
– Chatery WhatsApp
Installation
Follow the installation guide in the n8n community nodes documentation.
npm Installation
npm install n8n-nodes-chatery-whatsapp
Manual Installation
1. Go to Settings > Community Nodes
2. Select Install
3. Enter n8n-nodes-chatery-whatsapp in the Enter npm package name field
4. Agree to the risks of using community nodes
5. Click Install
Credentials
To use this node, you need to configure the Chatery API credentials:
| Field | Description |
|——-|————-|
| URL | Your Chatery WhatsApp API host URL (e.g., https://api.chatery.io) |
| API Key | Your API key for authentication (optional, depending on your setup) |
Nodes
This package includes two nodes:
Chatery WhatsApp Trigger
A webhook trigger node that listens for WhatsApp events from the Chatery API.
Supported Events:
| Event | Description |
|——-|————-|
| all | Listen to all events |
| qr | QR code generated for authentication |
| connection.update | Connection status changed (connected, disconnected) |
| message | New message received |
| message.sent | Message sent confirmation |
| message.update | Message status update (read, delivered) |
| message.reaction | Message reaction added |
| message.revoke | Message deleted/revoked |
| presence.update | Typing, online status |
| group.participants | Group members changed |
| group.update | Group info changed |
| chat.update | Chat updated |
| chat.upsert | New chat created |
| chat.delete | Chat deleted |
| contact.update | Contact updated |
| call | Incoming call |
| labels | Labels updated (business) |
| logged.out | Session logged out |
Options:
Chatery WhatsApp
The main node for performing WhatsApp operations via HTTP requests.
Resources & Operations
Bulk Resource (NEW!)
Send messages to multiple recipients with background processing.
| Operation | Description |
|———–|————-|
| Send Bulk Text | Send a text message to multiple recipients |
| Send Bulk Image | Send an image to multiple recipients |
| Send Bulk Document | Send a document to multiple recipients |
| Get Job Status | Get status of a bulk messaging job |
| Get All Jobs | Get all bulk messaging jobs |
Chat Resource
| Operation | Description |
|———–|————-|
| Send Text | Send a text message (supports replyTo) |
| Send Image | Send an image with optional caption (supports replyTo) |
| Send Document | Send a document/file (supports replyTo) |
| Send Location | Send a location with coordinates (supports replyTo) |
| Send Contact | Send a contact card (supports replyTo) |
| Send Button | Send a message with buttons (supports replyTo) |
| Send Presence Update | Update your presence status |
| Check Number | Check if a number is registered on WhatsApp |
| Profile Picture | Get a contact’s profile picture URL |
| Contact Info | Get detailed information about a contact |
> NEW: All send operations now support replyTo parameter to reply/quote specific messages!
Session Resource
| Operation | Description |
|———–|————-|
| List | List all available sessions |
| Connect | Connect/start a new session |
| Status | Get the status of a session |
| Update Config | Update session configuration |
| Add Webhook | Add a webhook URL to receive events |
| Remove Webhook | Remove a webhook from the session |
| QR Code | Get QR code as text for authentication |
| QR Image | Get QR code as image for authentication |
| Delete | Delete/terminate a session |
History Resource
| Operation | Description |
|———–|————-|
| Overview | Get an overview of all chats |
| Contacts | Get list of all contacts |
| Messages | Get messages from a specific chat |
| Info | Get detailed information about a chat |
| Mark Read | Mark messages in a chat as read |
Group Resource
| Operation | Description |
|———–|————-|
| List | List all groups you’re a member of |
| Create | Create a new group |
| Metadata | Get group metadata/information |
| Add Participants | Add participants to a group |
| Remove Participants | Remove participants from a group |
| Promote Participants | Promote participants to admin |
| Demote Participants | Demote admins to regular participants |
| Update Subject | Update group name/subject |
| Update Description | Update group description |
| Update Picture | Update group picture |
| Leave | Leave a group |
| Get Invite Code | Get group invite code |
| Revoke Invite | Revoke and generate new invite code |
| Update Settings | Set who can send messages or edit group info |
| Join | Join a group using invite code |
Compatibility
Usage Examples
Example 1: Auto-reply to Messages
1. Add Chatery WhatsApp Trigger node with message event
2. Add Chatery WhatsApp node with Send Text operation
3. Connect the trigger to the send node
4. Map the incoming chat ID to the recipient
Example 2: Send Bulk Notifications
1. Use any trigger (e.g., Webhook, Schedule)
2. Add Chatery WhatsApp node
3. Select Bulk resource and Send Bulk Text operation
4. Enter comma-separated phone numbers and your message
5. Track job status using Get Job Status operation
Example 3: Reply to Specific Message
1. Capture the message ID from incoming webhook
2. Use Chat resource with Send Text operation
3. Set the replyTo parameter with the message ID
Example 4: Session Management
1. Use Chatery WhatsApp node
2. Select Session resource
3. Use Connect to start a new session
4. Use QR Image to get the QR code for scanning
5. Use Status to check connection status
Development
Build
npm run build
Lint
npm run lint
Run Tests
npm run test
Resources
Author
Fajri Rinaldi Chan (Farin Chan)
Support
If you find this project helpful, consider supporting the development:
