ElevenLabs-Agent an einer tschechischen Nummer über SIP

Sie betreiben bereits einen eigenen ElevenLabs-Conversational-AI-Agenten und möchten ihm eine tschechische Telefonnummer geben? Dafür braucht es keinen Zaubertrick: Sie verbinden eine volai-Nummer mit dem SIP-Trunk Ihrer Agentenplattform. Eingehende Anrufe sind der einfache Teil - eine einzige PATCH-Anfrage an das Routing der Nummer. Bei ausgehenden Anrufen läuft es etwas anders, denn ElevenLabs (wie die meisten KI-Sprachplattformen) kann eine Telefonleitung nicht dauerhaft als SIP-Client registrieren - es setzt nur einen einzelnen authentifizierten Anruf ab, der deshalb über eine kurzlebige Relay-Verbindung läuft. Der große Unterschied zum integrierten volai-Agenten: Bei ausgehenden Anrufen entfällt der Agentenaufschlag von 2,50 kr/Min. (≈ 0,10 EUR) vollständig - Sie betreiben (und bezahlen) den Agenten selbst, in Ihrem eigenen ElevenLabs-Workspace.

Wann lohnt sich ein eigener Agent mehr als der integrierte?

Beide Wege werden über dieselbe volai-Nummer und dasselbe Guthaben abgerechnet - was sich ändert, ist, wer das Gespräch führt und was es obendrauf kostet:

Anders gesagt: Ein eigener Agent lohnt sich, wenn Sie bereits einen ElevenLabs-Agenten mit eigenem Prompt, eigenen Werkzeugen und eigener Stimme betreiben und nur noch eine tschechische Nummer dafür brauchen. Sie fangen bei null an, mit nichts als einem Systemprompt, und möchten keinen separaten ElevenLabs-Workspace verwalten? Dann ist der schnellere Weg der integrierte volai-Agent - ein API-Aufruf richtet ihn ein, und Transkript und Zusammenfassung sind im Agentenaufschlag enthalten, ganz ohne gesonderte Einrichtung.

Was brauchen Sie?

• Ein volai-Konto mit einer tschechischen Nummer sowie einen API-Schlüssel (vk_...) - Sie finden ihn im Portal unter API und MCP.
• Einen ElevenLabs-Conversational-AI-Agenten, der bereits in IHREM EIGENEN Workspace gebaut ist - diese Anleitung verbindet ihn mit einer Nummer, sie baut den Agenten nicht für Sie.
• Guthaben auf Ihrem volai-Konto - die Anrufe werden davon abgebucht, genau wie beim integrierten Agenten.

Schritt 1: Eingehende Anrufe verbinden

Stellen Sie das Routing der Nummer auf mode: "sip" und setzen Sie sipUri auf die Adresse, unter der ElevenLabs beim Import eines SIP-Trunks Anrufe erwartet:

curl -X PATCH "https://volai.cz/v1/numbers/+420601234567" \
  -H "Authorization: Bearer vk_YOUR_KEY" \
  -H "Content-Type: application/json" \
  -d '{"routing": {"mode": "sip", "sipUri": "sip:+420601234567@sip.rtc.elevenlabs.io"}}'

Registrieren Sie die Nummer dann auf der Seite von ElevenLabs (Settings → Phone Numbers → Import → SIP trunk) mit einer inbound_trunk_config:

{
  "provider": "sip_trunk",
  "phone_number": "+420601234567",
  "label": "My own agent",
  "inbound_trunk_config": {
    "allowed_addresses": ["81.31.45.0/24"],
    "media_encryption": "allowed"
  }
}

Abgerechnet wird nur die eingehende Minute (0,50 kr/Min. (≈ 0,02 EUR)), ohne Aufschlag - dieselbe Regel gilt für den integrierten Agenten und für ein gewöhnliches Softphone.

Schritt 2: Ausgehende Anrufe über das Relay verbinden

Diese Richtung läuft umgekehrt - Ihr Agent wählt selbstständig aus. Das Telefonnetz leitet einen Anruf von einer fremden SIP-Adresse nicht direkt an sein Ziel weiter, deshalb läuft er über ein kurzlebiges Relay - einen einmaligen SIP-Slot, den volai kurz vor dem Anruf öffnet und nach dessen Ende wieder abbaut. Warum es so funktioniert und wie es bei anderen Plattformen als ElevenLabs aussieht, steht auf der Seite Eigenen Agenten mitbringen - hier nur die drei Schritte, die Sie brauchen:

2.1 ElevenLabs auf Ihre Leitung zeigen lassen

Holen Sie sich die SIP-Zugangsdaten der Nummer:

curl "https://volai.cz/v1/numbers/+420601234567/sip" \
  -H "Authorization: Bearer vk_YOUR_KEY"

{
  "server": "sip.volai.cz",
  "username": "123456",
  "password": "a1b2c3d4e5f6",
  "outboundTrunkAddress": "sip.volai.cz",
  "port": 5060,
  "transport": "tcp",
  "inboundSignallingCidrs": ["81.31.45.0/24"]
}

