Alustamine

Quickstart

Kõigepealt ühendage oma tehisintellekti assistent või rakendus ja kontrollige ühendust ilma helistamata. Seejärel jätkake vastavalt tööle, mida soovite ära teha: arved, kokkusaamised, SMS-id, sissetulevad kõned või oma ülesanne.

1Looge konto

Registreerumine võtab minuti, on tasuta ja kaarti ei vaja. Pärast e-posti kinnitamist laekub teie kontole 50,00 kr (≈ 2,08 EUR) saldot - see piisab numbri ostmiseks ja paariks proovikõneks (SMS-id on võimalikud alles pärast esimest täiendamist). Unustatud parooli saate igal ajal lähtestada sisselogimislehel oleva lingi kaudu - tavalise e-kirjaga, mis sisaldab uue parooli seadmise linki.

2Avage assistendi ühendus

Avage portaalis jaotis Tehisintellekti assistent ja valige ühendus OAuthi kaudu. Claude Code, Codex CLI ja Codex desktop oskavad sisselogimise avada; muu kliendi jaoks on olemas variant olemasoleva API-võtmega.

3Ühendage - MCP või REST API

MCP toob volai tööriistad otse teie assistenti. REST API sobib oma rakenduse jaoks. Mõlemad teed kasutavad sama kontot ja võtit; toetatud toimingud ja nende piirangud leiate allpool võimekuste kaardilt.

Tehisintellekti assistent MCP kaudu

Üks käsk Claude Code'i jaoks (paigaldus Cursori, Windsurfi, VS Code'i ja Claude Desktopi jaoks on lehel MCP-server):

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

Kontrollige ühendust ilma helistamata

Kleepige see ülesanne uude vestlusesse ühendatud assistendis. Ühendus on valmis alles pärast tegelikku kirjutuskaitstud lugemist käskudega `get_balance` ja `list_agents`; kontrollimiseks ei ole vaja helistada, SMS-e saata ega numbrit osta.

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.

Oma rakendus REST API kaudu

Kontrollige võtit ühe päringuga saldo kohta:

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

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

4Valikuline: valige järgmine töö

Pärast kontrolli jätkake vastavalt oma eesmärgile. Võite kasutada juhendit, veebiportaali, REST API-t või oma MCP ülesannet; allolevad näited on inspiratsiooniks, mitte kohustuslik esimene ülesanne.

Asendage näitenumbrid ja ID-d oma omadega. Allolevad vastused näitavad olulisi välju; täielikud vormid leiate REST viitest. Tasulise toimingu kordamisel kasutage sama Idempotency-Key väärtust, uue toimingu jaoks uut.

Valikuline: proovige häält päris kõnega

See on kiireim viis volait oma kõrvadega kuulda: üks päring ja mõne sekundi pärast heliseb teie telefon. Numbrit ei pea ostma, agenti ei pea looma - piisab, kui kirjutate, mida agent peab tegema, kohta systemPrompt asemel agentId. Kõne tuleb volai ühiselt demonumbrilt.

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": "Sa oled kohvik Nula vastuvõtja. Tervita, küsi, mida soovitakse, ja korda tellimus üle."
  }'

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

Valikuline: saatke SMS

Saatke tekstisõnum mis tahes Tšehhi või Slovakkia mobiilinumbrile (teistesse riikidesse SMS-e ei saada). SMS-id on võimalikud alles pärast saldo esimest täiendamist, tervitussaldot nende jaoks kasutada ei saa. Vastust aga ärge oodake - ühisele saatjanimele SMSinfo saaja vastata ei saa ja volai häälnumbrid SMS-e vastu ei võta (SMS-ide vastuvõttu ja saatmist oma numbrilt oskavad mobiilinumbri lisateenus ning number kõnede ja SMS-ide jaoks, vt Mobiilinumbrite jaotist ja jaotist Number kõnede ja SMS-ide jaoks API dokumentatsioonis):

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": "Tere volaist! - Minu rakendus"}'

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

Valikuline: hankige number sissetulevate kõnede jaoks

Kõigepealt number vabast varust - tühi sisu {} määrab teile numbri vaikepakkumisest Praha. Konkreetse pakkumise jaoks kasutage region või valige e164 päringuga GET /v1/numbers/available. Ost arvestab esimese perioodi tasu kohe maha:

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

Nüüd riputage sellele numbrile agent - piisab nimest, süsteemiviibast ja eelmise sammu numbrist:

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": "Vastuvõtja",
    "systemPrompt": "Sa oled kohvik Nula vastuvõtja. Võtad vastu kaasavõtutellimusi ja vastad küsimustele lahtiolekuaegade kohta (8-18, E-R). Ära kunagi mõtle välja hindu, mida sa ei tea. Lõpeta kõne tellimuse kokkuvõttega.",
    "numberE164": "+420210123456"
  }'

{
  "id": "ag_kx91fa2b"
}

Ongi kõik - helistage oma uuele numbrile. Agent peaks vastama mõne sekundi jooksul ja rääkima täpselt nii, nagu te talle kirjutasite kohta systemPrompt.

Võimekuste kaart

Ülevaade valdkondadest ja saadaolevatest funktsioonidest. REST-i ja MCP puhul on toetatud funktsioonide arv nende seast, mida vastav liides pakub. Tahtlikke erandeid, näiteks juurdepääsu loomist ainult portaalis, selgitab viide.

Täielik loetelu on REST API viites ja tööriistade loetelus lehel MCP .