Skip to main content
POST
SIP-Trunk erstellen
Dieser Endpunkt erstellt einen neuen SIP-Trunk. Die Plattform provisioniert automatisch Inbound- und Outbound-Trunks in der Voice-Infrastruktur anhand der übergebenen Daten.

Body-Parameter

string
erforderlich
Der Typ des SIP-Trunks: extension für eine SIP-Erweiterung oder number für eine Telefonnummer (DID). Das bestimmt das erwartete Format für phone_number.
string
erforderlich
SIP-Erweiterung (1-15 Zeichen, z. B. 1000) bei sip_trunk_type = extension oder Telefonnummer im E.164-Format (z. B. +14155551234) bei sip_trunk_type = number.
string
Ein kurzes, menschenlesbares Label für den Trunk (z. B. „Provider X — Haupt“). Maximal 50 Zeichen.
string
erforderlich
Benutzername für SIP-Authentifizierung (3-128 Zeichen)
string
erforderlich
Passwort für SIP-Authentifizierung (mindestens 3 Zeichen)
string
erforderlich
SIP-Serveradresse ohne Port (z. B. sip.provider.com)
string
erforderlich
Das ausgehende Rufnummernformat:
  • +e164 - International mit +-Präfix (z. B. +12025550123)
  • e164 - International ohne +-Präfix (z. B. 12025550123)
  • national - Nationales Format ohne Ländervorwahl (z. B. 0741926265)
string
erforderlich
Authentifizierung für eingehende Anrufe:
  • auth - Verwendet denselben SIP-Benutzernamen und dasselbe Passwort wie Outbound
  • ip - Whitelistet bestimmte IP-Adressen (erfordert allowed_inbound_ips)
array
Array mit IP-Adressen, die eingehende Anrufe senden dürfen. Pflichtfeld, wenn inbound_authorization_type auf ip steht. Muss mindestens eine gültige IP enthalten.
string
erforderlich
ISO-3166-2-Ländercode, in dem sich der SIP-Trunk befindet (z. B. US, GB, DE). Bei sip_trunk_type = number wird das Land nach Möglichkeit aus der Telefonnummer erkannt.
boolean
Leitet ausgehende Anrufe über eine feste IP-Adresse. Standard: false. Nur aktivieren, wenn dein SIP-Provider IP-basierte Authentifizierung für Outbound erfordert.

Antwort

string
Erfolgsmeldung
object
Das erstellte SIP-Trunk-Objekt (gleiche Felder wie bei SIP-Trunk abrufen)

Was nach der Erstellung passiert

Wenn du einen SIP-Trunk erstellst, passiert automatisch:
  1. Provisionierung eines Inbound-Trunks in der Voice-Infrastruktur - je nach inbound_authorization_type per Benutzername/Passwort oder IP-Authentifizierung
  2. Provisionierung eines Outbound-Trunks - mit der von dir angegebenen SIP-Adresse und den Zugangsdaten, optional über den Outbound-Proxy
Falls die Provisionierung fehlschlägt, wird der SIP-Trunk nicht gespeichert und ein 500-Fehler zurückgegeben.

Nächste Schritte

Nach dem Erstellen kannst du den SIP-Trunk einem KI-Assistenten zuweisen: