Početak rada

Quickstart

Najprije povežite svojeg AI asistenta ili aplikaciju i provjerite vezu bez pozivanja. Zatim nastavite prema poslu koji želite obaviti: računi, termini, SMS, dolazni pozivi ili vlastiti zadatak.

1Otvorite račun

Registracija traje minutu i besplatna je, kartica vam ne treba. Nakon potvrde e-pošte na račun stiže 50,00 kr (≈ 2,08 EUR) stanja - to je dovoljno za kupnju broja i nekoliko probnih poziva (SMS-ovi idu tek nakon prve dopune). Zaboravljenu lozinku možete u bilo kojem trenutku obnoviti putem poveznice na stranici za prijavu, klasičnom e-porukom s poveznicom za postavljanje nove.

2Otvorite povezivanje asistenta

U portalu otvorite odjeljak AI asistent i odaberite povezivanje preko OAuth-a. Claude Code, Codex CLI i Codex desktop mogu otvoriti prijavu; za drugog klijenta ostaje spremna varijanta s postojećim API ključem.

3Povežite se - MCP ili REST API

MCP povezuje alate volai izravno u vašeg asistenta. REST API pogodan je za vlastitu aplikaciju. Oba puta koriste isti račun i ključ; podržane radnje i njihova ograničenja nalaze se niže u karti mogućnosti.

AI asistent preko MCP-a

Jedna naredba za Claude Code (instalacija za Cursor, Windsurf, VS Code i Claude Desktop nalazi se na stranici MCP poslužitelj):

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

Provjerite vezu bez pozivanja

Zalijepite ovaj zadatak u novi chat u povezanom asistentu. Povezivanje je gotovo tek nakon stvarnog read-only čitanja preko `get_balance` i `list_agents`; za provjeru nije potrebno zvati, slati SMS ni kupovati broj.

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.

Vlastita aplikacija preko REST API-ja

Provjerite ključ jednim upitom o stanju:

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

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

4Neobvezno: odaberite sljedeći posao

Nakon provjere nastavite prema svojem cilju. Možete upotrijebiti vodič, web portal, REST API ili vlastiti MCP zadatak; primjeri niže služe kao inspiracija, a ne kao obvezan prvi zadatak.

Primjere brojeva i ID-jeve zamijenite vlastitima. Odgovori niže prikazuju bitna polja; cjelovite oblike pronaći ćete u REST referenci. Pri ponavljanju plaćene radnje upotrijebite isti Idempotency-Key, za novu radnju novi.

Neobvezno: isprobajte glas u stvarnom pozivu

Ovo je najbrži način da volai čujete vlastitim ušima: jedan zahtjev i za nekoliko sekundi zazvonit će vam telefon. Bez kupnje broja, bez otvaranja agenta - dovoljno je napisati što agent treba raditi u polje systemPrompt umjesto agentId. Poziv dolazi sa zajedničkog demo broja 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": "Ti si recepcionar kafića Nula. Pozdravi, pitaj što želi naručiti i ponovi narudžbu."
  }'

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

Neobvezno: pošaljite SMS

Pošaljite poruku na bilo koji češki ili slovački mobilni broj (u druge zemlje SMS ne šaljemo). SMS-ovi idu tek nakon prve dopune stanja, stanje dobrodošlice za njih nije moguće iskoristiti. Odgovor ipak ne očekujte - na zajedničko ime pošiljatelja SMSinfo primatelj ne može odgovoriti, a glasovni brojevi volai ne primaju SMS (primanje SMS-a i slanje s vlastitog broja omogućuju dodatak mobilni broj i broj za pozive i SMS, pogledajte odjeljak Mobilni broj i odjeljak Broj za pozive i SMS u 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: nabavite broj za dolazne pozive

Najprije broj iz slobodne zalihe - prazno tijelo {} dodijelit će vam broj iz zadane praške ponude. Za određenu ponudu upotrijebite region ili odaberite e164 preko GET /v1/numbers/available. Kupnja odmah naplaćuje naknadu za prvo razdoblje:

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

Sada na taj broj postavite agenta - dovoljni su ime, sistemski prompt i broj iz prethodnog 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": "Recepcionar",
    "systemPrompt": "Ti si recepcionar kafića Nula. Primaš narudžbe za preuzimanje i odgovaraš na pitanja o radnom vremenu (8-18, pon-pet). Nikad ne izmišljaj cijene koje ne znaš. Poziv završi sažetkom narudžbe.",
    "numberE164": "+420210123456"
  }'

{
  "id": "ag_kx91fa2b"
}

I to je to - nazovite svoj novi broj. Agent bi se trebao javiti za nekoliko sekundi i govoriti točno onako kako ste mu napisali u systemPrompt.

Karta mogućnosti

Pregled područja i dostupnih funkcija. Kod REST-a i MCP-a broj podržanih funkcija odnosi se na one koje to sučelje nudi. Namjerne iznimke, primjerice izradu pristupa samo u portalu, objašnjava referenca.

Cjelovit popis nalazi se u REST API referenci i na popisu alata na stranici MCP .