Erste Schritte

Schnellstart

Verbinden Sie Ihren KI-Assistenten oder Ihre App und prüfen Sie den Zugriff, ohne einen Anruf zu tätigen. Machen Sie danach mit dem weiter, was Sie brauchen: Rechnungen, Termine, SMS, eingehende Anrufe oder eine eigene Aufgabe.

1Konto erstellen

Die Registrierung dauert eine Minute, ist kostenlos und braucht keine Karte. Sobald Sie Ihre E-Mail-Adresse bestätigen, werden 50,00 kr (≈ 2,08 EUR) Guthaben auf Ihrem Konto gutgeschrieben - genug, um eine Nummer zu kaufen und ein paar Testanrufe zu führen (für SMS ist eine erste Aufladung nötig). Wenn Sie Ihr Passwort vergessen, können Sie es jederzeit über einen Link auf der Anmeldeseite zurücksetzen - eine normale E-Mail mit einem Link zum Festlegen eines neuen Passworts.

2Assistentenzugang öffnen

Öffnen Sie im Portal KI-Assistent und wählen Sie OAuth. Claude Code, Codex CLI und Codex Desktop können die Anmeldung öffnen; andere Clients können die vorhandene Alternative mit API-Schlüssel nutzen.

3Verbinden - MCP oder REST-API

MCP bringt die volai-Werkzeuge direkt in Ihren Assistenten. Die REST-API passt zu Ihrer eigenen App. Beide nutzen dasselbe Konto und denselben Schlüssel; unterstützte Aktionen und ihre Grenzen stehen in der Funktionsübersicht unten.

KI-Assistent über MCP

Ein Befehl für Claude Code (die Installation für Cursor, Windsurf, VS Code und Claude Desktop steht auf der Seite zum MCP-Server):

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

Zugriff prüfen, ohne einen Anruf zu tätigen

Fügen Sie diesen Prompt in einen neuen Chat Ihres verbundenen Assistenten ein. Der Zugriff ist erst vollständig, wenn er tatsächlich `get_balance` und `list_agents` ausliest; für die Prüfung sind weder ein Anruf noch eine SMS noch ein Nummernkauf nötig.

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.

Ihre eigene App über die REST-API

Prüfen Sie den Schlüssel mit einer einzigen Abfrage Ihres Guthabens:

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

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

4Optional: wählen Sie, wie es weitergeht

Gehen Sie nach der Prüfung Ihrem tatsächlichen Ziel nach. Nutzen Sie die Anleitung, das vollständige Webportal, die REST-API oder Ihren eigenen MCP-Prompt; die Beispiele unten sind Anregungen, keine verpflichtende erste Aufgabe.

Ersetzen Sie Beispielnummern und IDs durch Ihre eigenen. Die Antworten unten zeigen die relevanten Felder; die vollständigen Strukturen stehen in der REST-Referenz. Verwenden Sie bei der Wiederholung einer kostenpflichtigen Aktion denselben Idempotency-Key, für eine neue Aktion einen neuen Schlüssel.

Optional: die Stimme in einem echten Anruf ausprobieren

So hören Sie volai am schnellsten selbst: eine Anfrage, und wenige Sekunden später klingelt Ihr Telefon. Sie müssen keine Nummer kaufen und keinen Agenten einrichten - schreiben Sie einfach, was der Agent tun soll, in systemPrompt statt in agentId. Der Anruf kommt von der gemeinsamen Demo-Nummer von 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": "Sie sind die Rezeptionistin im Cafe Zero. Begrüßen Sie den Anrufer, fragen Sie, was er möchte, und wiederholen Sie die Bestellung."
  }'

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

Optional: eine SMS senden

Senden Sie eine SMS an eine beliebige tschechische oder slowakische Mobilnummer (in andere Länder senden wir keine SMS). Für SMS ist eine erste Guthabenaufladung nötig - das Startguthaben deckt sie nicht ab. Warten Sie aber nicht auf eine Antwort - auf den gemeinsamen Absendernamen SMSinfo können Empfänger nicht antworten, und Sprachnummern von volai empfangen keine SMS (SMS zu empfangen und von einer eigenen Nummer zu senden leisten der Zusatz Mobilnummer und die Nummer für Anrufe und SMS, siehe Abschnitt Mobilnummern und Abschnitt Nummer für Anrufe und SMS in der API-Referenz):

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 von volai! - Meine App"}'

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

Optional: eine Nummer für eingehende Anrufe besorgen

Zuerst eine Nummer aus dem kostenlosen Pool - ein leerer Body {} weist eine Nummer aus dem Standardangebot für Prag zu. Setzen Sie region für ein anderes Angebot oder wählen Sie eine e164 aus GET /v1/numbers/available. Der Kauf berechnet sofort den ersten Abrechnungszeitraum:

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

Verbinden Sie nun einen Agenten mit dieser Nummer - nur ein Name, ein System-Prompt und die Nummer aus dem vorigen Schritt:

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": "Rezeption",
    "systemPrompt": "Sie sind die Rezeptionistin im Cafe Zero. Sie nehmen Bestellungen zur Abholung entgegen und beantworten Fragen zu den Öffnungszeiten (8-18 Uhr, Mo-Fr). Erfinden Sie niemals einen Preis, den Sie nicht kennen. Beenden Sie den Anruf, indem Sie die Bestellung zusammenfassen.",
    "numberE164": "+420210123456"
  }'

{
  "id": "ag_kx91fa2b"
}

Das war's - rufen Sie Ihre neue Nummer an. Der Agent sollte sich innerhalb weniger Sekunden melden und genau so sprechen, wie Sie es geschrieben haben in systemPrompt.

Funktionsübersicht

Durchsuchen Sie die Bereiche und verfügbaren Funktionen. Die Zahlen bei REST und MCP zeigen die abgedeckten Funktionen, die für die jeweilige Schnittstelle in Frage kommen. Die Referenz erklärt bewusste Ausnahmen, etwa dass Zugänge nur im Portal erstellt werden.

Die vollständige Liste finden Sie in der REST-API-Referenz und in der Werkzeugliste auf der Seite MCP .