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 Dialer configures in your account.

How the integration works

The integration has two parts:

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

Preparing your Vapi account

1. Go to the Vapi website.

2. Sign up with your Google or GitHub account. You can also use your work email address or sign in with SSO.

   

3. After signing up, you land in the Vapi agent builder dashboard at dashboard.vapi.ai.

Creating your Vapi agent

1. In your Vapi dashboard, select an agent type that matches your use case: Inbound, Outbound, or Support. Alternatively, describe the agent you want in the text box below the cards.

   

2. Answer the Agent Composer's setup questions, including what to name the agent and how it should handle escalation. Choose from the suggested options, such as Collect details for a specialist or Offer a live transfer later, or describe your own approach.

   

3. Click Approve when prompted to create the draft assistant.

   

4. Click Speak with Your Assistant to test the draft immediately, or click View Created Assistant to open its full configuration.

   

5. In the assistant's Composer page, define the First Message and choose how the call opens from the drop-down: Assistant speaks first, Assistant waits for user, or Assistant speaks first with model generated message.

   

Writing the agent's system prompt

1. Edit the System Prompt field directly, or click Generate and describe how you want the agent to sound or behave. Click Submit Edits.

   

2. Review the prompt Vapi drafts. It's organized into sections. In this case they are: Identity, Style, Response Guidelines, Task & Goals, and Error Handling / Fallback.

3. If needed, use the follow-ups to fine tune the agent behavior. For example, you can ask to set the exact conditions for transferring the call to a human agent.

   

4. After you click Send Follow-up, the system regenerates the prompt.

   

5. Add more follow-up refinements if needed, then click Accept Changes.

Testing and publishing your agent

1. Click Talk to test the finished agent in a live conversation.

   

2. When you're satisfied, click Publish. The agent appears under the Assistants tab, where you manage all your Vapi agents.

Generating your private API key

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

1. In the Vapi dashboard menu, go to MANAGE > API Keys.

   

2. Create a private (server-side) API key and copy it.

   

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.

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.