Integrate your bot to WhatsApp

You bring your own Meta app and phone number; each bot connects independently, so many businesses can run on the same platform. Before you start, make sure you have:

• A Meta (Facebook) Business account.
• A phone number dedicated to WhatsApp Business, not already active on a personal WhatsApp or the WhatsApp Business app, able to receive an SMS or call to verify.
• A Claude API key saved in Settings, and your bot set to active with a knowledge base.

Step 1: Create a Meta app and WhatsApp number

1. Go to developers.facebook.com and create an app of type Business.
2. Add the WhatsApp product to the app.
3. Under WhatsApp → API Setup, add your business phone number and verify it via SMS or call.

Step 2: Collect your credentials

From the Meta dashboard, gather:

• Phone Number ID — the numeric ID shown next to your number (not the phone number itself).
• Access Token — create a System User in Business Settings and generate a permanent token with the whatsapp_business_messaging and whatsapp_business_management permissions. The default 24-hour token is for testing only.
• App Secret (optional but recommended) — found under App Settings → Basic. Used to verify that webhook calls genuinely came from Meta.
• WhatsApp Business Account ID (WABA ID) — optional today.

Step 3: Enter them in your bot

1. Open Dashboard → Bots and select your bot.
2. In the WhatsApp integration card, fill in:
   • Verify Token — type any random string (you will paste the same string into Meta).
   • Access Token — your permanent token from Step 2.
   • Client Secret — your Meta app secret (optional).
   • Default Bot Phone Number ID — from Step 2.
   • WABA ID — optional.
3. Tick Enable WhatsApp for this bot and click Save.

Step 4: Connect the webhook in Meta

1. Copy the Callback URL shown in the WhatsApp card.
2. In Meta under WhatsApp → Configuration → Webhook, paste the Callback URL and the same Verify Token you entered above, then click Verify and save.
3. Subscribe to the messages field. Without this, Meta will not deliver incoming messages.

Step 5: Test it

Send a WhatsApp message to your business number from any phone. Your bot replies within a few seconds, using your knowledge base.