Early Access: Dashboard, CLI, MCP-Server und REST-API sind nutzbar. Die Einrichtung für deinen Voice-Stack klären wir gern direkt mit dir.

Plattform-Anleitungen

Was du bei ElevenLabs, LiveKit, Vapi, Retell, Ultravox, OpenAI und anderen SIP-Zielen einträgst, damit deine Nummer beim Agenten ankommt.

In TrunkBeam trägst du an jeder Rufnummer nur ein, wohin Anrufe gehen sollen: die Adresse bei deinem Anbieter (SIP-URI). Alles Weitere stellst du beim Anbieter ein. Diese Seite zeigt für die gängigen Plattformen, wo du was findest.

Die Anleitung für ElevenLabs ist im Betrieb getestet. Die übrigen folgen den Dokumentationen der Anbieter (Stand September 2026). Die Felder dort können sich ändern.

Das Prinzip

RichtungWas passiertWo du es einstellst
EingehendTrunkBeam stellt Anrufe auf deine Nummer an die SIP-URI des Anbieters durch.Dashboard → Rufnummern → Nummer → Verbindung
Ausgehend und WeiterleitungDein Agent ruft über TrunkBeam nach draußen an oder leitet weiter. Dafür meldet sich der Anbieter mit dem SIP-Zugang an.Dashboard → Konto → SIP-Zugang

Für ausgehende Anrufe gelten bei allen Anbietern dieselben Werte:

FeldWert
Server / Addresssip.trunkbeam.com
Port5061
TransportTLS
Benutzername / Passwortaus Konto → SIP-Zugang (das Passwort ist nur beim Erzeugen sichtbar)

Das SIP-Ziel an der Nummer

  • Adresse beim Anbieter: Nummer oder Kennung, Server und Übertragung (TLS, TCP oder UDP). Einen Port musst du nicht eintragen: Es gilt 5061 bei TLS, sonst 5060. Nur bei einem abweichenden Port hängst du ihn an den Server an, zum Beispiel pbx.example.de:5080. Hast du eine fertige SIP-URI wie sip:+4930123456@sip.anbieter.example;transport=tls, füge sie in eines der oberen Felder ein; das Dashboard verteilt sie auf die Felder. So sind auch die SIP-URIs weiter unten gemeint.
  • Sprache verschlüsseln (SRTP): Standard. Beim Anbieter muss verschlüsselte Sprache erlaubt sein, sonst kommen Anrufe nicht durch. Im Anrufprotokoll steht dann „Verschlüsselung passt nicht (SIP 488)“.
  • Benutzername und Passwort: nur einschalten, wenn der Anbieter sie für eingehende Anrufe verlangt. Die meisten erkennen TrunkBeam an der IP-Adresse. Die IP steht im Dashboard beim SIP-Ziel.

Nach dem Speichern die Nummer anrufen. Hebt der Agent nicht ab, steht der Grund im Dashboard unter Anrufe.

Angaben, die TrunkBeam mitschickt

SIP-HeaderInhalt
X-TrunkBeam-Calleddie angerufene TrunkBeam-Nummer
X-TrunkBeam-Transfernur bei Rückkehr nach einer Weiterleitung: der Grund (no-answer, busy, unavailable, not-allowed, limit)
X-TrunkBeam-Transfer-Targetnur bei Rückkehr: die Nummer, die nicht abgenommen hat

Weiterleiten kann der Agent per SIP REFER an tel:+49… oder sip:+49…@sip.trunkbeam.com. Mehr dazu unter Durchstellen und Wartemusik.

ElevenLabs Agents

SIP-URI in TrunkBeam: sip:+49…@sip.rtc.elevenlabs.io;transport=tls mit deiner TrunkBeam-Nummer. Sprache verschlüsseln an, Benutzername und Passwort wie in ElevenLabs.

  1. Nummer importieren: ElevenLabs → Agents → Phone Numbers → Import number → From SIP trunk.
    • Label: TrunkBeam
    • Phone Number: deine TrunkBeam-Nummer mit +, genau wie in der SIP-URI
  2. Inbound Configuration
    • Media Encryption: Allowed oder Required. Mit „Disabled“ kommen Anrufe nicht durch.
    • Authentication: an. Benutzername und Passwort frei wählen und dieselben Werte in TrunkBeam beim SIP-Ziel eintragen. Ohne Authentication nimmt ElevenLabs Anrufe von jedem an.
    • Alle anderen Schalter bleiben aus. Eine IP-Freigabe (Allowed Addresses) und Remote Domains sind nicht nötig. Wer Remote Domains trotzdem setzen will: sip.trunkbeam.com.
  3. Outbound Configuration für Anrufe nach draußen und Weiterleitungen
    • Address: sip.trunkbeam.com
    • Transport Type: TLS
    • Media Encryption: Required
    • Username / Password: aus Konto → SIP-Zugang
  4. Agent zuweisen: der importierten Nummer den Agenten zuweisen und die Nummer anrufen.

