Connect an AI agent to your WhatsApp Business number and it answers customer messages around the clock — questions about your services, opening hours, order status, whatever you train it on. The WhatsApp channel is part of Agent Builder Pro and uses Meta’s official WhatsApp Cloud API, so there is no unofficial gateway and no risk of your number being banned.
Prerequisites
- Agent Builder Pro installed and activated (Personal or Agency license)
- A WhatsApp Business number
- A Meta developer account with an app that has the WhatsApp product enabled (free at developers.facebook.com)
- Your site reachable over HTTPS (Meta requires it for webhooks)
Setup
1. Get your Meta credentials
In the Meta App Dashboard, open your app → WhatsApp → API Setup. Note the Phone Number ID and generate a permanent Access Token (via a Meta System User for production use).
2. Enter the credentials in Agent Builder
In your WordPress admin go to Agent Builder Pro → Connectors & Channels → Channels and open the WhatsApp section. Fill in:
- Phone Number ID — from the Meta API Setup page
- Access Token — your permanent token (stored encrypted in your database)
- App Secret — from Meta App Dashboard → Settings → Basic; used to verify webhook signatures
- Verify Token — any random string you invent; you will paste the same value into Meta in the next step
- Default Agent — the agent that answers messages not routed to a specific agent
3. Point Meta at your webhook
Back in the Meta App Dashboard, open WhatsApp → Configuration and add a webhook:
- Callback URL:
https://your-site.com/wp-json/agentic/v1/whatsapp/webhook - Verify Token: the same string you entered above
Click Verify and Save, then subscribe to the messages webhook field.
4. Enable WhatsApp per agent
Open the agent you want on WhatsApp and enable the WhatsApp channel in its settings. You can also restrict which phone numbers may talk to your agents with the Allowed Phones allowlist — handy while testing.
Expected result
Send a WhatsApp message to your business number. Your default agent replies within a few seconds. Inbound images and other media are fetched from Meta and processed by the agent (very large files are rejected). Conversations appear in Agent Builder → Activity like any other chat, and customers can be handed off to a human with the live-chat handoff console.
Troubleshooting
- Meta webhook verification fails — the Verify Token in Meta must exactly match the one in Agent Builder; also confirm your site has no maintenance-mode or coming-soon plugin intercepting the request.
- Messages arrive but no reply — check that a Default Agent is selected and that your access token has not expired (temporary tokens last 24 hours; use a System User token).
- Webhook rejected — an incorrect App Secret means signature validation fails; recopy it from Meta App Dashboard → Settings → Basic.
- Replies not delivered — the Phone Number ID must belong to the WhatsApp Business account that owns the number; test numbers in Meta’s dashboard have a 5-recipient limit.
Related
- Slack Channel and Email Channel — other ways customers can reach your agents
- All channels — Telegram, Discord, Teams, SMS and more
- Built-in Assistants
- Documentation