Kom igång

Quickstart

Anslut först AI-assistenten eller appen och verifiera anslutningen utan att ringa. Fortsätt sedan efter det arbete som ska utföras: fakturor, tidsbokningar, sms, inkommande samtal eller en egen uppgift.

1Skapa ett konto

Registreringen tar en minut och är gratis, något kort behövs inte. När e-postadressen är verifierad landar 50,00 kr (≈ 22,73 SEK) saldo på kontot - det räcker för att köpa ett nummer och göra några provsamtal (sms går först efter den första påfyllningen). Ett bortglömt lösenord återställs när som helst via länken på inloggningssidan, med ett vanligt e-postmeddelande med en länk för att ange ett nytt.

2Öppna assistentanslutningen

Öppna avsnittet AI-assistent i portalen och välj anslutning via OAuth. Claude Code, Codex CLI och Codex desktop kan öppna inloggningen; för andra klienter finns kvar varianten med en befintlig API-nyckel.

3Anslut - MCP eller REST API

MCP kopplar volais verktyg direkt till assistenten. REST API passar för en egen app. Båda vägarna använder samma konto och nyckel; de åtgärder som stöds och deras begränsningar finns längre ned i funktionskartan.

AI-assistent via MCP

Ett enda kommando för Claude Code (installation för Cursor, Windsurf, VS Code och Claude Desktop finns på sidan MCP-server):

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

Verifiera anslutningen utan att ringa

Klistra in den här uppgiften i en ny chatt i den anslutna assistenten. Anslutningen är klar först efter en verklig skrivskyddad läsning via `get_balance` och `list_agents`; för verifieringen behöver du varken ringa, skicka sms eller köpa 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

Verifiera nyckeln med en enda fråga om saldot:

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

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

4Valfritt: välj nästa arbete

Fortsätt efter verifieringen utifrån ditt mål. Du kan använda guiden, webbportalen, REST API eller en egen MCP-uppgift; exemplen nedan är inspiration, inte en obligatorisk första uppgift.

Byt ut exempelnumren och ID:n mot dina egna. Svaren nedan visar de väsentliga fälten; de fullständiga formerna finns i REST-referensen. Vid en betald åtgärd används samma Idempotency-Key när den upprepas, och en ny för en ny åtgärd.

Valfritt: prova rösten med ett riktigt samtal

Det här är det snabbaste sättet att höra volai med egna öron: en förfrågan och några sekunder senare ringer telefonen. Inget nummer att köpa, ingen agent att skapa - det räcker att skriva vad agenten ska göra i systemPrompt i stället för agentId. Samtalet går från volais delade 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 är receptionist på caféet Nula. Hälsa, fråga vad gästen vill ha och upprepa beställningen."
  }'

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

Valfritt: skicka ett sms

Skicka ett sms till valfritt tjeckiskt eller slovakiskt mobilnummer (till andra länder skickar vi inte sms). Sms går först efter den första saldopåfyllningen, välkomstsaldot kan inte användas till dem. Vänta dig dock inget svar - mottagaren kan inte svara till det delade avsändarnamnet SMSinfo, och volais röstnummer tar inte emot sms (mottagning av sms och utskick från ett eget nummer klarar tillägget mobilnummer och nummer för samtal och sms, se avsnittet Mobilnummer och avsnittet nummer för samtal och sms i API-dokumentationen):

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 från volai! - Min app"}'

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

Valfritt: skaffa ett nummer för inkommande samtal

Först ett nummer ur det lediga lagret - en tom body {} tilldelar dig ett nummer ur standardutbudet Prag. För ett specifikt utbud använd region eller välj e164 via GET /v1/numbers/available. Köpet drar omedelbart avgiften för den första perioden:

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

Häng nu en agent på numret - det räcker med ett namn, en systemprompt och numret från föregående steg:

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 är receptionist på caféet Nula. Du tar emot beställningar för avhämtning och svarar på frågor om öppettider (8-18, mån-fre). Hitta aldrig på priser som du inte känner till. Avsluta samtalet med en sammanfattning av beställningen.",
    "numberE164": "+420210123456"
  }'

{
  "id": "ag_kx91fa2b"
}

Det var allt - ring ditt nya nummer. Agenten bör svara inom några sekunder och prata precis som du skrev i systemPrompt.

Funktionskarta

Översikt över områden och tillgängliga funktioner. För REST och MCP anges antalet funktioner som stöds av dem som respektive gränssnitt erbjuder. Avsiktliga undantag, till exempel att skapa åtkomst enbart i portalen, förklaras i referensen.

Den fullständiga listan finns i REST API-referensen och i verktygslistan på MCP .