Darba sākšana

Quickstart

Vispirms pievienojiet savu AI asistentu vai lietotni un pārbaudiet savienojumu bez zvana. Pēc tam turpiniet ar darbu, ko vēlaties paveikt: rēķini, tikšanās, SMS, ienākošie zvani vai pašu uzdevums.

1Izveidojiet kontu

Reģistrācija aizņem minūti un ir bezmaksas, karte nav vajadzīga. Pēc e-pasta apstiprināšanas jūsu kontā tiks ieskaitīts 50.00 CZK (~EUR 2.08) kredīta - pietiek, lai nopirktu numuru un veiktu dažus izmēģinājuma zvanus (SMS ir pieejamas pēc pirmās papildināšanas). Aizmirstu paroli varat jebkurā brīdī atjaunot ar saiti pieteikšanās lapā - parastu e-pastu ar saiti jaunas paroles iestatīšanai.

2Atveriet asistenta savienojumu

Portālā atveriet sadaļu AI asistents un izvēlieties savienojumu ar OAuth. Claude Code, Codex CLI un Codex desktop var atvērt pieteikšanos; citam klientam paliek pieejams variants ar esošu API atslēgu.

3Pieslēdzieties - MCP vai REST API

MCP pievieno volai rīkus tieši jūsu asistentam. REST API der jūsu pašu lietotnei. Abi ceļi izmanto to pašu kontu un atslēgu; atbalstītās darbības un to ierobežojumi ir aprakstīti zemāk esošajā iespēju kartē.

AI asistents caur MCP

Viena komanda Claude Code (instalēšana Cursor, Windsurf, VS Code un Claude Desktop ir lapā MCP serveris):

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

Pārbaudiet savienojumu bez zvana

Ievietojiet šo uzdevumu jaunā tērzēšanā savā pieslēgtajā asistentā. Savienojums ir pabeigts tikai pēc faktiskas tikai lasīšanas darbības ar `get_balance` un `list_agents`; pārbaudei nav jāzvana, jāsūta SMS vai jāpērk numurs.

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.

Jūsu pašu lietotne caur REST API

Pārbaudiet atslēgu ar vienu pieprasījumu par kredīta atlikumu:

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

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

4Pēc izvēles: izvēlieties nākamo darbu

Pēc pārbaudes turpiniet atbilstoši savam mērķim. Varat izmantot ceļvedi, tīmekļa portālu, REST API vai savu MCP uzdevumu; zemāk redzamie piemēri ir iedvesmai, nevis obligāts pirmais uzdevums.

Piemēru numurus un ID aizstājiet ar savējiem. Zemāk redzamās atbildes rāda būtiskos laukus; pilnas formas atradīsiet REST atsaucē. Maksas darbības atkārtošanai izmantojiet to pašu Idempotency-Key, jaunai darbībai - jaunu.

Pēc izvēles: izmēģiniet balsi īstā zvanā

Tas ir ātrākais veids, kā volai sadzirdēt pašiem: viens pieprasījums, un pēc dažām sekundēm jums zvana tālrunis. Nav jāpērk numurs, nav jāveido aģents - pietiek uzrakstīt, ko aģentam jādara, laukā systemPrompt tā vietā, lai norādītu agentId. Zvans nāk no volai kopīgā demonstrācijas numura.

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": "Tu esi kafejnīcas Nula recepcionists. Sasveicinies, pajautā, ko klients vēlas, un pasūtījumu atkārto."
  }'

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

Pēc izvēles: nosūtiet SMS

Nosūtiet īsziņu uz jebkuru Čehijas vai Slovākijas mobilo numuru (uz citām valstīm SMS nesūtām). SMS ir pieejamas pēc pirmās kredīta papildināšanas, sveiciena kredītu tām izmantot nevar. Atbildi tomēr negaidiet - uz kopīgo sūtītāja vārdu SMSinfo adresāts atbildēt nevar, un volai balss numuri SMS nesaņem (SMS saņemšanu un sūtīšanu no sava numura nodrošina mobilā numura papildinājums un „numurs zvaniem un SMS”, sk. sadaļu Mobilie numuri un sadaļu „Numurs zvaniem un SMS” API dokumentācijā):

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": "Sveiciens no volai! - Mana lietotne"}'

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

Pēc izvēles: iegūstiet numuru ienākošajiem zvaniem

Vispirms numurs no brīvā krājuma - tukšs pamatteksts {} piešķirs numuru no noklusējuma Prāgas piedāvājuma. Konkrētam piedāvājumam izmantojiet region vai izvēlieties e164 ar GET /v1/numbers/available. Pirkums uzreiz ieņem maksu par pirmo periodu:

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
  }
}

Tagad piesaistiet šim numuram aģentu - pietiek ar vārdu, sistēmas promptu un numuru no iepriekšējā soļa:

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": "Recepcionists",
    "systemPrompt": "Tu esi kafejnīcas Nula recepcionists. Pieņem pasūtījumus saņemšanai uz vietas un atbildi uz jautājumiem par darba laiku (8-18, pirmdien-piektdien). Nekad neizdomā cenas, kuras nezini. Zvanu beidz, apkopojot pasūtījumu.",
    "numberE164": "+420210123456"
  }'

{
  "id": "ag_kx91fa2b"
}

Tas arī viss - piezvaniet uz savu jauno numuru. Aģentam vajadzētu pacelt klausuli dažu sekunžu laikā un runāt tieši tā, kā jūs uzrakstījāt laukā systemPrompt.

Iespēju karte

Pārskats par jomām un pieejamajām funkcijām. REST un MCP gadījumā skaitlis rāda atbalstīto funkciju skaitu no tām, ko attiecīgā saskarne piedāvā. Apzinātus izņēmumus, piemēram, piekļuves izveidi tikai portālā, paskaidro atsauce.

Pilns saraksts ir REST API atsaucē un rīku sarakstā lapā MCP .