Text and media
— send text, images, audio, video, documents and stickers, by public link or Meta media ID.
"type":"image"
POST /messaging/messages with type
WHATSAPPWhatsApp Business
API for AI agents
On the same account that runs your voice stack
The Vobiz WhatsApp Business API connects your AI agent, support team or backend to WhatsApp. Send approved templates and free-form replies, receive every inbound message and delivery status as a signed webhook, and take WhatsApp voice calls on the same number.
Book a demoMeta-approved
Tech ProviderMessages and calls
on one numberSigned webhooks
on every eventSame account and API
keys as Vobiz voice
How it works
From signup to your first WhatsApp message
in four steps
Everything below runs from the console or the REST API. Meta's business verification and template review run in parallel, and we show you their status as they move.
API key1234
First message01
+1 415 555 0123
+1 415 555 0123cURL
BASH
1# Send an approved utility template: returns a message id, status "pending"2curl -X POST https://api.vobiz.ai/api/v1/messaging/messages \3 -H "X-Auth-ID: $AUTH_ID" -H "X-Auth-Token: $AUTH_TOKEN" \4 -H "Content-Type: application/json" \5 -d '{"channel_id":"<channel_id>","waba_id":"<waba_id>","to":"+14155550123",6 "type":"template",7 "template":{"name":"order_shipped","language":{"code":"en_US"},8 "components":[{"type":"body","parameters":[{"type":"text","text":"#4821"}]}]}}'
Messaging API
Send and receive WhatsApp messages
through one API
Templates to start a conversation, free-form replies to continue it, and a status on every message until it's read.
Messaging reference
Template messages
— create, submit and track Meta-approved templates per channel, and sync edits made in Meta Business Manager.
order_shipped
/channels/{channelId}/templates · /templates/sync
One-time codes
— authentication templates carry a copy-code button and get expedited review from Meta.
482 913category: AUTHENTICATION
The 24-hour window
— reply free-form for 24 hours after a customer's last message; outside it, send an approved template to reopen the conversation.
24h
Everything customers send
— text, media, button and list replies, locations and contacts arrive as one event type.
message.inbound
Delivery and read status
— every message moves from pending to sent, delivered and read, or failed, and each step posts to your server.
pending
sent
delivered- read
failedmessage.status
WhatsApp calling
WhatsApp calling API:
answer customers who tap call
Customers can call your business from a chat, your business profile or a call button. Connect those calls to your AI voice agent over SIP, or handle them over WebRTC. Your agent can place WhatsApp calls from eligible business numbers too.
Calls API reference
Answer inbound calls
— pre-accept, accept, reject or terminate with a WebRTC SDP answer.
POST /calls/whatsapp/action
Place calls to customers
— start a call with an SDP offer from an eligible business number registered outside the US, once the customer has given permission.
POST /calls/whatsapp
Call history
— every call with direction, status, duration and hangup cause.
GET /calls/whatsapp/logs
Call events
— ringing, answered and ended, posted to the same webhook as your messages.
call.<event>
Calling a phone number, not a WhatsApp account? Use the Voice API.
Built for AI agents
Put your AI agent on WhatsApp,
with the model you already use
Vobiz carries the channel. Your agent, your model and your prompts stay yours.
- 1
A customer writes.
Vobiz posts the message to your server as a signed
message.inboundevent. - 2
Your agent decides.
Pass the message and conversation history to whatever model or framework you run.
- 3
Your agent replies.
Send the answer free-form inside the 24-hour window, or hand the conversation to a person.
No bundled models·no revenue share on your customers·no exclusivity
Webhooks and events
WhatsApp webhooks for every
message, status and call
Subscribe once, and Vobiz posts three event types to your server, each signed so you can prove it came from us.
Webhook events
| Event | When it fires | What you do with it |
|---|---|---|
message.inbound | A customer sends anything | Pass it to your agent or inbox; the 24-hour window resets |
message.status | A message is sent, delivered, read or fails | Update delivery state; match on the Meta message ID |
call.<event> | A WhatsApp call rings, connects or ends | Accept the call, log it, or trigger a follow-up |
Signed requests — every delivery carries an HMAC-SHA256 signature of the raw body in X-Webhook-Signature.
Safe to retry — deliveries are retried, and every event carries an event_id to deduplicate on.
Shared inbox and handoff
Hand a WhatsApp conversation
from your AI agent to a person
The Vobiz inbox gives your team one view of every WhatsApp conversation, with multiple agents working the same number. Let your AI agent handle the first reply and bring in a person when the conversation needs one.
+1 415 555 0123
Numbers and onboarding
Three ways to connect a WhatsApp number,
including from another provider
Bring your own number
— verify a number you already own with a one-time code by SMS or voice call, then connect it.
Buy a number from Vobiz
— search and buy a WhatsApp-capable number in the console or over the API.
Meta embedded signup
— sign in with your Meta business account and connect a number in one flow.
A WhatsApp number can be on one provider at a time. Deregister it with your current provider, connect it to Vobiz, and your templates and business profile come with your WhatsApp Business Account.
Security
Security for a channel
your customers trust
Signed webhooks
— verify every event against an HMAC-SHA256 signature before you act on it.
Write-only Meta tokens
— your Meta system-user token is stored, never returned by any API, and rotated with one request.
Tenant isolation
— sub-accounts with separate credentials, billing and channels, so one customer's WhatsApp numbers never touch another's.
0100
Opt-in by design
— Meta requires customers to agree to hear from your business. Templates are reviewed before they send, and quality ratings protect your number.
Use cases
What teams build on
the Vobiz WhatsApp API
AI support on WhatsApp— your agent answers every inbound message in seconds and hands off to a person when it should.Order, appointment
and account updates— utility templates triggered from your backend, with delivery and read status on each.Verification codes— one-time codes in authentication templates, with a copy-code button.Call support from the chat— customers tap call inside WhatsApp, and your team or system answers over the API.Customers outside the US— reach users in markets where WhatsApp is the default channel, with marketing templates and outbound calls available there.
and account updates— utility templates triggered from your backend, with delivery and read status on each.Verification codes— one-time codes in authentication templates, with a copy-code button.Call support from the chat— customers tap call inside WhatsApp, and your team or system answers over the API.Customers outside the US— reach users in markets where WhatsApp is the default channel, with marketing templates and outbound calls available there.
Get started
Your AI agent on WhatsApp,
this week
Connect a number, get a template approved, and answer your first customer.
No sales call, no commitment.
FAQ
WhatsApp questions
- It is Meta's API for businesses to message and call customers on WhatsApp from their own software. Conversations are opened with Meta-approved templates, customers' replies arrive as events, and free-form replies are allowed for 24 hours after the customer's last message.
- Vobiz is a Meta-approved Tech Provider. The Vobiz WhatsApp Business API connects your AI agent, support team or backend to WhatsApp: send templates and free-form replies, receive every inbound message and delivery status as a signed webhook, and take WhatsApp calls on the same number, all on the account and API keys you use for Vobiz voice.
- Not at the moment. Meta has paused delivery of marketing templates to US (+1) numbers since April 1, 2025. Utility templates still reach US numbers, and marketing templates reach customers outside the US.
- Business-initiated WhatsApp calls are not available for US-registered business numbers. Customers in the US can still call your business, and business numbers registered in most other countries can call customers who have given permission. Meta's Cloud API Calling documentation has the current details.
- Vobiz posts each inbound message to your server as a signed message.inbound event. Pass it, with the conversation history, to whatever model or framework you run, then send the answer back free-form inside the 24-hour window, or hand the conversation to a person in the Vobiz inbox.
- After a customer messages you, you can reply free-form for 24 hours. Each new message from the customer resets the window. Outside it, send an approved template to reopen the conversation.
- Meta requires business-initiated conversations to start with a template it has reviewed, and customers must have agreed to hear from your business. Once the customer replies, you can continue free-form within the 24-hour window.
- Meta reviews most templates within minutes, and some take up to 24 hours. Submit and track templates from the Vobiz console or the API; we show you their status as review moves.
- Yes. Verify a number you already own with a one-time code by SMS or voice call, then connect it. You can also buy a WhatsApp-capable number from Vobiz, or connect through Meta's embedded signup.
- A WhatsApp number can be on one provider at a time. Deregister it with your current provider, then connect it to Vobiz. Your templates and business profile come with your WhatsApp Business Account.
- Use an authentication template. Authentication templates carry a copy-code button and get expedited review from Meta.
- Every message moves from pending to sent, delivered and read, or failed, and each step posts to your server as a message.status event. Match it on the Meta message ID to update your records.
- Every delivery carries an HMAC-SHA256 signature of the raw request body in the X-Webhook-Signature header. Check it before you act on the event. Deliveries are retried, so deduplicate on the event_id each event carries.
- Yes. WhatsApp uses the same account, the same API keys and the same sub-accounts as Vobiz voice. When a voice call ends, for example, you can send a utility template with the confirmation or summary.
- See the Vobiz pricing page for current rates, or talk to us about volume. There are no bundled models, no revenue share on your customers and no exclusivity.
The Infrastructure Platform for Voice AI Builders and Integrators
Your brand. Your pricing. Vobiz under the hood.
Run your voice AI business through a single API. Provision customer accounts, control billing, and manage DID inventory, call records, and financial reconciliation in real-time. You own the customer relationship. We power the infrastructure behind it.
Related