Първи стъпки

Quickstart

Първо свържете своя AI асистент или приложение и проверете връзката без обаждане. После продължете според работата, която искате да свършите: фактури, срещи, SMS, входящи обаждания или собствена задача.

1Създайте си акаунт

Регистрацията отнема минута и е безплатна, карта не Ви трябва. След потвърждение на имейла в акаунта Ви постъпват 50.00 CZK (~EUR 2.08) баланс - достатъчно за купуване на номер и няколко пробни обаждания (SMS се изпращат едва след първото зареждане). Забравената парола можете да възстановите по всяко време чрез връзката на страницата за вход - с обикновен имейл с връзка за задаване на нова.

2Отворете връзката на асистента

В портала отворете раздела AI асистент и изберете връзка през OAuth. Claude Code, Codex CLI и Codex desktop могат да отворят вход; за друг клиент остава подготвен вариантът със съществуващ API ключ.

3Свържете се - MCP или REST API

MCP свързва инструментите на volai директно с Вашия асистент. REST API е подходящо за собствено приложение. И двата пътя ползват един и същ акаунт и ключ; поддържаните действия и ограниченията им ще намерите по-долу в картата на възможностите.

AI асистент през MCP

Една команда за Claude Code (инсталирането за Cursor, Windsurf, VS Code и Claude Desktop е на страницата MCP сървър):

claude mcp add --transport http --scope user volai 'https://volai.cz/mcp'
claude mcp login volai

Проверете връзката без обаждане

Поставете тази задача в нов чат в свързания асистент. Връзката е готова едва след реално четене през `get_balance` и `list_agents`; за проверката не е нужно да се обаждате, да изпращате SMS или да купувате номер.

Connect volai as an MCP server at https://volai.cz/mcp using the guide at https://volai.cz/SKILL.md. If it is already connected, use the existing connection. If you can manage MCP in this environment, prepare the configuration; otherwise guide me through the specific steps. Use sign-in through volai, and leave sign-in and consent to me. Do not ask for an API key in chat. Then verify the connection using get_balance and list_agents. Change nothing else, make no calls, send no messages and buy nothing.

Собствено приложение през REST API

Проверете ключа с една заявка за баланса:

curl https://volai.cz/v1/balance \
  -H "Authorization: Bearer vk_YOUR_KEY"

{
  "balanceHal": 5000,
  "balanceCzk": 50.00,
  "currency": "CZK"
}

4По избор: изберете следваща работа

След проверката продължете според целта си. Можете да използвате ръководството, уеб портала, REST API или собствена MCP задача; примерите по-долу са вдъхновение, а не задължителна първа задача.

Примерните номера и ID заменете със свои. Отговорите по-долу показват същественото; пълните структури ще намерите в REST референцията. При платено действие използвайте за повторението му същия Idempotency-Key, а за ново действие - нов.

По избор: изпробвайте гласа с реално обаждане

Това е най-бързият начин да чуете volai със собствените си уши: една заявка и след броени секунди телефонът Ви звъни. Без купуване на номер, без създаване на агент - достатъчно е да напишете какво да прави агентът в systemPrompt вместо agentId. Обаждането идва от общия демо номер на volai.

curl -X POST https://volai.cz/v1/calls \
  -H "Authorization: Bearer vk_YOUR_KEY" \
  -H "Idempotency-Key: REPLACE_WITH_UNIQUE_CALL_REQUEST_ID" \
  -H "Content-Type: application/json" \
  -d '{
    "to": "+420777123456",
    "systemPrompt": "Ти си рецепционистът на кафене Нула. Поздрави, попитай какво желае клиентът и повтори поръчката."
  }'

{
  "id": "c_8f2ac1d4x7qz",
  "status": "initiated",
  "trial": true,
  "from": "+420266266641"
}

По избор: изпратете SMS

Изпратете съобщение на произволен чешки или словашки мобилен номер (до други държави не изпращаме SMS). SMS се изпращат едва след първото зареждане на баланса, приветственият баланс не може да се използва за тях. Не очаквайте обаче отговор - на общото име на изпращача SMSinfo получателят не може да отговори, а гласовите номера на volai не получават SMS (получаване на SMS и изпращане от собствен номер умеят добавката мобилен номер и номерът: номер за обаждания и SMS, вижте раздела Мобилни номера и раздела Номер за обаждания и SMS в документацията на API):

curl -X POST https://volai.cz/v1/messages \
  -H "Authorization: Bearer vk_YOUR_KEY" \
  -H "Idempotency-Key: REPLACE_WITH_UNIQUE_SMS_REQUEST_ID" \
  -H "Content-Type: application/json" \
  -d '{"to": "+420777123456", "body": "Поздрави от volai! - Моето приложение"}'

{
  "id": "msg_7c1f9a2e",
  "status": "sent",
  "priceHal": 136,
  "segments": 1
}

По избор: осигурете си номер за входящи обаждания

Първо номер от свободния запас - празно тяло {} Ви присвоява номер от стандартното предложение Прага. За конкретно предложение използвайте region или изберете e164 през GET /v1/numbers/available. Покупката веднага удържа таксата за първия период:

curl -X POST https://volai.cz/v1/numbers \
  -H "Authorization: Bearer vk_YOUR_KEY" \
  -H "Idempotency-Key: REPLACE_WITH_UNIQUE_NUMBER_REQUEST_ID" \
  -H "Content-Type: application/json" \
  -d '{}'

{
  "number": {
    "e164": "+420210123456",
    "routing": { "mode": "none", "hasSipPassword": false },
    "monthlyFeeHal": 2500,
    "boughtAt": 1756111640000,
    "region": "praha",
    "regionLabel": "Prague",
    "billingMonths": 1
  }
}

Сега закачете агент към този номер - достатъчни са име, системен промпт и номерът от предишната стъпка:

curl -X POST https://volai.cz/v1/agents \
  -H "Authorization: Bearer vk_YOUR_KEY" \
  -H "Idempotency-Key: REPLACE_WITH_UNIQUE_AGENT_REQUEST_ID" \
  -H "Content-Type: application/json" \
  -d '{
    "name": "Рецепционист",
    "systemPrompt": "Ти си рецепционистът на кафене Нула. Приемаш поръчки за вземане и отговаряш на въпроси за работното време (8-18, пон-пет). Никога не измисляй цени, които не знаеш. Приключи разговора с обобщение на поръчката.",
    "numberE164": "+420210123456"
  }'

{
  "id": "ag_kx91fa2b"
}

Това е всичко - обадете се на новия си номер. Агентът трябва да вдигне след броени секунди и да говори точно така, както сте му написали в systemPrompt.

Карта на възможностите

Преглед на областите и наличните функции. При REST и MCP броят показва поддържаните функции от тези, които съответният интерфейс предлага. Умишлените изключения, например създаване на достъп само в портала, са обяснени в референцията.

Пълният списък е в референцията на REST API и в списъка с инструменти на страницата MCP .