Začínáme

Quickstart

Nejdřív připoj svého AI asistenta nebo aplikaci a ověř spojení bez volání. Potom pokračuj podle práce, kterou chceš vyřídit: faktury, termíny, SMS, příchozí hovory nebo vlastní úkol.

1Založ si účet

Registrace trvá minutu a je zdarma, kartu k ní nepotřebuješ. Po ověření e-mailu ti na účet přistane 50,00 Kč kreditu - to stačí na koupi čísla i pár zkušebních hovorů (SMS jdou až po prvním dobití). Zapomenuté heslo si kdykoli obnovíš přes odkaz na přihlašovací stránce, klasickým e-mailem s odkazem na nastavení nového.

2Otevři připojení asistenta

V portálu otevři sekci AI asistent a zvol připojení přes OAuth. Claude Code, Codex CLI a Codex desktop umějí otevřít přihlášení; pro jiného klienta zůstává připravená varianta s existujícím API klíčem.

3Připoj se - MCP nebo REST API

MCP připojí nástroje volai přímo do tvého asistenta. REST API se hodí pro vlastní aplikaci. Obě cesty používají stejný účet a klíč; podporované akce a jejich omezení najdeš níže v mapě schopností.

AI asistent přes MCP

Jeden příkaz pro Claude Code (instalace pro Cursor, Windsurf, VS Code a Claude Desktop je na stránce MCP server):

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

Ověř spojení bez volání

Vlož do nového chatu v připojeném asistentovi toto zadání. Připojení je hotové až po skutečném read-only načtení přes `get_balance` a `list_agents`; kvůli ověření není potřeba volat, posílat SMS ani kupovat číslo.

Připoj mi volai jako MCP server na https://volai.cz/mcp podle návodu https://volai.cz/SKILL.md. Pokud už je připojený, použij existující připojení. Pokud můžeš spravovat MCP v tomto prostředí, připrav konfiguraci; jinak mě veď konkrétními kroky. Použij přihlášení přes volai, přihlášení a souhlas nech na mně. Nežádej API klíč do chatu. Pak ověř spojení pomocí get_balance a list_agents. Nic dalšího neměň, nikomu nevolej, neposílej zprávy ani nic nekupuj.

Vlastní aplikace přes REST API

Ověř klíč jedním dotazem na zůstatek kreditu:

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

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

4Volitelně: vyber další práci

Po ověření pokračuj podle svého cíle. Můžeš použít průvodce, webový portál, REST API nebo vlastní MCP zadání; ukázky níže jsou inspirace, ne povinný první úkol.

Ukázková čísla a ID nahraď vlastními. Odpovědi níže ukazují podstatná pole; úplné tvary najdeš v REST referenci. U placené akce použij pro její opakování stejný Idempotency-Key, pro novou akci nový.

Volitelně: zkus hlas skutečným hovorem

Tohle je nejrychlejší způsob, jak volai slyšet na vlastní uši: jeden požadavek a za pár vteřin ti zazvoní telefon. Žádné kupování čísla, žádné zakládání agenta - stačí napsat, co má agent dělat, do systemPrompt místo agentId. Hovor jde ze sdíleného demo čísla volai.

curl -X POST https://volai.cz/v1/calls \
  -H "Authorization: Bearer vk_TVUJ_KLIC" \
  -H "Idempotency-Key: REPLACE_WITH_UNIQUE_CALL_REQUEST_ID" \
  -H "Content-Type: application/json" \
  -d '{
    "to": "+420777123456",
    "systemPrompt": "Jsi recepční kavárny Nula. Pozdrav, zeptej se, co si dá, a objednávku zopakuj."
  }'

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

Volitelně: pošli SMS

Odešli textovku na libovolné české nebo slovenské mobilní číslo (do jiných zemí SMS neposíláme). SMS jdou až po prvním dobití kreditu, uvítací kredit na ně použít nejde. Odpověď ale nečekej - na sdílené jméno odesílatele SMSinfo příjemce odpovědět nemůže a hlasová čísla volai SMS nepřijímají (příjem SMS a odesílání z vlastního čísla umí doplněk SMS číslo, viz sekce SMS čísla v dokumentaci API):

curl -X POST https://volai.cz/v1/messages \
  -H "Authorization: Bearer vk_TVUJ_KLIC" \
  -H "Idempotency-Key: REPLACE_WITH_UNIQUE_SMS_REQUEST_ID" \
  -H "Content-Type: application/json" \
  -d '{"to": "+420777123456", "body": "Ahoj z volai! - Moje Appka"}'

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

Volitelně: pořiď číslo pro příchozí hovory

Nejdřív číslo z volné zásoby - prázdné tělo {} ti přiřadí číslo z výchozí nabídky Praha. Pro konkrétní nabídku použij region nebo vyber e164 přes GET /v1/numbers/available. Nákup ihned strhne poplatek za první období:

curl -X POST https://volai.cz/v1/numbers \
  -H "Authorization: Bearer vk_TVUJ_KLIC" \
  -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
  }
}

Teď na to číslo pověs agenta - stačí jméno, systémový prompt a číslo z kroku výš:

curl -X POST https://volai.cz/v1/agents \
  -H "Authorization: Bearer vk_TVUJ_KLIC" \
  -H "Idempotency-Key: REPLACE_WITH_UNIQUE_AGENT_REQUEST_ID" \
  -H "Content-Type: application/json" \
  -d '{
    "name": "Recepční",
    "systemPrompt": "Jsi recepční kavárny Nula. Přijímáš objednávky na vyzvednutí a odpovídáš na otázky o otevírací době (8-18, po-pá). Nikdy nevymýšlej ceny, které neznáš. Hovor ukonči shrnutím objednávky.",
    "numberE164": "+420210123456"
  }'

{
  "id": "ag_kx91fa2b"
}

A je to - zavolej si na svoje nové číslo. Agent by to měl zvednout do pár vteřin a mluvit přesně tak, jak jsi mu napsal do systemPrompt.

Mapa schopností

Přehled oblastí a dostupných funkcí. U REST a MCP je počet podporovaných funkcí z těch, které dané rozhraní nabízí. Záměrné výjimky, například vytvoření přístupu pouze v portálu, vysvětluje reference.

Úplný seznam je v REST API referenci a v seznamu nástrojů na MCP .