Das Feld server ist für ein gewöhnliches Softphone gedacht (siehe die SIP-Seite), ElevenLabs braucht jedoch das Feld outboundTrunkAddress (sip.volai.cz), nicht server - wer stattdessen dieses einsetzt, erhält den Fehler 1011 sip request timed out - die Adresse des ausgehenden Trunks muss genau diesem Wert entsprechen, sonst wird der Anruf im Netz nicht geroutet.

Tragen Sie sie anschließend bei ElevenLabs als outbound_trunk_config dieser Nummer ein (Settings → Phone Numbers → Ihre Nummer → Outbound calling), genau in dieser Form:

{
  "outbound_trunk_config": {
    "address": "sip.volai.cz",
    "transport": "tcp",
    "media_encryption": "allowed",
    "credentials": {
      "username": "123456",
      "password": "a1b2c3d4e5f6"
    }
  }
}

2.2 Eine Relay-Verbindung öffnen

Rufen Sie unmittelbar vor dem Anruf auf - die Verbindung ist kurzlebig, siehe die Grenzen weiter unten:

curl -X POST https://volai.cz/v1/relay \
  -H "Authorization: Bearer vk_YOUR_KEY" \
  -H "Content-Type: application/json" \
  -d '{"to": "+420777123456", "from": "+420601234567"}'

{
  "id": "rl_4f2a91cd",
  "sipName": "volai_relay_2",
  "sipUri": "sip:volai_relay_2@sip.volai.cz",
  "expiresAt": 1756111760000,
  "callId": "c_9d4e2b7f"
}

2.3 Dem Agenten den sipName geben, nicht die vollständige SIP-URI

Für ElevenLabs bedeutet das: Rufen Sie /v1/convai/sip-trunk/outbound-call auf und setzen Sie to_number direkt auf den sipName:

{
  "agent_id": "agent_...",
  "agent_phone_number_id": "phnum_...",
  "to_number": "volai_relay_2"
}

Was passiert, sobald der Anruf rausgeht

Auf der Netzseite geht der Anruf unter dem Namen volai_relay_2 raus, wird an Ihr to weitergereicht und zeigt Ihre from-Nummer als Anruferkennung an - wer abhebt, sieht auf seinem Display Ihre volai-Leitung und nie den Wegwerfnamen des Relay-Slots (nur wenn die Nummer eigene Relay-Namen hat - andernfalls sieht der Angerufene die Demonummer von volai; wenden Sie sich an den Support). Sobald der Anruf beendet ist, wird die Lease automatisch freigegeben und der normale Preis für ausgehende Anrufe berechnet - 0,92 kr/Min. (≈ 0,04 EUR), ohne Agentenaufschlag.

Grenzen und Sicherheit

• from muss Ihre eigene volai-Nummer sein - sonst kommt from_number_not_owned. Ohne diese Prüfung könnte jeder die Leitung eines anderen als Anruferkennung vortäuschen.
• Dieselben Schranken wie bei einem normalen Anruf - die Sperrliste (nur für Anrufe, SMS sind ausgenommen), eine automatische 30-Tage-Sperre nach drei fehlgeschlagenen Versuchen zu einer Nummer innerhalb von 24 Stunden und das übliche Rate-Limit für Anrufe. Nichts davon lässt sich über das Relay umgehen.
• Die Lease ist einmalig - ein zweiter Anrufversuch auf derselben Lease wird abgelehnt, öffnen Sie daher für den nächsten Anruf eine neue.
• Ein voller Relay-Pool antwortet mit 503 capacity_busy - das ist eine Obergrenze für gleichzeitige Verbindungen, die für die GESAMTE volai-Plattform gilt, nicht nur für Ihr Konto. Dabei wird nichts abgerechnet; versuchen Sie es einfach kurz darauf erneut.

Die vollständige REST-Referenz (Fehlercodes, GET/DELETE für Leases) steht in der REST-API-Referenz; die komplette Anleitung - für eingehende und ausgehende Anrufe bei jeder Plattform, nicht nur ElevenLabs - finden Sie auf der Seite Eigenen Agenten mitbringen.

Wann sollten Sie beim integrierten Agenten bleiben?

Ganz offen: Ein eigener Agent bedeutet mehr bewegliche Teile - ein separates ElevenLabs-Konto samt Rechnung, kein automatisches Transkript und keine Zusammenfassung im volai-Portal und einen zusätzlichen Schritt vor jedem ausgehenden Anruf (eine Relay-Lease öffnen). Wenn Ihnen ein guter Systemprompt genügt und Sie lieber in Minuten fertig sind, als ein zweites Plattformkonto zu verwalten, bringt Sie der integrierte volai-Agent mit einem einzigen API-Aufruf ans Ziel - und der Aufschlag von 2,50 kr/Min. (≈ 0,10 EUR) liefert Ihnen bei jedem Anruf automatisch Transkript, Zusammenfassung und Erkennung von Mailboxen, ohne zusätzliche Einrichtung.

Den vollständigen Preisvergleich mit Twilio und anderen Anbietern finden Sie auf der Preisseite; die Anleitung zur ElevenLabs-Integration mit Links zur dortigen Dokumentation steht auf der Seite Integrationen.

Wie es weitergeht