# Vapi

Connect your Vapi AI assistants to KrosAI phone numbers for emerging market coverage.

## Overview

Vapi is an AI voice assistant platform. With KrosAI, you can route calls from your African and Middle Eastern phone numbers to Vapi assistants.

## Prerequisites

* KrosAI account with verified KYC
* At least one KrosAI phone number
* Vapi account with an assistant created

## Setup Steps

{% stepper %}
{% step %}

### Configure SIP Trunk in Vapi

<figure><img src="/files/G75mosb48EUfWSfUbVcu" alt=""><figcaption></figcaption></figure>

* On your Vapi Dashobard navigate to [Intergrations](https://dashboard.vapi.ai/settings/integrations)
* Search for SIP Trunk and click on it.
* Click on Configure New SIP Trunk
* On KrosAI dashoard, open and copy the SIP credentials of your phone number.

<figure><img src="/files/qMbwJIYezTtBX5MCxIff" alt=""><figcaption></figcaption></figure>

* Fill the New Sip Trunk Form in Vapi with your KrosAI phone number SIP credential
* Note: Use the SIP crediential SIP IP Address instead of the SIP Domain
* Save SIP Trunk.
  {% endstep %}

{% step %}

### BYO KrosAI Phone Number to Vapi

<figure><img src="/files/e5xB1xH8Pcrn5D2ln6Fm" alt=""><figcaption></figcaption></figure>

* Open Phone number on Vapi Dashboard
* Click Create Phone Number
* Select BYO SIP Trunk Number
* Enter your KrosAI number with country code in the phone number field
* On the SIP Trunk Credential dropdown select the SIP Trunk you just created.
* Click of Import SIP Phone Number
  {% endstep %}

{% step %}

### Get Your Vapi Assistant ID

* On your Vapi Dashboard navigate to **Assistants**
* Select your assistant
* Copy the **Assistant ID**
  {% endstep %}

{% step %}

### Connect Vapi in KrosAI

<figure><img src="/files/LYJ3Ps44RcDmLfjQRJbr" alt=""><figcaption></figcaption></figure>

* Go to **Settings → Integrations** in your KrosAI Dashboard
* Click **Connect** next to Vapi
* Enter your Vapi API Key
* Click **Save & Test**
  {% endstep %}

{% step %}

### Create  Endpoint and Attach Phone Number

<figure><img src="/files/H6ZBVhsYBEu8CD5qwLM9" alt=""><figcaption></figcaption></figure>

* On your KrosAI dashboard click of Endpoints
* Click on Add Endpoint
* Enter a Name
* Select Vapi as your AI agent Provider
* Enter Vapi Assistant ID
* Enter your Vapi SIP Trunk Credential ID
* Select the phone number to attach
* Finally click create Endpoint
  {% endstep %}

{% step %}

### Make your first calls

🎉  Congratulations! You’ve successfully connected your local phone number to your AI agent. Call the number to start a conversation with your agent.
{% endstep %}
{% endstepper %}

## Troubleshooting

<details>

<summary>Call Not Connecting</summary>

* Verify your Vapi API key is correct
* Check the assistant ID exists
* Ensure the assistant is active in Vapi
* Review KrosAI Dashboard → Calls for error details

</details>

<details>

<summary>Audio Issues</summary>

* Check your Vapi assistant's voice settings
* Verify SIP connectivity in Vapi dashboard
* Review call events for media errors

</details>

<details>

<summary>Assistant Not Responding</summary>

* Test the assistant directly in Vapi
* Check for LLM errors in Vapi logs
* Verify function calling permissions

</details>


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.krosai.com/integration/vapi.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.