Zum Hauptinhalt springen
POST
/
api
/
user
/
phone-numbers
/
sip-trunks
SIP-Trunk erstellen
curl --request POST \
  --url https://app.famulor.de/api/user/phone-numbers/sip-trunks \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "sip_trunk_type": "<string>",
  "phone_number": "<string>",
  "sip_username": "<string>",
  "sip_password": "<string>",
  "sip_address": "<string>",
  "sip_calling_format": "<string>",
  "inbound_authorization_type": "<string>",
  "country_code": "<string>"
}
'
{
  "message": "SIP trunk created successfully.",
  "data": {
    "id": 42,
    "phone_number": "1000",
    "sip_username": "myuser",
    "sip_address": "sip.provider.com",
    "sip_calling_format": "+e164",
    "inbound_authorization_type": "auth",
    "allowed_inbound_ips": null,
    "outbound_proxy": false,
    "country_code": "US",
    "inbound_trunk_id": "ST_xxxxxxxxxxxx",
    "outbound_trunk_id": "ST_yyyyyyyyyyyy",
    "created_at": "2026-03-31T10:00:00.000000Z",
    "updated_at": "2026-03-31T10:00:00.000000Z"
  }
}
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

​
sip_trunk_type
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.
​
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.
​
sip_username
string
erforderlich
Benutzername für SIP-Authentifizierung (3-128 Zeichen)
​
sip_password
string
erforderlich
Passwort für SIP-Authentifizierung (mindestens 3 Zeichen)
​
sip_address
string
erforderlich
SIP-Serveradresse ohne Port (z. B. sip.provider.com)
​
sip_calling_format
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)
​
inbound_authorization_type
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)
​
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.
​
country_code
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.
​
outbound_proxy
boolean
Leitet ausgehende Anrufe über eine feste IP-Adresse. Standard: false. Nur aktivieren, wenn Ihr SIP-Provider IP-basierte Authentifizierung für Outbound erfordert.

​
Antwort

​
message
string
Erfolgsmeldung
​
data
object
Das erstellte SIP-Trunk-Objekt (gleiche Felder wie bei SIP-Trunk abrufen)
{
  "message": "SIP trunk created successfully.",
  "data": {
    "id": 42,
    "phone_number": "1000",
    "sip_username": "myuser",
    "sip_address": "sip.provider.com",
    "sip_calling_format": "+e164",
    "inbound_authorization_type": "auth",
    "allowed_inbound_ips": null,
    "outbound_proxy": false,
    "country_code": "US",
    "inbound_trunk_id": "ST_xxxxxxxxxxxx",
    "outbound_trunk_id": "ST_yyyyyyyyyyyy",
    "created_at": "2026-03-31T10:00:00.000000Z",
    "updated_at": "2026-03-31T10:00:00.000000Z"
  }
}

​
Was nach der Erstellung passiert

Wenn Sie einen SIP-Trunk erstellen, 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 Ihnen 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 können Sie den SIP-Trunk einem KI-Assistenten zuweisen: