whatsapp-pro

Advanced WhatsApp Business API node for n8n with interactive messages, buttons, lists, catalogs and flows

Package Information

Downloads: 25 weekly / 395 monthly
Latest Version: 2.1.0
Author: LatamFlows

Available Nodes

WhatsApp Pro icon
WhatsApp Pro
Advanced WhatsApp Business API with interactive messages, buttons, lists and catalogs

Documentation

n8n-nodes-whatsapp-pro

Advanced WhatsApp Business API node for n8n with interactive messages, buttons, lists, catalogs and flows.

Features

🚀 What this node does that the official doesn't:

Feature Official Node WhatsApp Pro
Interactive Buttons (Quick Reply) ❌ ✅ Up to 3 buttons
List Messages ❌ ✅ Up to 10 options
CTA Buttons (URL/Phone) ❌ ✅
Location Request ❌ ✅
Product Messages ❌ ✅ Single & Multi
Catalog Integration ❌ ✅
Template Management Limited ✅ Full CRUD
Reactions ❌ ✅
Contact Cards ❌ ✅

Installation

Community Nodes (Recommended)

  1. Go to Settings > Community Nodes
  2. Select Install
  3. Enter n8n-nodes-whatsapp-pro
  4. Select Install

Manual Installation

cd ~/.n8n/nodes
npm install n8n-nodes-whatsapp-pro

Credentials Setup

  1. Go to Meta for Developers
  2. Create or select your app
  3. Add WhatsApp product
  4. Get your:
    • Access Token (permanent token recommended)
    • Phone Number ID
    • Business Account ID

Operations

Message

  • Send Text - Send text messages with URL preview option
  • Send Location - Send location with coordinates
  • Send Contact - Send contact cards with name, phone, email, and organization
  • React - React to messages with emoji

Interactive

  • Send Buttons - Quick reply buttons (up to 3)
  • Send List - List message with sections (up to 10 items total)
  • Send CTA Button - Call-to-action (URL or Phone call)
  • Request Location - Ask user for their location

Template

  • Send Template - Send approved template with variables
  • List Templates - Get all templates
  • Get Template - Get specific template
  • Delete Template - Delete a template

Media

  • Send Image - Send images (URL or Media ID)
  • Send Video - Send videos
  • Send Document - Send documents with filename
  • Send Audio - Send audio files
  • Send Sticker - Send stickers

Catalog

  • Send Product - Single product message
  • Send Product List - Multi-product message (up to 30)
  • Get Catalog - Get catalog information

WhatsApp API Limits

Element Limit
Buttons per message 3
Button title 20 characters
List sections 10
List items (total) 10
List item title 24 characters
List item description 72 characters
Header text 60 characters
Footer text 60 characters
Body text 1024 characters

Examples

Send Interactive Buttons

{
  "to": "56912345678",
  "bodyText": "How can we help you?",
  "buttons": [
    { "id": "sales", "title": "Sales" },
    { "id": "support", "title": "Support" },
    { "id": "info", "title": "More Info" }
  ]
}

Send List Message

{
  "to": "56912345678",
  "bodyText": "Select an option:",
  "buttonText": "View Options",
  "sections": [
    {
      "title": "Products",
      "items": [
        { "id": "p1", "title": "Product A", "description": "Description A" },
        { "id": "p2", "title": "Product B", "description": "Description B" }
      ]
    }
  ]
}

Send Contact Card

{
  "to": "56912345678",
  "contactFirstName": "John",
  "contactLastName": "Doe",
  "contactPhone": "+1234567890",
  "contactEmail": "john@example.com",
  "contactOrg": "Acme Inc"
}

Validation & Error Handling

The node includes built-in validation for:

  • Maximum button count (3)
  • Maximum sections (10)
  • Maximum total list items (10)
  • Character limits for all text fields
  • Required field validation
  • WhatsApp API error code handling

Testing

npm test           # Run all tests
npm run test:watch # Watch mode
npm run test:coverage # With coverage report

Roadmap

  • WhatsApp Flows
  • Carousel Messages
  • Authentication OTP Templates
  • Coupon Templates
  • Read Receipts Webhook

Changelog

v2.1.0

  • Added Send Contact operation with full contact card support
  • Added comprehensive validation for all WhatsApp API limits
  • Added detailed error messages for WhatsApp API errors
  • Added Jest test suite with 50+ tests
  • Improved documentation with API limits table

v2.0.0

  • Initial release with interactive messages support

License

MIT

Author

LatamFlows - manu@latamflows.com

Made with ❤️ for the n8n community

Discussion