Overview
This guide explains how to integrate WhatsApp Business voice calling into your Pipecat Cloud application using the WhatsApp Cloud API and SmallWebRTC. Once configured, your Pipecat Cloud bot will be able to receive and handle real-time voice calls directly from WhatsApp users.For a more detailed explanation of WhatsApp Business setup, voice calling, and webhook configuration, refer to our full WhatsApp Business Calling guide.
Pipecat Cloud–Specific Setup
In Pipecat Cloud you only need to ensure your bot is deployed and your environment variables are configured correctly.Configure Webhook for Pipecat Cloud
Your webhook URL must point to your deployed Pipecat agent:- Important: Use your public API key as the
Verify Token
for Meta Developer Console verification. - Always include the
/whatsapp
path at the end of the webhook URL. - Make sure your Pipecat agent is deployed and running.
Pipecat Cloud Secrets
In Pipecat Cloud, configure the following environment variables as secrets..env
file, you can upload to Pipecat Cloud as a secret set like this:
whatsapp-secrets
and securely stores your API keys for your Pipecat Cloud agent.
For instructions on generating the access token, phone number ID, and app secret, refer to the WhatsApp Cloud API Configuration.
Example
Your bot must useSmallWebRTCTransport
with audio enabled:
Full demo
Demo
Pipecat Cloud WhatsApp Demo
Testing Calls
- From WhatsApp, call your registered WhatsApp Business number.
- The call will be routed to your Pipecat Cloud agent.
- The bot should automatically answer and handle the conversation.
Troubleshooting
Common Pipecat Cloud issues:-
Webhook Verification Failed
- Verify the public API key matches the verify token in Meta Developer Console.
- Ensure the webhook URL is using the right organization and service names.
-
Bot Not Answering Calls
- Ensure the WhatsApp Business number has calling enabled.
- Ensure that the WhatsApp token is still valid.
For a complete troubleshooting section, see WhatsApp Business Calling guide.