Primii pași

Quickstart

Conectați mai întâi asistentul AI sau aplicația și verificați accesul fără a efectua un apel. Apoi continuați cu munca pe care doriți să o rezolvați: facturi, programări, SMS, apeluri primite sau o sarcină proprie.

1Creați-vă un cont

Înregistrarea durează un minut și este gratuită, nu aveți nevoie de card. După verificarea e-mailului primiți în cont 50.00 CZK (~EUR 2.08) credit - suficient pentru cumpărarea unui număr și câteva apeluri de test (SMS-urile merg abia după prima reîncărcare). Parola uitată o puteți reseta oricând prin linkul de pe pagina de autentificare, printr-un e-mail obișnuit cu un link pentru setarea unei parole noi.

2Deschideți conexiunea asistentului

În portal deschideți secțiunea Asistent AI și alegeți conectarea prin OAuth. Claude Code, Codex CLI și Codex desktop pot deschide autentificarea; pentru alt client rămâne disponibilă varianta cu o cheie API existentă.

3Conectați-vă - MCP sau API REST

MCP aduce instrumentele volai direct în asistentul dumneavoastră. API-ul REST se potrivește pentru propria aplicație. Ambele căi folosesc același cont și aceeași cheie; acțiunile acceptate și limitările lor le găsiți mai jos, în harta capabilităților.

Asistent AI prin MCP

O singură comandă pentru Claude Code (instalarea pentru Cursor, Windsurf, VS Code și Claude Desktop este pe pagina Server MCP):

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

Verificați conexiunea fără apeluri

Lipiți această sarcină într-un chat nou al asistentului conectat. Conexiunea este gata abia după o citire reală, doar pentru citire, prin `get_balance` și `list_agents`; pentru verificare nu este nevoie să efectuați apeluri, să trimiteți SMS sau să cumpărați un număr.

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.

Propria aplicație prin API-ul REST

Verificați cheia cu o singură interogare a soldului de credit:

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

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

4Opțional: alegeți următoarea lucrare

După verificare continuați în funcție de obiectivul dumneavoastră. Puteți folosi ghidul, portalul web, API-ul REST sau o sarcină MCP proprie; exemplele de mai jos sunt o sursă de inspirație, nu o primă sarcină obligatorie.

Înlocuiți numerele și ID-urile din exemple cu ale dumneavoastră. Răspunsurile de mai jos arată câmpurile esențiale; formele complete le găsiți în referința REST. Pentru o acțiune plătită folosiți același Idempotency-Key la repetarea ei, iar pentru o acțiune nouă unul nou.

Opțional: încercați vocea într-un apel real

Este cea mai rapidă cale de a auzi volai pe viu: o singură cerere și, după câteva secunde, vă sună telefonul. Fără cumpărarea unui număr, fără crearea unui agent - scrieți doar ce trebuie să facă agentul în systemPrompt în loc de agentId. Apelul pleacă de la numărul demo comun 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": "Esti receptionerul cafenelei Nula. Saluta, intreaba ce doreste clientul si repeta comanda."
  }'

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

Opțional: trimiteți un SMS

Trimiteți un SMS către orice număr mobil din Cehia sau Slovacia (în alte țări nu trimitem SMS). SMS-urile merg abia după prima reîncărcare a creditului, creditul de bun venit nu poate fi folosit pentru ele. Nu așteptați însă un răspuns - destinatarul nu poate răspunde numelui comun de expeditor SMSinfo, iar numerele vocale volai nu primesc SMS (primirea de SMS și trimiterea de pe un număr propriu le oferă suplimentul număr de mobil și număr pentru apeluri și SMS, vedeți secțiunea Numere de mobil și secțiunea Număr pentru apeluri și SMS din documentația 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": "Salut de la volai! - Aplicatia mea"}'

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

Opțional: obțineți un număr pentru apeluri primite

Mai întâi un număr din stocul liber - un corp gol {} vă atribuie un număr din oferta implicită Praga. Pentru o anumită ofertă folosiți region sau alegeți un e164 prin GET /v1/numbers/available. Cumpărarea percepe imediat taxa pentru prima perioadă:

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

Acum atașați un agent acelui număr - sunt suficiente un nume, un prompt de sistem și numărul de la pasul anterior:

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": "Receptioner",
    "systemPrompt": "Esti receptionerul cafenelei Nula. Preiei comenzi pentru ridicare si raspunzi la intrebari despre programul de functionare (8-18, luni-vineri). Nu inventa niciodata preturi pe care nu le cunosti. Incheie apelul cu un rezumat al comenzii.",
    "numberE164": "+420210123456"
  }'

{
  "id": "ag_kx91fa2b"
}

Gata - sunați la noul dumneavoastră număr. Agentul ar trebui să răspundă în câteva secunde și să vorbească exact așa cum i-ați scris în systemPrompt.

Harta capabilităților

Prezentare generală a domeniilor și a funcțiilor disponibile. Pentru REST și MCP, numărul indică funcțiile acceptate din cele pe care interfața respectivă le oferă. Excepțiile intenționate, de exemplu crearea accesului doar în portal, sunt explicate în referință.

Lista completă se află în referința API REST și în lista de instrumente de la MCP .