Kom i gang

Quickstart

Forbind først AI-assistenten eller appen, og kontrollér adgangen uden at ringe. Fortsæt derefter med det arbejde, der skal løses: fakturaer, aftaler, SMS, indgående opkald eller en egen opgave.

1Opret en konto

Oprettelsen tager et minut, er gratis, og kort er ikke nødvendigt. Efter bekræftelse af e-mailen lander 50.00 CZK (~EUR 2.08) af saldoen på kontoen - nok til at købe et nummer og foretage nogle testopkald (SMS kræver en første optankning). Et glemt kodeord kan altid nulstilles via et link på login-siden - en almindelig e-mail med et link til at angive et nyt.

2Åbn assistentadgangen

Åbn i portalen afsnittet AI-assistent og vælg OAuth. Claude Code, Codex CLI og Codex desktop kan åbne login; andre klienter kan bruge den eksisterende løsning med API-nøgle.

3Forbind - MCP eller REST API

MCP lægger volai-værktøjerne direkte ind i assistenten. REST API passer til en egen app. Begge veje bruger samme konto og nøgle; de understøttede handlinger og deres begrænsninger står i kapacitetskortet nedenfor.

AI-assistent via MCP

Én kommando til Claude Code (installation til Cursor, Windsurf, VS Code og Claude Desktop findes på siden MCP-server):

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

Kontrollér adgangen uden at ringe

Indsæt denne opgave i en ny chat i den forbundne assistent. Forbindelsen er først klar, når den faktisk har læst via `get_balance` og `list_agents`; til kontrollen er det ikke nødvendigt at ringe, sende SMS eller købe et nummer.

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.

Egen app via REST API

Kontrollér nøglen med en enkelt forespørgsel om saldoen:

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

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

4Valgfrit: vælg det næste arbejde

Fortsæt efter kontrollen efter det faktiske mål. Brug guiden, webportalen, REST API eller en egen MCP-opgave; eksemplerne nedenfor er inspiration, ikke en obligatorisk første opgave.

Eksempelnumre og ID'er erstattes af egne. Svarene nedenfor viser de væsentlige felter; de fulde former findes i REST-referencen. Ved gentagelse af en betalt handling bruges samme Idempotency-Key, til en ny handling en ny.

Valgfrit: prøv stemmen i et rigtigt opkald

Det er den hurtigste måde at høre volai på: én forespørgsel, og få sekunder senere ringer telefonen. Intet nummer at købe, ingen agent at oprette - det er nok at skrive, hvad agenten skal gøre, i systemPrompt i stedet for agentId. Opkaldet kommer fra volais fælles demonummer.

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": "Du er receptionist på Cafe Nula. Hils, spørg hvad den ringende ønsker, og gentag bestillingen."
  }'

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

Valgfrit: send en SMS

Send en tekstbesked til et vilkårligt tjekkisk eller slovakisk mobilnummer (SMS sendes ikke til andre lande). SMS kræver en første optankning af saldoen - velkomstsaldoen kan ikke bruges til dem. Der skal dog ikke ventes på svar - modtageren kan ikke svare til det fælles afsendernavn SMSinfo, og taletelefonnumre hos volai modtager ikke SMS (modtagelse af SMS og afsendelse fra et eget nummer klares af tilvalget mobilnummer og af nummer til opkald og sms, se afsnittet mobilnumre og afsnittet Nummer til opkald og sms i API-referencen):

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": "Hej fra volai! - Min app"}'

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

Valgfrit: skaf et nummer til indgående opkald

Først et nummer fra den ledige beholdning - et tomt indhold {} tildeler et nummer fra standardudbuddet i Prag. Til et andet udbud angives region, eller et e164 vælges via GET /v1/numbers/available. Købet trækker straks gebyret for den første periode:

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

Nu knyttes en agent til nummeret - et navn, en systemprompt og nummeret fra trinnet ovenfor er nok:

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": "Receptionist",
    "systemPrompt": "Du er receptionist på Cafe Nula. Du tager imod bestillinger til afhentning og svarer på spørgsmål om åbningstider (8-18, man-fre). Opfind aldrig priser, du ikke kender. Afslut opkaldet med en opsummering af bestillingen.",
    "numberE164": "+420210123456"
  }'

{
  "id": "ag_kx91fa2b"
}

Så er det klaret - ring til det nye nummer. Agenten skulle tage telefonen inden for få sekunder og tale præcis, som der står i systemPrompt.

Kapacitetskort

Oversigt over områder og tilgængelige funktioner. For REST og MCP er antallet af understøttede funktioner angivet ud af dem, som den pågældende grænseflade tilbyder. Bevidste undtagelser, for eksempel at adgang kun oprettes i portalen, forklares i referencen.

Den fulde liste findes i REST API-referencen og i værktøjslisten på siden MCP .