All integrations

Integration · Beta

Connect Vapi to your WhatsApp number

Your Vapi assistant can answer the calls to the number you linked to WaAPI: we dial its SIP address and the caller talks to the assistant. Through Frontdesk, the same assistant can also answer your one-to-one text messages.

What you need

  • A WaAPI instance with your number linked
  • A Vapi assistant
  • For calls: the voice agent beta on your account, and the SIP address Vapi gives you
  • For text messages: the assistant id and your private Vapi API key

Voice calls: your assistant answers the phone

During the beta we have tested the connection live with Vapi. Voice agent calls have to be enabled for your account first: ask support to switch them on.

  1. 01

    Ask for the beta

    Until it is enabled, the option does not appear in the dashboard.

  2. 02

    Take the SIP address from Vapi

    In your Vapi settings, look for the option to receive calls over SIP (often called “SIP trunk”, “inbound SIP” or “custom telephony”) and copy the SIP address it gives you. If Vapi asks for authentication, set up a username and password there too.

  3. 03

    Open the call settings of your instance

    Tab Sending & calls, section Call settings. Under Incoming calls, choose Connect to a voice agent.

  4. 04

    Choose SIP and save

    Under Voice agent, choose SIP: we dial your agent's SIP address. Enter the SIP URI, and username and password only if Vapi requires them. Click Save call settings.

  5. 05

    Call your number

    The call keeps ringing until your assistant answers, then the two of you talk. If it is not reachable within about 20 seconds, the call is not answered.

Text messages: Frontdesk’s Vapi mode

Frontdesk, our AI chatbot, is in beta. In Vapi mode it does not answer from its own knowledge: your Vapi assistant answers, under your Vapi account.

  1. 01

    Open the Frontdesk tab

    On your instance, open the tab Frontdesk · AI chatbot.

  2. 02

    Choose who answers

    Under Who answers?, choose Your Vapi assistant.

  3. 03

    Enter your assistant and key

    The Assistant id is in the Vapi dashboard under Assistants. The Private API key is your private key from the Vapi dashboard, not the public one.

  4. 04

    Check and save

    Click Check and save. We ask Vapi whether the key and the assistant work and save nothing until they do. The key is stored encrypted and never shown again.

  5. 05

    Switch it on

    Turn on Answer incoming messages with your Vapi assistant.

What happens then

  • Every one-to-one text message goes to your assistant, and its answer is sent directly from your number. Group chats are not answered.
  • The assistant keeps the context of a chat as long as its last exchange is less than 24 hours old.
  • Chats are never paused or handed over to you; Vapi takes over the conversation.
  • At most 20 answers per chat in an hour. Pictures and voice messages are not answered.
  • A message that stays unanswered (a picture, a limit, an error at Vapi) shows on the activity page with its reason.
  • Your knowledge sources and actions are not used in this mode.

Set it up through the API

To onboard many numbers from your own product, configure both right after creating an instance, with the same API token for all instances of your account. Each instance can use its own assistant; the same Vapi private key can be used on as many instances as you like.

Text messages: PUT /api/v1/instances/{id}/frontdesk

{
  "enabled": true,
  "answer_source": "vapi",
  "vapi": { "assistant_id": "<assistant uuid>", "api_key": "<private api key>" }
}

We check the key and the assistant with Vapi before saving. The key is write-only: GET /api/v1/instances/{id}/frontdesk shows has_api_key instead.

Voice calls: PUT /api/v1/instances/{id} (or with POST /api/v1/instances)

{
  "call_policy": {
    "mode": "connect_agent",
    "agent": { "type": "sip", "sip_uri": "sip:<user>@sip.vapi.ai", "sip_username": "<optional>", "sip_password": "<optional>" }
  }
}

Details and every field: setup guide.

Vapi questions

What the connection does, and what stays with Vapi.

No. WaAPI is an independent service and Vapi is a separate one, with its own account and billing. The connection uses Vapi’s standard SIP calls and its chat API.

No. Calls go to the number you linked to your WaAPI instance.

Only when the platform tells us the number; currently it often does not. Build your assistant so it works without it, for example by asking for it.

Not in this beta. It answers incoming calls only, voice only.

In Vapi mode nothing is handed over: the request reaches your assistant as plain text, so tell it in its own instructions what to answer.

Your private API key from the Vapi dashboard. A public key is refused when you save.

Connect an account and start sending

One flat rate per connected number. No message quota, no approval process, no per-message invoice.