Začetek

Quickstart

Najprej povežite svojega pomočnika z umetno inteligenco ali aplikacijo in preverite povezavo brez klicanja. Nato nadaljujte glede na delo, ki ga želite opraviti: računi, termini, SMS, dohodni klici ali lastna naloga.

1Ustvarite račun

Registracija traja minuto in je brezplačna, kartice zanjo ne potrebujete. Po potrditvi e-pošte na račun prejmete 50.00 CZK (~EUR 2.08) dobroimetja - to zadostuje za nakup številke in nekaj preizkusnih klicev (SMS gredo šele po prvem polnjenju). Pozabljeno geslo kadar koli obnovite prek povezave na strani za prijavo, z navadno e-pošto s povezavo za nastavitev novega.

2Odprite povezavo pomočnika

V portalu odprite razdelek Pomočnik z umetno inteligenco in izberite povezavo prek OAuth. Claude Code, Codex CLI in Codex desktop znajo odpreti prijavo; za drugega odjemalca ostaja pripravljena različica z obstoječim ključem API.

3Povežite se - MCP ali REST API

MCP poveže orodja volai neposredno v vašega pomočnika. REST API je primeren za lastno aplikacijo. Obe poti uporabljata isti račun in ključ; podprta dejanja in njihove omejitve najdete spodaj v zemljevidu zmožnosti.

Pomočnik z umetno inteligenco prek MCP

En ukaz za Claude Code (namestitev za Cursor, Windsurf, VS Code in Claude Desktop je na strani Strežnik MCP):

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

Preverite povezavo brez klicanja

V nov klepet v povezanem pomočniku vstavite to navodilo. Povezava je končana šele s pravim branjem samo za branje prek `get_balance` in `list_agents`; zaradi preverjanja ni treba klicati, pošiljati SMS ali kupovati številke.

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.

Lastna aplikacija prek REST API

Ključ preverite z enim poizvedovanjem o stanju dobroimetja:

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

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

4Neobvezno: izberite nadaljnje delo

Po preverjanju nadaljujte glede na svoj cilj. Uporabite lahko vodnik, spletni portal, REST API ali lastno navodilo MCP; spodnji primeri so navdih, ne obvezna prva naloga.

Vzorčne številke in ID-je zamenjajte z lastnimi. Spodnji odgovori kažejo bistvena polja; popolne oblike najdete v referenci REST. Pri plačljivem dejanju za njegovo ponovitev uporabite isti Idempotency-Key, za novo dejanje novega.

Neobvezno: preizkusite glas z resničnim klicem

To je najhitrejši način, da volai slišite na lastna ušesa: ena zahteva in čez nekaj sekund vam zazvoni telefon. Brez nakupa številke, brez ustvarjanja agenta - dovolj je napisati, kaj naj agent počne, v systemPrompt namesto agentId. Klic gre s skupne demo številke 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": "Si receptor kavarne Nula. Pozdravi, vprašaj, kaj želi naročiti, in naročilo ponovi."
  }'

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

Neobvezno: pošljite SMS

Pošljite sporočilo na poljubno češko ali slovaško mobilno številko (v druge države SMS ne pošiljamo). SMS gredo šele po prvem polnjenju dobroimetja, pozdravnega dobroimetja zanje ni mogoče uporabiti. Odgovora pa ne pričakujte - na skupno ime pošiljatelja SMSinfo prejemnik ne more odgovoriti, glasovne številke volai pa SMS ne prejemajo (prejem SMS in pošiljanje z lastne številke znata dodatek mobilna številka in številka za klice in SMS, glejte razdelek Mobilne številke in razdelek Številka za klice in SMS v dokumentaciji API-ja):

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": "Pozdrav iz volai! - Moja aplikacija"}'

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

Neobvezno: pridobite številko za dohodne klice

Najprej številka iz proste zaloge - prazno telo {} vam dodeli številko iz privzete ponudbe Praga. Za določeno ponudbo uporabite region ali izberite e164 prek GET /v1/numbers/available. Nakup takoj zaračuna prispevek za prvo obdobje:

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

Zdaj na to številko obesite agenta - dovolj so ime, sistemski prompt in številka iz prejšnjega koraka:

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": "Receptor",
    "systemPrompt": "Si receptor kavarne Nula. Sprejemaš naročila za prevzem in odgovarjaš na vprašanja o odpiralnem času (8-18, pon-pet). Nikoli si ne izmišljaj cen, ki jih ne poznaš. Klic končaj s povzetkom naročila.",
    "numberE164": "+420210123456"
  }'

{
  "id": "ag_kx91fa2b"
}

In to je to - pokličite svojo novo številko. Agent naj bi dvignil v nekaj sekundah in govoril natanko tako, kot ste mu napisali v systemPrompt.

Zemljevid zmožnosti

Pregled področij in razpoložljivih funkcij. Pri REST in MCP je število podprtih funkcij izmed tistih, ki jih posamezen vmesnik ponuja. Namerne izjeme, na primer ustvarjanje dostopa samo v portalu, pojasnjuje referenca.

Celoten seznam je v referenci REST API in v seznamu orodij na MCP .