# Phone Calls

#### Overview

With KrosAI, you can:

* Buy and assign a **local phone number** to an AI agent.
* Receive inbound and outbound calls.
* Enable real-time, voice-based conversations powered by AI.
* Control call behavior using agent configuration and tools.
* Record and analyze your call history.

In this guide, you'll learn to:

* Create your KrosAI account and API key
* Purchase a phone number
* Connect an AI endpoint (ElevenLabs, Vapi, or custom)
* Make your first calls :call\_me:

#### Prerequisites

* A KrosAI account 
* An AI voice provider account (ElevenLabs, Vapi, or Retell)

#### Create your account

{% stepper %}
{% step %}
 Go to [https://cockpit.krosai.com](https://cockpit.krosai.com/) and create your account.

<figure><img src="/files/LGiAckHimtiWHbPHlZmO" alt=""><figcaption></figcaption></figure>
{% endstep %}

{% step %}
&#x20;Complete identity verification (required for phone numbers). This takes about 2 minutes.
{% endstep %}

{% step %}
&#x20;Add credits to your account.

<figure><img src="/files/42AJb5ALnBJxXHeThwlN" alt=""><figcaption></figcaption></figure>
{% endstep %}
{% endstepper %}

#### Create an API key

{% stepper %}
{% step %}
Navigate to **Developers** → **API Keys**
{% endstep %}

{% step %}
Click Create Key
{% endstep %}

{% step %}
Name it fo example *My First Key*
{% endstep %}

{% step %}
&#x20;Select scopes: `numbers:read`  `numbers:write`  `calls:read`  `calls:write`

<figure><img src="/files/EJxGXE83CQz6FQF5Fx6Q" alt=""><figcaption></figcaption></figure>
{% endstep %}

{% step %}
Copy and save your key securely—it's only shown once

<figure><img src="/files/6Ht2S9rfZqfFgn7H1aNK" alt=""><figcaption></figcaption></figure>
{% endstep %}
{% endstepper %}

#### Purchase a phone number

{% stepper %}
{% step %}
Navigate to **Phone Numbers** → **Buy Number**

<figure><img src="/files/zF4xEVNKtnDHfWCpaICd" alt=""><figcaption></figcaption></figure>
{% endstep %}

{% step %}
Select your country (e.g., Nigeria, Kenya, UAE)
{% endstep %}

{% step %}
Choose a number from the available inventory
{% endstep %}

{% step %}
Click Purchase
{% endstep %}
{% endstepper %}

#### &#x20;Connect AI agent service provider

<figure><img src="/files/2Z9vxZPCNq1WM3CLue8g" alt=""><figcaption></figcaption></figure>

#### Create an endpoint

{% hint style="info" %}
An endpoint defines where inbound calls are routed—typically your AI voice agent.
{% endhint %}

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

{% stepper %}
{% step %}
Navigate to **Endpoints** → **Create Endpoint**
{% endstep %}

{% step %}
Select your provider (ElevenLabs, Vapi, Retell, or Webhook)
{% endstep %}

{% step %}
Enter your provider credentials — either Agent ID or Webhook Url
{% endstep %}

{% step %}
Attach endpoint to phone number
{% endstep %}

{% step %}
Click create
{% endstep %}
{% endstepper %}

#### Make your first call

🎉 Congratulations! You’re all set. Simply call your new phone number from any phone. Your AI agent will answer!


---

# 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/core-concepts/phone-calls.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.