> ## Documentation Index
> Fetch the complete documentation index at: https://docs.ouraicalling.com/llms.txt
> Use this file to discover all available pages before exploring further.

# BYO SIP-Trunk

> Verbinde deinen eigenen SIP-Anbieter und nutze deine bestehenden Nummern

Du hast schon Nummern und einen SIP-Anbieter (Telekom, sipgate, Twilio, Telnyx, Plivo oder einen beliebigen standardkonformen Trunk)? Dann verbinde ihn direkt – Anrufe laufen zwischen deinem Anbieter und der Sprachinfrastruktur der Plattform, ohne dass du irgendetwas portieren musst.

## Checkliste für die Einrichtung

1. **Kopiere die Plattform-SIP-URI** aus **Einstellungen → Telefonnummern → SIP-Integration hinzufügen** (oder Carrier-Import). Wähle eine **SIP-Region** (Standard: global), damit die eingehende Signalisierung dort endet, wo du sie brauchst (z. B. in der EU).
2. Hinterlege diese URI bei deinem Anbieter als Ursprungs- bzw. Weiterleitungsziel für deine Nummern.
3. Erstelle den Trunk in der Plattform (Formular unten) – eingehende Authentifizierung + ausgehende Terminierung.
4. Weise die Nummern den Assistenten zu, teste den Empfang eingehender Anrufe und führe anschließend einen ausgehenden Testanruf durch.

## Trunk-Typ

| Typ                     | Wann verwenden                                                                                   | Nummern                                                                                                                                                                                                                                                                 |
| ----------------------- | ------------------------------------------------------------------------------------------------ | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| **Telefonnummer (DID)** | Die meisten Carrier (empfohlen)                                                                  | Eine E.164-DID auf dem Trunk; wird unter **Nummern** aufgeführt                                                                                                                                                                                                         |
| **SIP-Extension**       | Der Carrier schickt viele DIDs an einen Trunk; du authentifizierst dich per Zugangsdaten oder IP | Eingehend wird jede DID akzeptiert. Optionale **Primäre DID** für die ausgehende Anrufer-ID – vollständige E.164-Nummer (`+…`) **oder** nationale Ziffern ohne Ländervorwahl (z. B. `0741926265`). Rein nationale Primärnummern werden nicht unter „Nummern" aufgeführt |

## Eingehend (Anrufe empfangen)

* **Deine Telefonnummer (DID)** – die öffentliche E.164-Nummer, die Kunden anrufen; muss mit dem übereinstimmen, was der Carrier an die Plattform-SIP-URI weiterleitet.
* **Eingehende Authentifizierung**
  * **SIP-Benutzername/Passwort** (empfohlen) – Digest-Authentifizierung.
  * **Anbieter-Quell-IPs** – nur, wenn der Carrier kein Digest kann und stabile SIP-Quell-IPs/CIDRs veröffentlicht. Verwende keine zu weit gefassten Bereiche.
* Beim Anbieter: an die kopierte Plattform-SIP-URI weiterleiten.

Eingehende Anrufe werden genau wie bei Marketplace-Nummern dem von dir zugewiesenen Assistenten zugeordnet.

## Ausgehend (Anrufe tätigen)

* **Terminierungsadresse** – nur der SIP-Host des Anbieters (z. B. `sip.telnyx.com`). Ohne `sip:`-Präfix, ohne Port.
* **Transport** – `AUTO` (empfohlen), `UDP`, `TCP` oder `TLS`. Secure Trunking nutzt immer TLS.
* **Outbound-Region** – von wo aus die Plattform den Anruf startet. Bevorzuge **Automatisch** oder das Land, das deinen Kunden bzw. dem Carrier-POP am nächsten liegt.
* **Format der ausgehenden Rufnummer** – wie die FROM-Nummer an den Carrier gesendet wird. Muss zur Einstellung des Carriers passen (z. B. Telnyx Origination Number Format):
  * International mit `+` (für die meisten empfohlen)
  * International ohne `+`
  * National (ohne Ländercode)
* **Zugangsdaten**
  * **Gemeinsam** (empfohlen) – ein Benutzername/Passwort für eingehend und ausgehend.
  * **Getrennt** – unterschiedliche Zugangsdaten für eingehend und ausgehend, falls der Carrier das verlangt.
