Skip to main content
Kapso voice agents bridge WhatsApp voice calling with your Pipecat Cloud agent. Follow this guide to enable the feature, deploy Kapso’s open-source Pipecat starter, and take the first test call.

​
Prerequisites

  • A Pipecat Cloud account with access to pipecat.daily.co.
  • A WhatsApp Cloud API number onboarded in Kapso with Voice calling (calls_enabled) switched on.
  • Pipecat Cloud agent name (serviceName) and public API key.
  • Optional: Docker registry access if you will push a custom image.

​
1. Deploy the sample Pipecat agent

Use the open-source starter repo to get a runnable Pipecat container:
  1. Clone gokapso/whatsapp-voice-agent-pipecat.
  2. Copy .env.example to .env and set OPENAI_API_KEY. You can also override the default system prompt with SYSTEM_PROMPT.
  3. Install dependencies locally: 
    uv sync
  4. Authenticate with Pipecat Cloud: 
    uv run pcc auth login
  5. Build and push an image (uses pcc-deploy.toml for the image tag): 
    uv run pcc docker build-push
  6. Deploy the agent: 
    uv run pcc deploy kapso-demo IMAGE_TAG --credentials YOUR_DOCKER_SECRET
The sample bot.py accepts WhatsApp calls, runs OpenAI STT → LLM → TTS, and speaks as “Kap,” the Kapso engineer persona. Swap models or prompts later as needed.
  1. Sign in to app.kapso.ai and open Voice agents → New voice agent.
  2. Give the agent a friendly name.
  3. Select Pipecat as the provider and paste the Pipecat public API key plus the agent name you deployed.
  4. Save. Kapso encrypts your API key at rest.
  5. Attach a WhatsApp configuration (phone number). Mark one assignment as Primary and keep Enabled toggled on so Kapso launches sessions for that number.
Prefer an API workflow? Start with the API setup guide, then use Create voice agent and Assign WhatsApp phone number for the exact request and response shapes.

​
3. Test the call path

  • Place a voice call to the connected WhatsApp number from a mobile device.
  • Kapso receives the Meta calls webhook, starts the Pipecat session, and the agent greets the caller.
  • Confirm that call details appear under Voice agents → Calls and verify the audio path.
Next, explore the architecture and monitoring guides to understand how Kapso packages context for your agent and how to troubleshoot production calls.