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

• Vapi account with an assistant created

• At least one KrosAI phone number

Setup Steps

1

Get Your Vapi Assistant ID

• Log into your Vapi Dashboard

• Navigate to Assistants

• Select your assistant

• Copy the Assistant ID from the URL or settings

2

Connect Vapi in KrosAI

• Go to Settings → Integrations in your KrosAI Dashboard

• Click Connect next to Vapi

• Enter your Vapi API Key

• Click Save & Test

3

Create a Vapi Endpoint

Create Vapi Endpoint

curl -X POST "https://api.krosai.com/v1/endpoints" \
  -H "x-api-key: kros_live_your_key" \
  -H "Content-Type: application/json" \
  -d '{
    "name": "Vapi Sales Assistant",
    "type": "agent",
    "url": "sip:[email protected]",
    "provider_config": {
      "provider": "vapi",
      "assistant_id": "your-vapi-assistant-id"
    }
  }'

4

Attach to Phone Number

Attach Endpoint to Phone Number

curl -X PATCH "https://api.krosai.com/v1/phone-numbers/pn_abc123" \
  -H "x-api-key: kros_live_your_key" \
  -H "Content-Type: application/json" \
  -d '{
    "endpoint_id": "ep_vapi_xyz"
  }'

Configuration Options

Provider Config Fields

Field	Required	Description
assistant_id	Yes	Your Vapi assistant ID
assistant_overrides	No	Runtime overrides for the assistant

Assistant Overrides

Pass dynamic data to your Vapi assistant:

Assistant Overrides Example

{
  "provider_config": {
    "provider": "vapi",
    "assistant_id": "asst_123",
    "assistant_overrides": {
      "variableValues": {
        "customer_name": "John",
        "account_id": "ACC123"
      }
    }
  }
}

Outbound Calls

Initiate Outbound Call

curl -X POST "https://api.krosai.com/v1/outbound-calls" \
  -H "x-api-key: kros_live_your_key" \
  -H "Content-Type: application/json" \
  -d '{
    "from_number": "[phone]",
    "to_number": "[phone]",
    "endpoint_id": "ep_vapi_xyz",
    "metadata": {
      "campaign": "follow-up"
    }
  }'

Webhooks

Configure webhooks to receive call events:

Call Completed Webhook Example

{
  "event": "call.completed",
  "call_id": "call_abc123",
  "direction": "inbound",
  "from_number": "[phone]",
  "to_number": "[phone]",
  "duration": 180,
  "provider": "vapi",
  "assistant_id": "asst_123"
}

Troubleshooting

Call Not Connecting

• 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

Audio Issues

• Check your Vapi assistant's voice settings

• Verify SIP connectivity in Vapi dashboard

• Review call events for media errors

Assistant Not Responding

• Test the assistant directly in Vapi

• Check for LLM errors in Vapi logs

• Verify function calling permissions