* **Ausgehende Authentifizierung** – Benutzername/Passwort (empfohlen). Die Plattform hat **keine statischen ausgehenden IPs**, weshalb IP-Allowlists beim Carrier meist nicht funktionieren. Nutze „Keine Zugangsdaten" nur, wenn der Carrier ausgehende Anrufe ausdrücklich ohne Authentifizierung zulässt.

Ausgehende Anrufe und Kampagnen können anschließend deinen Trunk und deine Anrufer-IDs nutzen.

## Erweitert

Klappe **Erweitert** auf, wenn du einen BYO-Trunk erstellst oder bearbeitest:

| Einstellung                              | Bedeutung                                                 | Empfehlung                                                                                                                         |
| ---------------------------------------- | --------------------------------------------------------- | ---------------------------------------------------------------------------------------------------------------------------------- |
| **Secure Trunking (TLS + SRTP)**         | Verschlüsselte Signalisierung + Medien                    | Aktivieren, wenn der Carrier Secure Trunking / TLS+SRTP unterstützt                                                                |
| **Medienverschlüsselung**                | Allow (SRTP bevorzugt) oder Require SRTP                  | Allow, außer Compliance-Vorgaben verlangen Require                                                                                 |
| **Custom Outbound Headers**              | X-\* in ausgehenden INVITEs (max. 10)                     | Leer lassen, außer die Carrier-Doku verlangt einen Header                                                                          |
| **Inbound Headers (200 OK)**             | Custom X-\* im SIP 200 OK                                 | In der Regel leer                                                                                                                  |
| **Header-zu-Attribut-Zuordnungen**       | SIP-Header auf Anruf-Attribute für Agenten/Tools abbilden | Nur, wenn du Carrier-Metadaten brauchst                                                                                            |
| **SIP-Header als Attribute einbeziehen** | Keine / alle X-\* / alle Header                           | **Keine** (nur zuordnen, was du wirklich brauchst)                                                                                 |
| **Media-Codecs**                         | Zusätzliche SDP-Codecs (PCMU, PCMA, G.722, AMR-WB)        | Plattform-Standards beibehalten; AMR-WB nur bei Bedarf ergänzen. „Nur gelistete Codecs" vermeiden, außer du kennst die Peer-Codecs |
| **Media-/Ring-Timeouts**                 | Optionale Overrides (Sekunden)                            | Leer lassen (Plattform-Standards), außer zur Fehlersuche                                                                           |

**HD Voice (G.722):** bei Bedarf in den **Telnyx**-Connection-/Codec-Einstellungen aktivieren (mit Telnyx möglich, nicht mit Twilio).

## Später bearbeiten

Bestehende Trunks bearbeitest du über **Nummern → Konfigurieren → Carrier-Einstellungen** (nicht über eine separate Trunk-Liste unter SIP-Integration hinzufügen).

## EU-Routing

Für Kunden in der EU kann der SIP-Traffic auf dem **EU-gepinnten SIP-Endpunkt** der Plattform enden – Medien und Signalisierung bleiben dabei innerhalb der EU, relevant für die DSGVO-Dokumentation. Die Medien-/Agent-Verarbeitung läuft in Frankfurt (eu-central).

## Limits und Verhalten

* E.164-Nummern auf BYO-Trunks zählen zum gleichen Plan-Limit wie gekaufte Nummern (`max_own_numbers`).
* Anrufe über deinen eigenen Trunk umgehen den Carrier-Aufschlag der Plattform pro Ziel – dein Anbieter rechnet die Terminierung direkt ab. Plan-Minuten werden trotzdem verbraucht, siehe [Abrechnung](/billing/minutes).
* Alle Assistent-Funktionen – Flows, Warmübergabe, Aufzeichnung, Monitoring – funktionieren auf BYO-Trunks genauso.

## API

Erstelle und verwalte Trunks über die Public API (`POST /sip-trunks` und verwandte Endpunkte in der API-Referenz). Beim Erstellen werden dieselben Felder wie im UI akzeptiert (`trunk_kind`, `calling_number_format`, `transport`, Advanced-Zuordnungen usw.); Passwörter werden nie zurückgegeben.

<Tip>
  Teste zuerst eingehende Anrufe: Ruf eine deiner Nummern an und prüfe, ob sie unter **Anrufe** mit dem richtigen Assistenten auftaucht. Verifiziere ausgehende Anrufe danach mit einem einzelnen Testanruf, bevor du den Trunk in Kampagnen einbindest.
</Tip>
