Začíname

Quickstart

Najprv pripojte svojho AI asistenta alebo aplikáciu a overte spojenie bez volania. Potom pokračujte podľa práce, ktorú chcete vybaviť: faktúry, termíny, SMS, prichádzajúce hovory alebo vlastná úloha.

1Založte si účet

Registrácia trvá minútu a je zadarmo, kartu k nej nepotrebujete. Po overení e-mailu vám na účet pribudne 50.00 CZK (~EUR 2.08) kreditu - to stačí na kúpu čísla aj pár skúšobných hovorov (SMS idú až po prvom dobití). Zabudnuté heslo si kedykoľvek obnovíte cez odkaz na prihlasovacej stránke, klasickým e-mailom s odkazom na nastavenie nového.

2Otvorte pripojenie asistenta

V portáli otvorte sekciu AI asistent a zvoľte pripojenie cez OAuth. Claude Code, Codex CLI a Codex desktop vedia otvoriť prihlásenie; pre iného klienta ostáva pripravený variant s existujúcim API kľúčom.

3Pripojte sa - MCP alebo REST API

MCP pripojí nástroje volai priamo do vášho asistenta. REST API sa hodí pre vlastnú aplikáciu. Obe cesty používajú rovnaký účet a kľúč; podporované akcie a ich obmedzenia nájdete nižšie v mape schopností.

AI asistent cez MCP

Jeden príkaz pre Claude Code (inštalácia pre Cursor, Windsurf, VS Code a Claude Desktop je na stránke MCP server):

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

Overte spojenie bez volania

Vložte do nového chatu v pripojenom asistentovi toto zadanie. Pripojenie je hotové až po skutočnom read-only načítaní cez `get_balance` a `list_agents`; kvôli overeniu netreba volať, posielať SMS ani kupovať číslo.

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.

Vlastná aplikácia cez REST API

Overte kľúč jedným dopytom na zostatok kreditu:

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

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

4Voliteľne: vyberte ďalšiu prácu

Po overení pokračujte podľa svojho cieľa. Môžete použiť sprievodcu, webový portál, REST API alebo vlastné MCP zadanie; ukážky nižšie sú inšpirácia, nie povinná prvá úloha.

Ukážkové čísla a ID nahraďte vlastnými. Odpovede nižšie ukazujú podstatné polia; úplné tvary nájdete v REST referencii. Pri platenej akcii na jej opakovanie použite rovnaký Idempotency-Key, pre novú akciu nový.

Voliteľne: vyskúšajte hlas skutočným hovorom

Toto je najrýchlejší spôsob, ako volai počuť na vlastné uši: jedna požiadavka a za pár sekúnd vám zazvoní telefón. Žiadne kupovanie čísla, žiadne zakladanie agenta - stačí napísať, čo má agent robiť, do systemPrompt namiesto agentId. Hovor ide zo zdieľaného demo čísla 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 recepčný kaviarne Nula. Pozdrav, opýtaj sa, čo si dá, a objednávku zopakuj."
  }'

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

Voliteľne: pošlite SMS

Odošlite textovku na ľubovoľné české alebo slovenské mobilné číslo (do iných krajín SMS neposielame). SMS idú až po prvom dobití kreditu, uvítací kredit sa na ne použiť nedá. Odpoveď však nečakajte - na zdieľané meno odosielateľa SMSinfo príjemca odpovedať nemôže a hlasové čísla volai SMS neprijímajú (príjem SMS a odosielanie z vlastného čísla vie doplnok mobilné číslo aj číslo pre hovory aj SMS, pozrite sekciu Mobilné čísla a sekciu Čísla pro hovory i SMS v dokumentácii 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": "Ahoj z volai! - Moja appka"}'

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

Voliteľne: zaobstarajte si číslo pre prichádzajúce hovory

Najprv číslo z voľnej zásoby - prázdne telo {} vám pridelí číslo z predvolenej ponuky Praha. Pre konkrétnu ponuku použite region alebo vyberte e164 cez GET /v1/numbers/available. Nákup okamžite strhne poplatok za prvé obdobie:

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

Teraz na to číslo zavesíme agenta - stačí meno, systémový prompt a číslo z kroku vyššie:

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": "Recepčný",
    "systemPrompt": "Si recepčný kaviarne Nula. Prijímaš objednávky na vyzdvihnutie a odpovedáš na otázky o otváracom čase (8-18, po-pi). Nikdy nevymýšľaj ceny, ktoré nepoznáš. Hovor ukonči zhrnutím objednávky.",
    "numberE164": "+420210123456"
  }'

{
  "id": "ag_kx91fa2b"
}

A je to - zavolajte si na svoje nové číslo. Agent by to mal zdvihnúť do pár sekúnd a rozprávať presne tak, ako ste mu napísali do systemPrompt.

Mapa schopností

Prehľad oblastí a dostupných funkcií. Pri REST a MCP je počet podporovaných funkcií z tých, ktoré dané rozhranie ponúka. Zámerné výnimky, napríklad vytvorenie prístupu iba v portáli, vysvetľuje referencia.

Úplný zoznam je v REST API referencii a v zozname nástrojov na MCP .