# Plattform-Anleitungen

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

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

Quelle: https://trunkbeam.com/docs/platforms

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

| Richtung | Was passiert | Wo du es einstellst |
|---|---|---|
| Eingehend | TrunkBeam stellt Anrufe auf deine Nummer an die SIP-URI des Anbieters durch. | Dashboard → Rufnummern → Nummer → **Verbindung** |
| Ausgehend und Weiterleitung | Dein 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:

| Feld | Wert |
|---|---|
| Server / Address | `sip.trunkbeam.com` |
| Port | `5061` |
| Transport | TLS |
| Benutzername / Passwort | aus 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-Header | Inhalt |
|---|---|
| `X-TrunkBeam-Called` | die angerufene TrunkBeam-Nummer |
| `X-TrunkBeam-Transfer` | nur bei Rückkehr nach einer Weiterleitung: der Grund (`no-answer`, `busy`, `unavailable`, `not-allowed`, `limit`) |
| `X-TrunkBeam-Transfer-Target` | nur 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](/docs/transfer).

## 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](https://elevenlabs.io/docs/eleven-agents/phone-numbers/sip-trunking), [Transfer to number](https://elevenlabs.io/docs/agents-platform/customization/tools/system-tools/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:

   ```bash
   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:

   ```bash
   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](https://docs.livekit.io/telephony/start/sip-trunk-setup/), [SIP-API](https://docs.livekit.io/reference/telephony/sip-api/), [Transfer](https://docs.livekit.io/sip/transfer-cold/)

## LiveKit selbst betrieben

Wie LiveKit Cloud, mit dem SIP-Dienst [livekit/sip](https://github.com/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`:

   ```json
   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**:

   ```json
   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](https://docs.vapi.ai/advanced/sip/sip-trunk), [Netzwerk](https://docs.vapi.ai/advanced/sip/sip-networking)

## Retell AI

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

Bei Retell unter Phone Numbers → Connect via SIP trunking:

| Feld | Wert |
|---|---|
| Phone Number | deine TrunkBeam-Nummer im Format E.164 |
| Termination URI | `sip.trunkbeam.com` |
| Transport | TLS |
| SIP Trunk User Name / Password | aus Konto → SIP-Zugang |
| Inbound Agent | der 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](https://docs.retellai.com/deploy/custom-telephony), [Transfer](https://docs.retellai.com/build/single-multi-prompt/transfer-call)

## 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`:

   ```json
   { "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](https://docs.ultravox.ai/telephony/sip), [Transfers](https://docs.ultravox.ai/telephony/call-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](https://developers.openai.com/api/docs/guides/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](#livekit-cloud) an. Alternativ Pipecat mit Daily- oder LiveKit-Transport.

Dokumentation von Deepgram: [Deepgram mit LiveKit](https://developers.deepgram.com/docs/livekit-integration)

## 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.
