Calling API alternative · Beta

A WhatsApp calling API alternative for your AI voice agent

When someone calls the number of your instance, WaAPI answers the call and connects its audio to your voice agent: the agent hears the caller, the caller hears the agent, both ways in real time. With Vapi, the same assistant can answer your text messages too.

Beta

Voice agent calls are in beta and have to be enabled for your account. Ask support to switch them on.

Your own number · SIP or WebSocket · Setup guide

How it works

From a ringing phone to your AI agent

  1. 1

    A call comes in

    Someone calls the number you linked to your instance. Your call webhook fires as before, if you subscribed to it.

  2. 2

    WaAPI reaches your agent

    We dial your agent’s SIP address or open the WebSocket. The call keeps ringing for the caller until your agent is ready.

  3. 3

    The call is answered

    As soon as your agent answers (SIP) or the stream is open (WebSocket), the audio flows both ways in real time.

  4. 4

    Either side hangs up

    The call ends when the caller or your agent hangs up, or after 60 minutes.

Your AI voice agent

Three ways to connect it

Most hosted voice agent platforms can take calls over SIP. During the beta we have tested the connection live with Vapi; other providers that accept standard SIP should work the same way.

SIP

We dial your agent’s SIP address, over TLS by default.

Vapi, Retell, ElevenLabs, OpenAI Realtime, any SIP endpoint

WebSocket to your URL

We open a WebSocket to your URL and stream the call in the Twilio Media Streams format.

Your own server, or any agent that accepts Twilio Media Streams

WebSocket to us

We send your webhook a one-time stream address, and your agent connects to us.

Your own server, when it cannot accept incoming connections

Field rules, API examples and the message format are in the setup guide. Using Vapi? Connect Vapi step by step.

WhatsApp AI agent for calls and chats

The same Vapi assistant answers your messages

Frontdesk, our AI chatbot (beta), can hand your one-to-one text messages to your own Vapi assistant instead of answering them itself. Vapi’s answers are sent directly from your number, and the assistant keeps the context of a chat as long as its last exchange is less than 24 hours old.

  • Set up on the instance with your Vapi assistant id and private API key. Nothing to code.
  • No handover: chats are never paused or handed over to you.
  • At most 20 answers per chat in an hour. Pictures and voice messages are not answered.
Connect Vapi to your number

Calls in the REST API

Handle calls from your own code

Not every call needs an agent. The same API can start, accept, reject and end calls (beta) and create call links, and your webhook receives call and call_ended events. The voice agent is set per instance with call_policy, in the dashboard or through the API.

API reference

Side by side

Meta’s Calling API or WaAPI

Meta offers the WhatsApp Business Calling API for numbers on its Cloud API. WaAPI is an independent alternative for the number you already use.

 
Meta Calling API
Official · part of the Cloud API
WaAPI
Independent · beta
Which number A number registered on the Cloud API. A number in use in the app must be deleted there first; exception: coexistence for Business app numbers through a solution partner The number you already use, linked to an instance by QR code or pairing code like an extra device
Setup Meta business portfolio, WhatsApp Business Account, number registration and display name review Link the number, ask support to enable the beta, then enter your agent’s SIP address or WebSocket URL
Calls Calling API since July 2025. Calls from users are free, calls started by the business are billed Incoming calls are answered by your AI agent. No outgoing agent calls in the beta
Status Official, hosted by Meta Independent service, beta

As of October 2026. Source, Meta’s documentation: Calling. The full comparison of the two APIs: Cloud API vs. WaAPI.

Pick Meta’s API if your agent should place calls

The WaAPI beta answers incoming calls only. Calls started by the business are part of Meta’s Calling API.

Or if you need the official channel

If your compliance team only signs off on Meta’s own platform, WaAPI is not the right fit.

Good to know

What the beta does and does not do

Only answered when your agent is reachable

If your agent is not ready within about 20 seconds of the call coming in, the call is not answered and keeps ringing. A caller never ends up in an answered call with nobody on the other end.

One call per instance at a time

While a call is connected to your agent, a second call to the same number is not answered and keeps ringing.

Incoming calls only, voice only

Video calls are answered as voice calls. There are no outgoing agent calls, no keypad tones (DTMF) and no recording in this beta.

No audio is stored

WaAPI passes the audio through and keeps none of it. Calls end after 60 minutes at the latest.

Calling API FAQ

What you need, what it works with, and what the beta leaves out.

No. WaAPI is an independent service and an alternative to it. Your number is linked to a WaAPI instance, and WaAPI connects the calls to that number to your agent.

Agents that take calls over SIP, such as Vapi, Retell, ElevenLabs or OpenAI Realtime, and anything that speaks the Twilio Media Streams format over a WebSocket. During the beta we have tested SIP live with Vapi; other providers that accept standard SIP should work the same way.

No. The calls go to the number you linked to your instance by QR code or pairing code.

Voice agent calls are in beta and have to be enabled for your account. Ask support to switch them on; until then the option does not appear in the dashboard.

Not in this beta. It answers incoming calls only.

Only when the platform tells us the number. Currently it often identifies the caller only by an internal id, and then your agent gets no number. Build your agent so it works without it, for example by asking for it.

Your number runs on a regular WaAPI plan; the plans are on our pricing page. Ask support about the beta when you request access.

Put your AI agent on your calls

Ask for the beta, then follow the setup guide. See pricing for the plan of your number.

WaAPI is not affiliated with, endorsed by or sponsored by the messaging platform or its operators. All referenced product names and trademarks belong to their respective owners.