Early Access: Die Schnittstellen sind als Entwurf dokumentiert. Befehle, Pakete und Endpunkte vor der Nutzung mit uns abstimmen.

Mit deinem Voice-Stack verbinden

Eingehende Anrufe per SIP an deinen Agenten leiten und ausgehend über deine Nummer telefonieren.

Eingehende Anrufe

Jede Nummer zeigt auf ein SIP-Ziel. Dorthin schicken wir jeden eingehenden Anruf.

trunkbeam numbers update +493023125417 --sip sip:agent@voice.example

Mehrere Ziele gehen der Reihe nach, wenn das erste nicht antwortet. Als letztes Ziel ist auch eine normale Rufnummer erlaubt, zum Beispiel dein Büro:

trunkbeam numbers update +493023125417 \
  --sip sip:agent@voice.example \
  --fallback sip:backup@voice.example \
  --fallback +4930123456

Im SIP-INVITE bekommst du die Nummer des Anrufers im From-Header und deine gewählte Nummer im To-Header. So kann dein Agent pro Nummer anders reagieren.

Ausgehende Anrufe

Für ausgehende Anrufe legst du einen SIP-Trunk an. Du bekommst Host, Benutzername und Passwort, die du bei deiner Voice-Plattform einträgst.

trunkbeam trunks create --name vapi-produktion
Host:      sip.trunkbeam.com
Benutzer:  trk_4c1e9
Passwort:  (wird einmal angezeigt)
Rufnummern: alle Nummern deines Kontos

Als Absender sind nur Nummern aus deinem Konto erlaubt. Andere Absender lehnen wir ab, damit niemand mit fremden Nummern telefoniert.

Einrichtung bei deiner Plattform

Die Voice-Plattformen nennen das meist „Bring your own SIP trunk“, „Custom telephony“ oder „SIP trunk“. Der Ablauf ist überall ähnlich:

  1. Bei der Plattform einen SIP-Trunk mit Host sip.trunkbeam.com und den Zugangsdaten von oben anlegen.
  2. Deine Nummer bei der Plattform eintragen und dem Agenten zuweisen.
  3. Die SIP-Adresse, die die Plattform für eingehende Anrufe nennt, bei uns als Ziel setzen.

HD-Telefonie mit G.722

TrunkBeam unterstützt HD-Telefonie mit dem Breitband-Codec G.722. Der Codec überträgt einen größeren Sprachfrequenzbereich als klassische Schmalband-Telefonie.

HD-Qualität setzt voraus, dass Endgerät, Voice-Plattform und der gesamte Verbindungsweg Breitbandaudio unterstützen. Auf der SIP-Verbindung müssen die beteiligten Systeme einen passenden Codec aushandeln. Ein HD-fähiges Telefon allein reicht nicht aus, wenn eine andere Teilstrecke nur Schmalband-Audio überträgt, etwa mit G.711. Eine spätere Umwandlung in G.722 stellt die dabei verlorenen Frequenzen nicht wieder her.

Das gilt auch beim Durchstellen: Ob die Verbindung zum neuen Ziel HD-Qualität bietet, hängt von dessen Endgerät und dem Verbindungsweg ab.

Technischer Hintergrund: ITU-T G.722 und Codec-Aushandlung mit SDP nach RFC 3264.

Technische Eckdaten

SignalisierungSIP über TLS (Port 5061), UDP und TCP (Port 5060)
MedienSRTP und RTP
CodecsG.711 A-law (PCMA), G.711 µ-law (PCMU), G.722, Opus
DTMFRFC 2833 (telephone-event)
RufnummernformatE.164, zum Beispiel +493023125417

Die IP-Bereiche für Firewall-Freigaben veröffentlichen wir zum Start.

Deinen Stack mit TrunkBeam verbinden