This article walks you through the Vapi-side setup for Voice Ai Bots: creating an agent, generating a private API key, and understanding what CommPeak configures in your account.

📘
NOTE
Vapi is a third-party platform, and you need your own Vapi account to complete this integration. CommPeak Dialer applies the same campaign logic, routing, and monitoring to AI Voice Agents as it does to human agents.

How the integration works

The integration has two parts:

On the Vapi platform, you create and configure an AI agent - its voice, language, and conversation behavior.
In CommPeak Dialer, you connect that agent and assign it to your campaigns.
Once connected, the agent answers or places calls inside the flows you set up, and you supervise it with the same live monitoring capabilities as your human agents.

Preparing your Vapi account for voice AI Bots

Go to the Vapi website and click Get Started.
Sign up with your Google account or a work email address.
After signing up, you land in the Vapi agent builder dashboard at dashboard.vapi.ai.

Creating an agent

The AI voice agent you create and configure in the Vapi dashboard can talk to your leads.

In the Vapi dashboard, select a type that matches your use case, or describe what you want to build.

Vapi agent template selection
Follow the agent configuration steps to configure your assistant, for example, choose the task, voice, language, etc. and click to create your agent.

Vapi assistant created
Click Speak with Your Assistant to test the conversation directly in your browser - no phone number is required.

TIP
Keep the system prompt focused on your qualifying logic: who the assistant is, what it should accomplish on the call, and when it should hand the lead to a human.
CommPeak appends its own tool-usage instructions during setup and preserves your qualifier logic. You can also greet leads by name with the call variables listed on the AI Engines (Integrations) page.

Creating a private API key

CommPeak Dialer authenticates to your Vapi account with a private, server-side API key.

In the Vapi dashboard, go to MANAGE > API Keys.
Create a private (server-side) API key and copy it.

Private API Keys section

IMPORTANT
Use the private key, not the public one; the public key does not work for this integration.
The private key grants full access to your Vapi account, so store it securely and never share it in screenshots, chats, or support tickets.

What CommPeak sets up in your Vapi account

Vapi supports custom Session Initiation Protocol (SIP) trunks through its API only - there is no form for it in the Vapi dashboard. You do not need to create the trunk yourself. When you connect the engine with Auto provisioning and keep Set it for me in the Bot Flow settings, CommPeak uses your API key to configure your Vapi account:

Creates the SIP Trunk from CommPeak's gateway IPs and fills in the vendor SIP host.
Creates the transfer, hangup, and built-in End Call tools on your assistant and attaches them.
Appends CommPeak's tool-usage instructions to the assistant's system prompt, keeping your qualifier logic intact.
Creates the SIP phone number and binds it to your trunk and assistant.

⚠️
WARNING
Do not delete or rename the tools, trunk, or phone number that CommPeak creates in your Vapi account. Removing them breaks live calls, transfers, and call dispositions.

If your Vapi organization is hosted in the EU, the SIP host suffix changes from .sip.vapi.ai to .sip.eu.vapi.ai; the AI Engines (Integrations) page page covers this step.

Setting up manually

If you prefer to configure Vapi yourself, choose Guided provisioning when connecting the engine. After you save, CommPeak Dialer shows Setup instructions with the exact JSON to paste for each step: the transfer and hangup tools, the built-in End Call tool, the SIP phone number, and the system prompt additions. You can reopen the instructions any time from the Setup instructions action on the Bot Flow.

For background on how SIP trunks work on the Vapi side, see the Vapi SIP trunking documentation.

Next steps

As soon as your Vapi account is ready, connect it to CommPeak Dialer and add a Bot Flow on the AI Engines (Integrations) page, then clock your bots in from the AI Agents page.