An AI Engine is your connection to a voice-AI vendor. CommPeak connects to your vendor account - you keep control of the account, billing, and quotas. Once an engine is connected, you add one or more Bot Flows to it; each Bot Flow is a single bot with its own capacity and skills.

Open AI Engines from the main menu. (New to the feature? Start with the Voice AI Bot overview)

CommPeak supports two vendors today - Vapi and ElevenLabs. Pick yours below; each section is a complete, self-contained setup. The Add a Bot Flow, Test, and health steps further down are the same for every vendor.

Vapi

Prerequisites

Connect the engine

1. On the AI Engines page (Settings > AI Engines), click Add AI Engine.

   

2. Display name: a name for this connection (e.g. Sales-Vapi-Acct-A).

3. Vendor: choose Vapi. (Locked once saved - to switch vendor, create a new engine)

4. Provisioning:

   • Auto - CommPeak pushes the trunk config to Vapi via API (recommended).
   • Guided - you set up the trunk yourself.

5. Fill the credentials:

   Field	What to enter
   API key	Your Vapi private (server-side) API key
   Base URL	https://api.vapi.ai (change only for self-hosted Vapi)
   SIP gateway IP(s)	IPs/CIDRs that originate calls to Vapi - defaults to CommPeak's FreeSWITCH IPs
   Vendor SIP host	Filled automatically in the next step

6. Click Create SIP trunk on Vapi. This provisions the BYO trunk from your gateway IPs and auto-fills Vendor SIP host.

7. (EU accounts only) Change the SIP host suffix .sip.vapi.ai → .sip.eu.vapi.ai.

8. Click Test connection, then Save Engine.

Bot flow settings for Vapi

When you add a Bot Flow on a Vapi engine, these fields are Vapi-specific:

• Vendor setup → Set it for me (recommended) - on save, CommPeak creates the transfer, hangup, and built-in End Call tools on your assistant, attaches them, appends CommPeak's tool-usage instructions to the assistant's system prompt, and creates & binds the BYO phone number. Your system prompt's qualifier logic is preserved.

• SIP phone number - enter the E.164 number (e.g. +19995550123) the bot answers on, and register that same number in Vapi → Phone Numbers → Create → BYO SIP Trunk Number, bound to your trunk credential and assistant.

  

Manual setup guide (Vapi)

If you pick I'll set it up myself, the post-save screen walks you through these steps with the exact JSON to paste:

1. Add the transfer to human tool (API Request → Edit as JSON).
2. Add the hangup tool (API Request → Edit as JSON).
3. Add the built-in End Call tool (this is what actually ends the call).
4. Create the BYO SIP phone number and bind it to your assistant.
5. Append the callback-clock + tool-usage rules to the assistant's system prompt.

You can reopen this any time from the Setup instructions action on the flow.

Call variables for your prompts (Vapi)

CommPeak sends per-call context on every call, and Vapi exposes each item as a dynamic variable you can reference in your assistant's system prompt (e.g. "Greet the lead by {{lead_first_name}}").

Available on every call (outbound and inbound):

Additionally on inbound calls (callers reaching the bot through an IVR - see Inbound Voice Agent):

ElevenLabs

Prerequisites

Connect the engine

1. On the AI Engines page (Settings > AI Engines), click Add AI Engine.

   

2. Display name - a name for this connection (e.g. Support-11Labs).

3. Vendor - choose ElevenLabs. (Locked once saved.) Provisioning is handled by ElevenLabs auto-setup, so that field is hidden.

4. Fill the credentials:

   Field	What to enter
   API key	Your xi-api-key with the permissions listed above
   Base URL	https://api.elevenlabs.io
   Vendor SIP host	Leave the prefilled value - it's the same for every ElevenLabs account (a sanity check only)
   Workspace ID	Optional - only for multi-workspace accounts whose default workspace doesn't hold the agents

5. Click Test connection, then Save Engine.

Bot flow settings for ElevenLabs

When you add a Bot Flow on an ElevenLabs engine, these fields are ElevenLabs-specific:

