--- title: "Vapi AI" slug: "byob-vapi-ai" description: "Integrate Vapi with Voiso to create an AI voice assistant as a Virtual User and route calls to it through Flow Builder and Dialer campaigns." tags: ["BYOB", "call routing", "campaign", "Dialer", "Flow Builder", "route", "Vapi", "virtual", "virtual agent", "voice flow"] updated: 2026-04-30T09:49:46Z published: 2026-04-30T09:49:46Z canonical: "docs.voiso.com/byob-vapi-ai" --- > ## Documentation Index > Fetch the complete documentation index at: https://docs.voiso.com/llms.txt > Use this file to discover all available pages before exploring further. # Vapi AI {{variable.AudienceAdminSuper}} Integrate Vapi with {{variable.BrandName}} to create an AI voice assistant as a Virtual agent and route calls to it through Flow Builder and Dialer campaigns. ## Introduction The Vapi AI integration lets you bring your own voice bot into {{variable.BrandName}}. You can connect your Vapi account, have {{variable.BrandName}} automatically create a Vapi AI assistant and a corresponding [Virtual agent](/v1/docs/virtual-agents), and then route calls to this bot in [Flow Builder](/v1/docs/flow-builder-route) or [Dialer campaigns](/v1/docs/outbound-dialer-campaigns-overview). Vapi manages the AI assistant’s behavior, conversation flow, and voice output. {{variable.BrandName}} manages telephony, call routing, reporting, and overall contact center operations. :::(Error) (Important) The Bring Your Own Bot (BYOB) feature must be enabled for your contact center before you can connect to Vapi AI. ::: ## Features The Vapi integration provides the following capabilities: | Feature | Description | | --- | --- | | Automated assistant setup | {{variable.BrandName}} uses your Vapi API key, assistant name, and prompt to create a Vapi assistant, phone number, SIP address, and matching Virtual agent. | | Virtual agent creation | {{variable.BrandName}} automatically creates a Virtual agent linked to the Vapi assistant SIP address so you can treat the bot like any other user for routing. | | Flow Builder routing | Route inbound calls from your {{variable.BrandName}} flows to the Vapi AI assistant using the Virtual agent created for the integration. | | Dialer campaign support | Use the Vapi Virtual agent as a participant in Dialer campaigns so the bot can handle outbound calls without manual dialing. | ## Integration During the initial connection, {{variable.BrandName}} uses the information you provide on the Vapi integration page to build the assistant for you and creates a [Virtual agent](/v1/docs/virtual-agents) in your contact center. Watch this tutorial video to learn how to connect your Vapi AI account to your contact center. @(Embed)(https://cdn.document360.io/44ae307a-3737-4fbf-98e0-9b888deb90dc/Images/Documentation/BYOB%20Vapi%20AI%20Integration.mp4){height="320" width="640"} ### Prerequisites Before connecting Vapi to {{variable.BrandName}}, make sure you have: * {{variable.BrandName}} admin permissions * An active Vapi account * A Vapi API key generated in your Vapi AI dashboard. You can use either the private or the public key. ### Connecting To integrate {{variable.BrandName}} with Vapi AI, navigate to **Administration > Integrations**, then click the **Vapi AI** tile. ![Integrations Page BYOB Vapi AI Tile](https://cdn.document360.io/44ae307a-3737-4fbf-98e0-9b888deb90dc/Images/Documentation/Integrations%20Page%20BYOB%20Vapi%20AI%20Tile.png){height="" width=""} The **Vapi AI** page provides information about the Vapi AI integration, instructions for connecting the integration, and a list of prerequisites you should have in place before clicking **Connect**. ![Integrations Vapi AI Integration Page](https://cdn.document360.io/44ae307a-3737-4fbf-98e0-9b888deb90dc/Images/Documentation/Integrations%20Vapi%20AI%20Integration%20Page.png){height="" width=""} 1. Click **Connect**, then in the **Integration setup** panel, click **Next**. 2. In the **Connection setup** panel enter the following information: 1. Your Vapi API key. 2. The name of your Vapi AI assistant. 3. A prompt or description of your assistant, or click **Generate** to add a generic prompt that you can edit to suit your business needs. The prompt is an explanation of how you want the Vapi AI assistant to handle calls, including its role, tone, and key tasks. {{variable.BrandName}} sends this text to Vapi when creating the assistant so it can generate appropriate responses during conversations. If you are not sure what to enter, start with a simple description in plain language. Describe who the assistant is, how it should greet callers, what it can help with, and when it should transfer the call to a human agent. Refer to the [Voice AI Prompting Guide](https://docs.vapi.ai/prompting-guide) for more information. 4. Click **Next**. {{variable.BrandName}} automatically creates a Vapi assistant, phone number, SIP address, and a corresponding [Virtual agent](/v1/docs/virtual-agents) in your contact center. ### Manage your virtual agent If you want to route inbound calls to your virtual assistant you must assign a contact center extension to the Virtual agent account. ![Integrations Vapi AI Edit Virtual Agent Page](https://cdn.document360.io/44ae307a-3737-4fbf-98e0-9b888deb90dc/Images/Documentation/Integrations%20Vapi%20AI%20Edit%20Virtual%20Agent%20Page.png){height="" width=""} 1. To open the **Edit virtual agent** page, do one of the following: * On the **Vapi AI** page, click the **Assistant settings** tab, then click the name of the virtual agent in the **Assigned virtual agent** section. * In {{variable.BrandName}}, navigate to **Users > Users** and click the Virtual agent's name . 2. Assign an extension and save. The Vapi AI assistant is now available to be used as a routing target in [Flow Builder](/v1/docs/inbound-flow-builder-overview). :::(Info) (Tip) It is not necessary to assign an extension if your virtual assistant will only be used in [Dialer campaigns](/v1/docs/outbound-dialer-campaigns-overview). ::: {{snippet.addingMoreVirtualAgents}} ## Managing your integration To manage an existing Vapi integration, navigate to **Administration > Integrations** and click the **Vapi AI** tile. On the **Vapi AI** integration page, you can reconnect an integration that has lost connection or disconnect a connected integration. Click the **Edit connection** button and select either **Reconnect** or **Disconnect**. ### Reconnecting a Vapi AI integration Use reconnect when: * The integration was disconnected manually * The Vapi API key has changed or expired * There was an error during a previous connection attempt To reconnect: 1. On the **Vapi AI** integration page, click **Edit connection**, then select **Reconnect**. 2. Follow the on screen instructions to validate your Vapi API key and complete the connection. ### Disconnecting a Vapi AI integration To disconnect the integration: 1. On the **Vapi AI** integration page, click **Edit connection**, then select **Disconnect**. 2. In the **Disconnect integration** panel, click **Disconnect** to remove the integration from your contact center. After you disconnect, the Vapi AI integration state returns to **Not connected** and the integration card no longer shows assistant details until you connect again. ### Assistant settings The **Vapi AI** page **Assistant settings** tab enables you to rename your assistant or modify the Assistant prompt or description. ![Integrations Vapi AI Integration Page Assistant Settings Tab](https://cdn.document360.io/44ae307a-3737-4fbf-98e0-9b888deb90dc/Images/Documentation/Integrations%20Vapi%20AI%20Integration%20Page%20Assistant%20Settings%20Tab.png){height="" width=""} ## Use Cases ### Using the Vapi AI Virtual assistant in Flow Builder Once the integration is connected and the Virtual agent is created: * The Virtual agent appears as a routing option in [Flow Builder](/v1/docs/flow-builder-route) * You can use the Virtual agent wherever you would route calls to a user ![Integration Vapi AI Flow Builder Route To Agent](https://cdn.document360.io/44ae307a-3737-4fbf-98e0-9b888deb90dc/Images/Documentation/Integration%20Vapi%20AI%20Flow%20Builder%20Route%20To%20Agent.png){height="" width=""} For more information about configuring flows, see the [Flow Builder documentation](/v1/docs/inbound-flow-builder-overview). ### Using the Vapi Virtual agent in Dialer campaigns You can use the Vapi AI assistant for outbound calling: * Add the Vapi AI Virtual agent to a [Dialer campaign](/v1/docs/outbound-dialer-adding-a-new-campaign) so that it can handle outbound calls * Virtual agents created from Vapi AI assistants can join Dialer campaigns and handle outbound calls without manual intervention ![Integration Vapi AI Dialer Campaign Virtual Agent Assignment](https://cdn.document360.io/44ae307a-3737-4fbf-98e0-9b888deb90dc/Images/Documentation/Integration%20Vapi%20AI%20Dialer%20Campaign%20Virtual%20Agent%20Assignment.png){height="" width=""} For more information about Dialer campaigns, see the [Dialer campaign documentation](/v1/docs/outbound-dialer-campaigns-overview). ## Related - [Flow Builder Overview](/inbound-flow-builder-overview.md) - [Route](/flow-builder-route.md) - [Users](/users-users.md) - [Virtual agents](/virtual-agents.md) - [Dialer campaigns overview](/outbound-dialer-campaigns-overview.md) - [Adding a new campaign](/outbound-dialer-adding-a-new-campaign.md)