Skip to main content

​
Overview

Connect profClaw to WhatsApp Business API to interact with your AI agent from your phone. Send text messages, images, and documents for AI processing.

​
Prerequisites

  • profClaw running (mini or pro mode)
  • Meta Business account
  • WhatsApp Business API access

​
Step 1: Meta Business Setup

1

Create Meta App

Go to developers.facebook.com, create a new app, and select Business type.
2

Add WhatsApp Product

In your app dashboard, add the WhatsApp product and complete the setup wizard.
3

Get Credentials

From the WhatsApp settings, note:
  • Phone Number ID
  • Access Token (permanent token recommended)
  • Verify Token (you create this)
4

Configure Webhook

Set the webhook URL to:
https://your-profclaw.com/api/chat/whatsapp/webhook
Subscribe to messages events.

​
Step 2: Configure profClaw

export WHATSAPP_ACCESS_TOKEN=your-access-token
export WHATSAPP_PHONE_NUMBER_ID=your-phone-number-id
export WHATSAPP_VERIFY_TOKEN=your-verify-token

chat:
  channels:
    whatsapp:
      enabled: true
      accessToken: ${WHATSAPP_ACCESS_TOKEN}
      phoneNumberId: ${WHATSAPP_PHONE_NUMBER_ID}
      verifyToken: ${WHATSAPP_VERIFY_TOKEN}

​
Step 3: Test

Send a message to your WhatsApp Business number: 
You: What's the weather like?
profClaw: I can help with that! Let me search for current weather information...

​
Features

FeatureSupported
Text messagesYes
Image analysisYes (with vision-capable model)
Document processingYes
Voice messagesPlanned
Location sharingPlanned
Group chatsYes (pro mode)

​
Message Format

profClaw formats responses for WhatsApp’s constraints:
  • Messages longer than 4096 characters are split
  • Code blocks use monospace formatting
  • Tables are converted to readable lists
  • Links are preserved as clickable URLs

​
Security

WhatsApp messages are processed through Meta’s servers. Do not send sensitive credentials or secrets via WhatsApp chat. Use the web UI or CLI for sensitive operations.
Restrict which phone numbers can interact: 
chat:
  channels:
    whatsapp:
      allowedNumbers:
        - "+1234567890"
        - "+0987654321"