Začínáme

Quickstart

Od registrace po hovor s vlastním hlasovým agentem za pět minut. Každý krok je jeden příkaz - zkopíruj, vlož, spusť.

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 testovacích SMS a hovorů.

2Vytvoř si API klíč

V portálu jdi do sekce API a MCP a klikni na Vytvořit klíč. Klíč má tvar vk_... a zobrazí se jen jednou - v databázi se ukládá jen jeho otisk (hash), takže ho později nedokážeme zobrazit zpátky ani my. Zkopíruj si ho hned.

3Připoj se - MCP nebo REST API

Vyber si jednu variantu, klidně obě. Pro práci v AI editoru je nejrychlejší MCP - editor si sám najde všech 16 nástrojů a použije je, když to dává smysl v konverzaci. Pro vlastní aplikaci sáhni rovnou po REST API.

Varianta A - MCP server

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 volai https://volai.cz/mcp \
  --header "Authorization: Bearer vk_TVUJ_KLIC"

Varianta B - REST API (curl)

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

4Pošli první SMS

Odešli textovku na libovolné české nebo slovenské číslo (jen tahle dvě jsou v MVP podporovaná). Odpověď ale v API nečekej - příchozí SMS operátor předává jen na SIM kartu, ne k nám:

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

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

5Kup číslo a nastav hlasového agenta

Nejdřív číslo z volné zásoby - prázdné tělo {} ti přiřadí kterékoli volné:

curl -X POST https://volai.cz/v1/numbers \
  -H "Authorization: Bearer vk_TVUJ_KLIC" \
  -H "Content-Type: application/json" \
  -d '{}'

{
  "number": {
    "e164": "+420601234567",
    "routing": { "mode": "none" },
    "monthlyFeeHal": 2500,
    "boughtAt": 1756111640000
  }
}

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 "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": "+420601234567"
  }'

{
  "id": "agent_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.