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 2 € 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, prípadne do ďalšej krajiny z cenníka. 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 .