Aan de slag

Quickstart

Koppel uw AI-assistent of app en controleer de toegang zonder te bellen. Ga daarna verder met wat u nodig hebt: facturen, afspraken, sms, inkomende gesprekken of een eigen taak.

1Maak een account aan

Aanmelden duurt een minuut, is gratis en u hebt geen kaart nodig. Zodra u uw e-mailadres hebt geverifieerd, staat er 50.00 CZK (~EUR 2.08) tegoed op uw account - genoeg om een nummer te kopen en een paar testgesprekken te voeren (voor sms is een eerste opwaardering nodig). Vergeet u uw wachtwoord, dan kunt u het altijd opnieuw instellen via een link op de inlogpagina - een gewone e-mail met een link om een nieuw wachtwoord in te stellen.

2Open de toegang voor de assistent

Open in het portaal AI-assistent en kies OAuth. Claude Code, Codex CLI en Codex desktop kunnen het inloggen openen; andere clients kunnen de bestaande terugvaloptie met een API-sleutel gebruiken.

3Koppelen - MCP of REST API

MCP brengt de tools van volai rechtstreeks in uw assistent. De REST API past bij uw eigen app. Beide gebruiken hetzelfde account en dezelfde sleutel; de ondersteunde acties en hun limieten staan in de capaciteitenkaart hieronder.

AI-assistent via MCP

Eén commando voor Claude Code (de installatie voor Cursor, Windsurf, VS Code en Claude Desktop staat op de pagina MCP-server):

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

Controleer de toegang zonder te bellen

Plak deze prompt in een nieuwe chat in uw gekoppelde assistent. De toegang is pas compleet als hij `get_balance` en `list_agents` daadwerkelijk heeft uitgelezen; voor de controle is geen gesprek, sms of aankoop van een nummer nodig.

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.

Uw eigen app via de REST API

Controleer de sleutel met één opvraging van uw tegoedsaldo:

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

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

4Optioneel: kies wat er daarna komt

Volg na de controle uw eigen doel. Gebruik de handleiding, het volledige webportaal, de REST API of uw eigen MCP-prompt; de voorbeelden hieronder zijn inspiratie, geen verplichte eerste taak.

Vervang voorbeeldnummers en ID's door uw eigen. De antwoorden hieronder tonen de relevante velden; de volledige vormen staan in de REST-referentie. Gebruik dezelfde Idempotency-Key opnieuw als u een betaalde actie herhaalt; gebruik een nieuwe sleutel voor een nieuwe actie.

Optioneel: probeer de stem in een echt gesprek

Dit is de snelste manier om volai zelf te horen: één verzoek en een paar seconden later gaat uw telefoon over. Geen nummer om te kopen, geen agent om in te stellen - schrijf gewoon wat de agent moet doen in systemPrompt in plaats van agentId. Het gesprek komt van het gedeelde demonummer van 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": "U bent de receptionist van Cafe Zero. Begroet de beller, vraag wat hij wil en herhaal de bestelling."
  }'

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

Optioneel: een sms versturen

Stuur een sms naar een willekeurig Tsjechisch of Slowaaks mobiel nummer (naar andere landen sturen wij geen sms). Voor sms is een eerste opwaardering van het tegoed nodig - het welkomsttegoed dekt ze niet. Wacht niet op een antwoord - ontvangers kunnen niet antwoorden op de gedeelde afzendernaam SMSinfo en spraaknummers van volai ontvangen geen sms (sms ontvangen en vanaf een eigen nummer verzenden doen de add-on mobiel nummer en het nummer voor bellen en sms - zie de secties Mobiele nummers en Nummer voor bellen en sms van de API-referentie):

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": "Hallo van volai! - Mijn app"}'

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

Optioneel: een nummer voor inkomende gesprekken

Eerst een nummer uit de vrije voorraad - een lege body {} wijst een nummer toe uit het standaardaanbod van Praag. Stel region in voor een ander aanbod, of kies een e164 uit GET /v1/numbers/available. Bij aankoop wordt direct de eerste factureringsperiode in rekening gebracht:

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

Koppel nu een agent aan dat nummer - alleen een naam, een systeemprompt en het nummer uit de vorige stap:

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": "U bent de receptionist van Cafe Zero. U neemt bestellingen voor afhalen aan en beantwoordt vragen over de openingstijden (8-18 uur, ma-vr). Verzin nooit een prijs die u niet weet. Sluit het gesprek af met een samenvatting van de bestelling.",
    "numberE164": "+420210123456"
  }'

{
  "id": "ag_kx91fa2b"
}

Dat is alles - bel uw nieuwe nummer. De agent hoort binnen een paar seconden op te nemen en precies te praten zoals u het schreef in systemPrompt.

Capaciteitenkaart

Bekijk de gebieden en beschikbare functies. De aantallen voor REST en MCP tonen de gedekte functies die voor elke interface in aanmerking komen. De referentie legt bewuste uitzonderingen uit, zoals toegang die alleen in het portaal wordt aangemaakt.

De volledige lijst staat in de REST API-referentie en in de lijst met tools op de pagina MCP .