WhatsApp Integration
Connect WhatsApp Business numbers to osmTalk agents for automated voice calls and text conversations.
The WhatsApp integration lets you connect a WhatsApp Business number to an osmTalk agent, enabling automated voice calls and text-based chat conversations directly through WhatsApp.
Requirements
Before setting up the integration you need:
- A Meta Business Account with WhatsApp Business API access
- A phone number registered with WhatsApp Business (not a personal WhatsApp number)
- A WhatsApp Business App created in the Meta Developer Portal
Conversation Modes
| Mode | Description |
|---|---|
| Voice Calls | Handles WhatsApp calling — the agent answers and conducts the conversation over audio |
| Text Messages | Responds to incoming text messages with automated chat replies from the agent |
Both modes can be active simultaneously on the same number.
Setup
1. Add Your Number
- Go to the WhatsApp page in the osmTalk dashboard
- Click Add Number
- Fill in the fields:
| Field | Description |
|---|---|
| Phone Number | Your WhatsApp Business phone number in E.164 format (e.g., +15551234567) |
| Phone Number ID | Found in Meta Developer Portal → your app → WhatsApp → API Setup |
| Display Name | Friendly name shown to your users |
| Access Token | Permanent or temporary token from the Meta Developer Portal |
| App Secret | Your Meta App's secret key (used to verify webhook signatures) |
| Webhook Verify Token | A token you choose; used to verify the webhook during Meta's handshake |
2. Configure the Webhook in Meta Dashboard
In the Meta Developer Portal, set your webhook URL to:
https://api.osmtalk.com/api/webhooks/whatsappSubscribe to the messages webhook field under the WhatsApp product. Use the same Webhook Verify Token you entered in osmTalk.
3. Enable Voice Calls (Optional)
Toggle Enable Calling on the number settings to allow the agent to handle incoming WhatsApp voice calls in addition to text messages.
4. Assign an Agent
Select which osmTalk agent should handle incoming conversations for this number. The agent uses its configured LLM, STT, and TTS settings for both voice and text interactions.
Credits
Credits are deducted per call and per message the same way as other channels:
- Voice calls — charged for LLM tokens, STT minutes, and TTS characters
- Text messages — charged for LLM tokens used to generate replies
See Credits & Pricing for per-provider rates.