Weiterleiten: System-Tool „Transfer to number“ mit Transfer-Typ SIP REFER. Ohne REFER („Conference“) baut ElevenLabs einen zweiten Anruf über TrunkBeam auf.

  • Die angerufene Nummer steht dem Agenten als {{sip_trunkbeam_called}} zur Verfügung.
  • Ruft TrunkBeam den Agenten nach einer erfolglosen Weiterleitung zurück, stehen Grund und Nummer in {{sip_trunkbeam_transfer}} und {{sip_trunkbeam_transfer_target}}. Im Prompt darauf eingehen, zum Beispiel eine Nachricht aufnehmen, statt neu zu begrüßen.
  • ElevenLabs wartet nur etwa 10 bis 15 Sekunden auf das Ergebnis einer Weiterleitung. Mit Erreichbarkeitsprüfung klingelt es deshalb höchstens 12 Sekunden.

Dokumentation von ElevenLabs: SIP-Trunking, Transfer to number

LiveKit Cloud

SIP-URI in TrunkBeam: sip:+49…@<subdomain>.eu.sip.livekit.cloud;transport=tls. Die Adresse steht unter Settings → Project. Benutzername und Passwort einschalten, mit denselben Werten wie im Inbound-Trunk.

  1. Inbound-Trunk: LiveKit Cloud → Telephony → SIP trunks → Create inbound trunk, oder per CLI:

    lk sip inbound create --name trunkbeam --numbers "+49…" \
      --auth-user "<Benutzername>" --auth-pass "<Passwort>"

    Für die Header von TrunkBeam include_headers: SIP_X_HEADERS setzen. Sie erscheinen dann als Attribute sip.h.x-trunkbeam-called und sip.h.x-trunkbeam-transfer.

  2. Dispatch-Regel: Telephony → Dispatch rules, Anrufe dieses Trunks an den Agenten.

  3. Outbound-Trunk für Anrufe nach draußen und Weiterleitungen:

    lk sip outbound create --name trunkbeam --address sip.trunkbeam.com --transport tls \
      --numbers "+49…" --auth-user "<SIP-Zugang Benutzername>" --auth-pass "<SIP-Zugang Passwort>"

Weiterleiten: TransferSIPParticipant sendet ein SIP REFER, transfer_to als tel:+49… oder sip:….

Eine IP-Freigabe gibt es in LiveKit Cloud nur über den Support. Benutzername und Passwort reichen.

Dokumentation von LiveKit: SIP-Trunk einrichten, SIP-API, Transfer

LiveKit selbst betrieben

Wie LiveKit Cloud, mit dem SIP-Dienst livekit/sip auf deinem Server.

  • SIP-URI in TrunkBeam: sip:+49…@sip.deine-domain.example;transport=tls. Das Zertifikat muss zum Hostnamen passen.
  • Im SIP-Dienst öffentliche IP und TLS einrichten. In der Firewall SIP (5060/5061) und die RTP-Ports (Standard 10000–20000) für die IP von TrunkBeam öffnen.
  • Inbound-Trunk mit Benutzername und Passwort oder mit IP-Freigabe (--allowed-addresses <IP>/32). Bei IP-Freigabe in TrunkBeam keine Zugangsdaten eintragen.
  • Outbound-Trunk wie bei LiveKit Cloud.

Vapi

SIP-URI in TrunkBeam: sip:+49…@<credentialId>.sip.eu.vapi.ai für EU-Konten, sonst <credentialId>.sip.vapi.ai. Keine Zugangsdaten, Vapi erkennt TrunkBeam an der IP.

  1. Credential anlegen per API, EU-Konten über api.eu.vapi.ai:

    POST /credential
    {
      "provider": "byo-sip-trunk",
      "name": "TrunkBeam",
      "gateways": [{ "ip": "<IP von TrunkBeam>", "port": 5061, "inboundEnabled": true,
                     "outboundEnabled": true, "outboundProtocol": "tls" }],
      "outboundAuthenticationPlan": { "authUsername": "<SIP-Zugang Benutzername>",
                                      "authPassword": "<SIP-Zugang Passwort>" }
    }
  2. Telefonnummer anlegen:

    POST /phone-number
    { "provider": "byo-phone-number", "number": "+49…", "credentialId": "<credentialId>",
      "numberE164CheckEnabled": true }