• Allowed IPs - IPs/CIDRs allowed to send inbound SIP to this bot's number; defaults to CommPeak's FreeSWITCH IPs.

• SIP phone number - with Set it for me this is created and filled for you; in manual mode you enter it yourself.

• Vendor setup → Set it for me (recommended) - on save, CommPeak creates the webhook secret, the transfer & hangup tools, and a SIP phone number, and writes the agent's conversation workflow. Your tuned qualifier prompt is kept.

  

Manual setup guide (ElevenLabs)

If you pick I'll set it up myself, the post-save screen walks you through these steps with the exact values to paste:

1. Create the webhook secret (Agents → Settings → Secrets).
2. Create the transfer to human webhook tool (Edit as JSON), then add its Authorization header.
3. Create the hangup webhook tool the same way.
4. Import the SIP phone number (Phone Numbers → Import → SIP trunk) and set its Allowed addresses.
5. Bind the number to your agent.
6. Set the agent workflow (paste the workflow graph, swap in your two tool IDs).
7. Append the callback clock to the agent's system prompt.

You can reopen this any time from the Setup instructions action on the flow.

Call variables for your prompts (ElevenLabs)

CommPeak sends per-call context on every call, and ElevenLabs exposes each item as a {{sip_*}} dynamic variable you can reference in your agent's system prompt (e.g. "Greet the lead by {{sip_lead_first_name}}").

Available on every call (outbound and inbound):

Additionally on inbound calls (callers reaching the bot through an IVR - see Inbound Voice Agent):

Add a Bot flow

A Bot Flow maps one vendor bot into the dialer and decides how it runs. On the engine's row in the list, click Add Bot Flow. These fields are the same for every vendor (the vendor-specific fields are covered in your vendor section
above):

1. AI Engine - the engine you're adding to (locked).
2. Vendor bot - pick the bot to import from your vendor account. Bots already imported are hidden.
3. Display name - a name for this flow inside the dialer.
4. Channels - how many calls this bot handles at once. The dialer creates one AI Agent per channel automatically. Lowering the number removes idle channels; agents on a call finish first. (Capped by the vendor's per-bot limit, shown
   as a hint.)
5. Activation strategy - how many of the flow's AI Agents stay active:
   • Ratio (AI per human) - a target number of bots per active human (e.g. 3.0). Scales with your human staffing.
   • Fixed active count - a set number of bots, regardless of humans. (Available only if your account allows it.)
6. Skill groups - the skill groups all channels of this flow share. This is how the flow reaches campaigns - see How a bot reaches a campaign in the overview.
7. Allow inbound calls - check to let this flow accept inbound callers from an IVR. See Inbound Voice Agent.
8. Vendor setup + any vendor-specific fields - see your vendor section above.
9. Leave Active checked and click Save Bot Flow.

Manage engines and flows

The AI Engines page lists each engine with an expand arrow that reveals its Bot Flows.

Engine columns: Active (accepting traffic) and Status: Healthy, or Auto-disabled with a hover reason. Engine actions: Add Bot Flow, Edit, Re-enable (when auto-disabled), Delete.

Bot Flow columns: Channels, Activation (ratio/fixed), Active, and Status. Flow actions: Setup instructions, Test Bot Flow, Edit, Re-enable (when auto-disabled), Delete.

Test a Bot flow

Use Test Bot Flow to place a real test call and confirm the bot answers and greets correctly. Choose where the test call rings first:

• My SIP URI: your own logged-in SIP device.
• Destination Number (Via Trunks): any phone number, dialed over your trunks.

On answer, the call is bridged to the bot. The test call is not saved to your call records.

Vendor health & auto-disable

If calls to a vendor keep failing, CommPeak automatically protects you: the affected Bot Flow is set to Auto-disabled (and a widespread failure cascades to the whole Engine), with a reason you can read by hovering the status icon.
You're notified when this happens. Once the vendor is healthy again, click Re-enable on the flow or engine to resume.

✔️ With an engine connected and a Bot Flow active, your bots are ready to dial - head to AI Agents to clock them in.