WhatsApp

​

Capabilities

​

Requirements

• Meta Business account
• WhatsApp Business app verified
• A phone number (not already on WhatsApp personal)
• Business verification for scaling

​

Setup

WHATSAPP_PHONE_NUMBER_ID=1234567890
WHATSAPP_BUSINESS_ACCOUNT_ID=0987654321
WHATSAPP_ACCESS_TOKEN=EAABwzLixnjYBO...
WHATSAPP_WEBHOOK_VERIFY_TOKEN=my-verify-token

​

Environment Variables

​

Configuration Example

WHATSAPP_PHONE_NUMBER_ID=1234567890
WHATSAPP_BUSINESS_ACCOUNT_ID=0987654321
WHATSAPP_ACCESS_TOKEN=EAABwzLixnjYBO...
WHATSAPP_WEBHOOK_VERIFY_TOKEN=my-custom-verify-token

chat:
  whatsapp:
    phone_number_id: "${WHATSAPP_PHONE_NUMBER_ID}"
    business_account_id: "${WHATSAPP_BUSINESS_ACCOUNT_ID}"
    access_token: "${WHATSAPP_ACCESS_TOKEN}"
    webhook_verify_token: "${WHATSAPP_WEBHOOK_VERIFY_TOKEN}"

​

Message Format

{
  "messaging_product": "whatsapp",
  "to": "+1234567890",
  "type": "interactive",
  "interactive": {
    "type": "button",
    "body": { "text": "Please confirm:" },
    "action": {
      "buttons": [
        { "type": "reply", "reply": { "id": "yes", "title": "Confirm" } }
      ]
    }
  }
}

​

Notes

• WhatsApp API requires a public webhook URL with HTTPS.
• Messages to users require them to initiate contact first (24-hour messaging window).
• Outside the 24-hour window, you must use pre-approved message templates.
• Business verification required to message more than 250 unique users per day.
• A permanent access token from a system user is recommended for production.

​

Related

• WhatsApp Bot Guide - Step-by-step setup with Meta developer portal
• Chat Providers Overview - Compare all 27 supported channels
• Telegram - Simpler bot setup without business verification
• profclaw channels - Enable and test the WhatsApp connection from the CLI