Quickstart

Get your AI voice agent live on real phone numbers in minutes. Follow these steps to provision your first number and bind it to your AI agent.

Overview

In this quickstart, you'll:

Buy a phone number.
Connect AI agent service provider
Create agent endpoint.
Bind phone number to the AI agent.
Make your first call.

Prerequisites

A KrosAI account and API key.

1) Buy a Phone Number

POST /v1/phone-numbers HTTP/1.1
Host: api.krosai.com
Authorization: Bearer YOUR_SECRET_TOKEN
Content-Type: application/json
Accept: */*
Content-Length: 55

{
  "inventory_id": "770e8400-e29b-41d4-a716-446655440002"
}

2) Connect AI agent service provider

3) Create Agent Endpoint

POST /v1/endpoints HTTP/1.1
Host: api.krosai.com
Authorization: Bearer YOUR_SECRET_TOKEN
Content-Type: application/json
Accept: */*
Content-Length: 107

{
  "name": "Sales Agent",
  "type": "vapi",
  "provider_config": {
    "api_key": "vapi_xxxx",
    "assistant_id": "asst_abc123"
  }
}

4) Bind phone number to the AI agent

POST /v1/endpoints HTTP/1.1
Host: api.krosai.com
Authorization: Bearer YOUR_SECRET_TOKEN
Content-Type: application/json
Accept: */*
Content-Length: 107

{
  "name": "Sales Agent",
  "type": "vapi",
  "provider_config": {
    "api_key": "vapi_xxxx",
    "assistant_id": "asst_abc123"
  },
  "phone_number_id": "edeuxxxxxx
}

4) 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.

Last updated 21 days ago

Good evening

hashtagOverview

hashtagPrerequisites

hashtag1) Buy a Phone Number

hashtag2) Connect AI agent service provider

hashtag3) Create Agent Endpoint

hashtag4) Bind phone number to the AI agent

hashtag4) Make your first calls