Connect a WhatsApp number to your AI Agent via Meta Cloud API or Twilio.
Connecting WhatsApp lets your AI Agent answer customers on a WhatsApp number. Incoming chats are handled by the agent and collected in your Conversation inbox under the WhatsApp channel.
Choose a provider
Veflow supports two delivery providers — pick the one your company already uses:
| Provider | Best when |
|---|---|
| Meta Official Cloud API | You have a Meta developer app and a WhatsApp Business number |
| Twilio API | You use Twilio for messaging (including the Twilio WhatsApp sandbox) |
Open the WhatsApp settings
- Open your agent in the studio and click Publish, then choose Social Media Connector. For an already published agent, use Manage Social Media Config.
- On the Whatsapp card, select the Provider: Meta Official Cloud API or Twilio API.
Each agent has its own WhatsApp configuration, so different agents can serve different numbers.
Connect with Meta Cloud API
Fill in the fields from your Meta developer app:
- WhatsApp Phone Number ID — the phone number ID of your WhatsApp Business number.
- Verify Token (Webhook) — a secure random string of your choosing; you will enter the same value in Meta's webhook settings.
- Meta Access Token — the access token from your Meta app (it typically starts with
EAA).
The card also shows a Callback URL ending in /api/v1/whatsapp/meta/webhook. Copy it into your Meta App Dashboard's webhook settings together with your verify token, so Meta knows where to deliver incoming messages.
Click Connect to save. The card shows Connected when active.
Connect with Twilio
Fill in the fields from your Twilio console:
- WhatsApp Number — the WhatsApp-enabled number, in international format (for example
+62812...). - Account SID — your Twilio account SID.
- Auth Token — your Twilio auth token.
Click Connect to save. If you are testing with the Twilio sandbox, use the sandbox number and remember that sandbox recipients must join the sandbox first (a Twilio requirement, done from the recipient's phone).
After connecting
- Customers who message the number get answers from the agent — grounded in its prompt, knowledge bases, and tools. Replies consume AI credits.
- Threads appear per customer in the Conversation inbox's WhatsApp section.
- Use Update Config on the card to rotate tokens or switch provider, and Disconnect to stop WhatsApp delivery for this agent. Secrets are stored securely and never shown back in full.
Company WhatsApp connection (optional)
Separately from per-agent numbers, Workspace Setting has a social media section where an admin can connect a company-wide WhatsApp Business channel used for outbound notifications, follow-ups, and CRM messaging, with the same provider choice and a Test connection check.
Troubleshooting
- Connect fails with Twilio — Account SID and Auth Token are both required; re-copy them from the Twilio console.
- No incoming messages with Meta — verify the Callback URL and Verify Token in the Meta App Dashboard exactly match what the card shows.
- Wrong agent answering — check which agent's configuration holds the number; one number should map to one agent.
Prefer a bot-style channel instead? See Telegram.