Weiterleiten: Tool transferCall mit destination { "type": "sip", "sipUri": "sip:+49…@sip.trunkbeam.com" }. Vapi nutzt dafür standardmäßig REFER.

Dokumentation von Vapi: SIP-Trunk, Netzwerk

Retell AI

SIP-URI in TrunkBeam: sip:+49…@sip.retellai.com;transport=tcp. Keine Zugangsdaten.

Bei Retell unter Phone Numbers → Connect via SIP trunking:

FeldWert
Phone Numberdeine TrunkBeam-Nummer im Format E.164
Termination URIsip.trunkbeam.com
TransportTLS
SIP Trunk User Name / Passwordaus Konto → SIP-Zugang
Inbound Agentder gewünschte Agent

Um diese Werte später zu ändern, die Nummer bei Retell löschen und neu importieren.

Weiterleiten: Retell leitet standardmäßig per neuem Anruf weiter und bleibt dabei im Gespräch. Mit der Option „SIP REFER“ gibt Retell den Anruf an TrunkBeam ab.

Dokumentation von Retell: Custom Telephony, Transfer

Ultravox

SIP-URI in TrunkBeam: sip:agent_<agentId>@<SIP-Domain deines Kontos>. Die Domain liefert GET /api/sip. Keine Zugangsdaten.

  1. TrunkBeam freigeben: PATCH /api/sip mit { "allowedCidrRanges": ["<IP von TrunkBeam>/32"] }.

  2. Ausgehend: Anruf mit medium sip.outgoing:

    { "sip": { "outgoing": { "to": "sip:+49…@sip.trunkbeam.com;transport=tls", "from": "+49…",
      "username": "<SIP-Zugang Benutzername>", "password": "<SIP-Zugang Passwort>" } } }

Weiterleiten: Das eingebaute coldTransfer sendet ein SIP REFER an sip:+49…@sip.trunkbeam.com.

Dokumentation von Ultravox: SIP, Transfers

OpenAI Realtime

Nur eingehend. SIP-URI in TrunkBeam: sip:proj_…@sip.api.openai.com;transport=tls, in der EU sip-eu.api.openai.com. Sprache verschlüsseln an, das verlangt OpenAI. Keine Zugangsdaten.

  1. OpenAI → Projekt → Webhooks: Event realtime.call.incoming an dein Backend.
  2. Dein Backend nimmt jeden Anruf per POST /v1/realtime/calls/{call_id}/accept an, mit Modell, Anweisungen und Stimme. Die SIP-Header von TrunkBeam stehen im Webhook unter data.sip_headers.

Weiterleiten: POST /v1/realtime/calls/{call_id}/refer mit target_uri tel:+49….

Dokumentation von OpenAI: Realtime SIP

Deepgram Voice Agent

Deepgram hat keine SIP-Schnittstelle. Baue den Agenten mit LiveKit Agents und den Deepgram-Plugins und binde ihn wie LiveKit an. Alternativ Pipecat mit Daily- oder LiveKit-Transport.

Dokumentation von Deepgram: Deepgram mit LiveKit

Andere SIP-Ziele

Für eine eigene Telefonanlage, Asterisk, FreeSWITCH, Synthflow oder jeden anderen SIP-Server:

  • SIP-URI mit Host, Port und Transport des Ziels, zum Beispiel sip:empfang@pbx.example.de:5061;transport=tls.
  • Anrufe von TrunkBeam zulassen: Benutzername und Passwort (Digest) oder die IP von TrunkBeam freigeben.
  • Codecs: G.722 und G.711 (PCMA/PCMU).
  • Ausgehend: Server sip.trunkbeam.com, Port 5061, TLS, mit dem SIP-Zugang.

Pipecat hat keinen eigenen SIP-Eingang. Die Einwahl über Daily setzt voraus, dass der Anbieter den laufenden Anruf per API an eine Adresse weiterreicht, die Daily für jeden Anruf neu vergibt; TrunkBeam stellt an eine feste Adresse je Nummer zu. Zwei Wege funktionieren: Pipecat mit dem LiveKit-Transport betreiben und die Nummer wie oben bei LiveKit verbinden, oder einen eigenen Asterisk oder FreeSWITCH als SIP-Ziel eintragen, der den Ton an Pipecat weitergibt.

Noch nicht möglich sind Ziele, die ausgehend nur eine IP-Freigabe statt Passwort können, zum Beispiel Daily Dial-out, und Ziele, die zwingend Opus verlangen.

Deinen Stack mit TrunkBeam verbinden