Documentation

@Multiculous/n8n-nodes-whatsapp

This is a n8n community node.
It lets you use WAHA - WhatsApp HTTP API in your n8n workflows.

šŸ†• New in Version 2025.2.18

This version includes separate trigger nodes for different WhatsApp events, providing better organization and performance:

Available Trigger Nodes

  1. WhatsApp Trigger (Original) - Handles all events in one node
  2. WhatsApp Message Trigger - Dedicated to message events
  3. WhatsApp Session Trigger - Handles session status changes
  4. WhatsApp Call Trigger - Manages call-related events
  5. WhatsApp Group Trigger - Handles group events
  6. WhatsApp Presence Trigger - Manages presence/status events
  7. WhatsApp Chat Trigger - Handles chat management events

Benefits of Separate Triggers

  • Better Organization: Each workflow focuses on specific event types
  • Improved Performance: Only relevant events trigger each workflow
  • Easier Debugging: Clear separation of concerns
  • Cleaner Workflows: More focused and maintainable automation

šŸ‘‰ Generated from
WAHA OpenAPI
using devlikeapro/n8n-openapi-node

NPM Version

WAHA Workflow Example Screenshot

Install WAHA n8n node

Go to your n8n => Settings => Community nodes and install:

@Multiculous/n8n-nodes-whatsapp

If you need help with that, check the
Install community nodes

Links

Workflow Examples

šŸ‘‰ Check out n8n-workflows folder for examples.

šŸš€ Quick Start with Separate Triggers

Installation

npm install @umairabubakkar/n8n-nodes-whatsapp

Usage Examples

For Message Handling

Use WhatsApp Message Trigger instead of the combined trigger:

  • Select specific message events (message, message.any, message.reaction, message.revoked)
  • Get a dedicated webhook URL for message events
  • Cleaner workflow focused only on messages

For Session Monitoring

Use WhatsApp Session Trigger:

  • Monitor connection status changes
  • Handle authentication events
  • Separate webhook URL for session events

For Call Management

Use WhatsApp Call Trigger:

  • Handle incoming calls
  • Track call acceptance/rejection
  • Dedicated call event processing

Migration from Combined Trigger

If you're using the original WhatsApp Trigger:

  1. Identify Event Types: Check which events your workflows use
  2. Choose Appropriate Trigger: Replace with the specific trigger node
  3. Update Webhook URLs: Configure your WhatsApp instance with new URLs
  4. Test Workflows: Ensure proper functionality

Webhook Configuration

Configure your WAHA instance to send different events to different endpoints:

Message events → WhatsApp Message Trigger webhook URL
Session events → WhatsApp Session Trigger webhook URL  
Call events → WhatsApp Call Trigger webhook URL
Group events → WhatsApp Group Trigger webhook URL
Presence events → WhatsApp Presence Trigger webhook URL
Chat events → WhatsApp Chat Trigger webhook URL

This approach provides better resource utilization and clearer workflow organization.

Discussion