WhatsApp Node

Send messages via WhatsApp Cloud API (Meta).

Setup

  1. Go to developers.facebook.com
  2. Create or open a WhatsApp app
  3. Go to WhatsApp → API Setup
  4. Copy your Access Token and Phone Number ID
  5. Add a WHATSAPP credential in Nodebase

Credential Format

json
{
  "accessToken": "EAABx...",
  "phoneNumberId": "1234567890"
}

Phone Number Format

Always use E.164 format: +91XXXXXXXXXX

Incorrect: 9876543210
Correct: +919876543210

Operations

Send Text Message

  • To: +91XXXXXXXXXX (supports {{variables}})
  • Body: Your message text (supports {{variables}})

Send Template Message

  • To: recipient number
  • Template Name: your approved template name
  • Language Code: en_US, en, hi, etc.
  • Parameters: JSON array of parameter values

Send Image

  • To: recipient number
  • Image URL: publicly accessible image URL
  • Caption: optional caption text

Send Document

  • To: recipient number
  • Document URL: publicly accessible file URL
  • Filename: shown to recipient
  • Caption: optional

Send Reaction

  • To: recipient number
  • Message ID: ID of message to react to
  • Emoji: single emoji character

Output

json
{
  "whatsapp": {
    "messageId": "wamid.xxx",
    "to": "+919876543210",
    "status": "sent",
    "timestamp": "2024-01-15T10:30:00.000Z"
  }
}

Rate Limits

Meta enforces rate limits per phone number.

Free tier: 1,000 conversations/month per phone number.
AI Nodes OverviewSlack