--- 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", "virtual", "virtual agent", "Vapi", "call routing", "voice flow", "Flow Builder", "route", "Dialer", "campaign"] updated: 2026-10-15T08:47:31Z published: 2026-10-15T08:47:31Z 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 **Who should read this article**: Administrators, Supervisors Integrate Vapi with Voiso to create an AI voice assistant as a Virtual agent and route calls to it through Workflow builder and Dialer campaigns. ## Introduction The Vapi AI integration lets you bring your own voice bot into Voiso. You can connect your Vapi account, have Voiso automatically create a Vapi AI assistant and a corresponding [Virtual agent](/v1/docs/virtual-agents), and then route calls to this bot in [Workflow 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. Voiso manages telephony, call routing, reporting, and overall contact center operations. 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 | Voiso 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 | Voiso automatically creates a Virtual agent linked to the Vapi assistant SIP address so you can treat the bot like any other user for routing. | | Workflow builder routing | Route inbound calls from your Voiso workflows 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, Voiso 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. [Video](https://cdn.document360.io/44ae307a-3737-4fbf-98e0-9b888deb90dc/Images/Documentation/BYOB%20Vapi%20AI%20Integration.mp4) ### Prerequisites Before connecting Vapi to Voiso, make sure you have: - Voiso 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 Voiso 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) 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) 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. Voiso 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**. Voiso 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) 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 Voiso, 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 [Workflow builder](/v1/docs/inbound-flow-builder-overview). 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). ## Adding more agents Once your initial agent has been created and tested you can add more agents, either individually or in bulk. Bulk upload of virtual agents is supported using a CSV file, while single virtual agents may be created on the **Users** page by navigating to **Administration > Users**, then clicking **Add user**. When the **Add user** panel appears, click **Virtual agent**. - For more information about creating a single virtual agent, refer to [Virtual agents](/v1/docs/virtual-agents). - For more information about creating multiple virtual agents using a CSV file, refer to [Adding bulk virtual agents](/v1/docs/virtual-agents#adding-bulk-virtual-agents). ## 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) ## Use Cases ### Using the Vapi AI Virtual assistant in Workflow builder Once the integration is connected and the Virtual agent is created: - The Virtual agent appears as a routing option in the [Route](/v1/docs/flow-builder-route) node in Workflow builder - 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) For more information about configuring workflows, see the [Workflow 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) For more information about Dialer campaigns, see the [Dialer campaign documentation](/v1/docs/outbound-dialer-campaigns-overview). ## Related - [Workflow 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)