Bandwidth-SIP-Trunking
Bandwidth-SIP-Trunking
Verbinden Sie Bandwidth-SIP-Trunks mit ElevenLabs Agents.
Lesen Sie vor dieser Anleitung gegebenenfalls die Anleitung zum SIP- Trunking, um zu verstehen, wie ElevenLabs SIP- Trunks unterstützt.
Übersicht
Diese Anleitung erklärt, wie Sie Ihre Bandwidth-SIP-Trunks direkt mit ElevenLabs Agents verbinden. Mit dieser Integration können Sie Ihre bestehenden Bandwidth-Telefonnummern und -Infrastruktur nutzen und zugleich die fortschrittlichen Voice-KI-Funktionen von ElevenLabs für eingehende und ausgehende Anrufe einsetzen.
So funktioniert SIP-Trunking mit Bandwidth
SIP-Trunking stellt eine direkte Verbindung zwischen Ihrer Bandwidth-Telefonieinfrastruktur und der ElevenLabs-Plattform her:
- Eingehende Anrufe: Anrufe von Bandwidth werden über unsere Origination-URI an die ElevenLabs-Plattform weitergeleitet. Sie konfigurieren dies in der Bandwidth App über ein Voice Configuration Package (VCP).
- Ausgehende Anrufe: Von ElevenLabs initiierte Anrufe werden über Ihre Realm-FQDN oder Ihre Termination-SBC-Adressen an Ihren Bandwidth-SIP-Trunk geleitet, sodass Ihre Agents ausgehende Anrufe tätigen können.
- Authentifizierung: Bandwidth bietet SIP-basierte Authentifizierung für Unified-Communications-(UC)-Trunks und nutzt dabei Digest-Authentifizierung über SIP-Anmeldedaten (Network Bridge). Diese Methode ist erforderlich, um ausgehende Anrufe von ElevenLabs zu ermöglichen und sichere Kommunikation zu gewährleisten.
- Signalisierung und Medien: Der anfängliche Anrufaufbau (Signalisierung) verwendet UDP/TLS. Nach dem Aufbau des Anrufs werden die eigentlichen Audiodaten (RTP-Stream) über UDP übertragen.
Anforderungen
Stellen Sie vor der Einrichtung der Bandwidth-SIP-Trunk-Integration sicher, dass Sie über Folgendes verfügen:
- Ein aktives ElevenLabs-Konto
- Ein aktives Bandwidth-Universal-Platform-Konto mit aktiviertem SIP-Trunking (mit aktiviertem sip-auth)
- Mindestens eine Telefonnummer, die Sie gekauft oder in Ihr Bandwidth-Konto portiert haben
- Administratorzugriff auf Ihr Konto in der Bandwidth App
Eingehende Anrufe konfigurieren (Bandwidth zu ElevenLabs)
Konfigurieren Sie die Origination-Einstellungen von Bandwidth, um eingehende Anrufe an ElevenLabs weiterzuleiten.
Voice Configuration Package erstellen
- Navigieren Sie zum Tab Service Management und wählen Sie Voice Configuration.
- Klicken Sie auf Create New, um ein neues Voice Configuration Package zu erstellen.
- Geben Sie einen eindeutigen Paketnamen ein.
- Klicken Sie auf Add Route.
- Wählen Sie Route to Domain Name.
- Geben Sie die von ElevenLabs bereitgestellte FQDN in das dafür vorgesehene Feld ein. Dies ist in der Regel
sip.rtc.elevenlabs.io. Wenn Ihr ElevenLabs-Konto eine isolierte Datenresidenzregion oder die statische SIP-Infrastruktur verwendet, nutzen Sie stattdessen den entsprechenden SIP-Endpunkt. Verfügbare Regionen finden Sie unter Datenresidenz. - Klicken Sie auf Save, um die Erstellung des Voice Configuration Package abzuschließen.
Weitere Details finden Sie in der Bandwidth-VCP- Dokumentation.
Ausgehende Anrufe konfigurieren (ElevenLabs zu Bandwidth)
Für ausgehende Anrufe muss sich ElevenLabs bei Bandwidth authentifizieren. Der empfohlene Ansatz ist die SIP-Digest-Authentifizierung über ein Realm und Anmeldedaten.
Ein Realm erstellen
- Wählen Sie in der Bandwidth App Account und klicken Sie auf SIP Credentials.
- Scrollen Sie zu Manage Realms und klicken Sie auf Add.
- Geben Sie einen Realm-Namen und optional eine Beschreibung ein und klicken Sie dann auf Add.
Bandwidth erstellt eine Realm-FQDN im Format {realmname}.{hash}.auth.bandwidth.com. Notieren Sie diese FQDN — Sie verwenden sie als ausgehende Adresse in ElevenLabs.
Wenn der Tab SIP Credentials nicht angezeigt wird, wenden Sie sich an Ihren Bandwidth Account Manager oder eröffnen Sie ein Ticket beim Bandwidth-Support, um die SIP-Authentifizierung für Ihr Konto zu aktivieren.
SIP-Anmeldedaten erstellen
- Klicken Sie im Bereich SIP Credentials auf Add.
- Geben Sie einen Username und ein Password ein.
- Wählen Sie das Realm aus, das Sie im vorherigen Schritt erstellt haben.
- Klicken Sie auf Add SIP Credentials.
Speichern Sie Benutzername und Passwort sicher. Sie geben sie in der ElevenLabs-SIP-Trunk-Konfiguration ein.
Ihre Realm-FQDN notieren
Ihre ausgehende Termination-Adresse ist die nach der Erstellung angezeigte Realm-FQDN (z. B. myrealm-a1b2c3.auth.bandwidth.com). Geben Sie diesen Hostnamen im Feld Address ein, wenn Sie die Einstellungen für ausgehende Anrufe in ElevenLabs konfigurieren.
Um die mit Ihrem Realm verknüpften SBC-IP-Adressen zu prüfen, führen Sie eine SRV-Abfrage aus:
Bandwidth stellt zur Redundanz ein gekoppeltes SBC-IP-Paar bereit. Beide müssen für ausgehenden Datenverkehr erreichbar sein.
Einrichtung in ElevenLabs abschließen
Importieren Sie nach der Konfiguration dieser Einstellungen in der Bandwidth App Ihre Telefonnummer in ElevenLabs:
SIP-Trunk-Telefonnummer importieren
Folgen Sie der Anleitung zum SIP-Trunking, um Ihre Bandwidth-Telefonnummer zu importieren. Verwenden Sie folgende Einstellungen:
- Transport type: UDP (oder TLS, wenn Ihr Bandwidth-Trunk verschlüsselte Signalisierung verwendet)
- Media encryption: Entsprechend Ihrer Bandwidth-Trunk-Konfiguration
- Outbound address: Ihre Realm-FQDN (z. B.
myrealm-a1b2c3.auth.bandwidth.com) - SIP trunk username and password: Die in der Bandwidth App erstellten Anmeldedaten
Einen Agent zuweisen
Weisen Sie nach dem Import einen Agenten der Telefonnummer im Phone-Numbers-Dashboard zu.
Folgen Sie nach der Einrichtung Ihres Bandwidth-SIP-Trunks der Anleitung zum SIP- Trunking, um die Konfiguration in ElevenLabs abzuschließen.
Fehlerbehebung
Eingehende Anrufe können keine Verbindung herstellen
- Prüfen Sie, ob
sip.rtc.elevenlabs.ioals Routing-Ziel in den VCP-Origination-Einstellungen von Bandwidth eingetragen ist. - Bestätigen Sie, dass die Telefonnummer dem VCP mit den richtigen Origination-Einstellungen zugewiesen ist.
- Stellen Sie sicher, dass das Telefonnummernformat in ElevenLabs dem von Bandwidth gesendeten E.164-Format entspricht (mit führendem
+). - Prüfen Sie, ob Ihre Firewall SIP-Signalisierungsdatenverkehr über das konfigurierte Transportprotokoll und den Port zulässt (5060 für UDP, 5061 für TLS) und RTP-Ports nicht blockiert sind.
Ausgehende Anrufe erhalten Fehler 407 oder Authentifizierungsfehler
- Bestätigen Sie, dass SIP trunk username, password und realm in ElevenLabs mit den in der Bandwidth App erstellten Anmeldedaten übereinstimmen.
- Prüfen Sie, ob das Feld Address nur den Realm-FQDN-Hostnamen ohne das Präfix
sip:enthält. - Stellen Sie sicher, dass der Transporttyp in den ElevenLabs-Einstellungen für ausgehende Anrufe Ihrer Bandwidth-Trunk-Konfiguration entspricht (UDP oder TLS).
Einseitiges Audio oder kein Audio
- Bestätigen Sie, dass RTP-Ports für Mediendatenverkehr geöffnet und nicht durch Ihre Firewall blockiert sind.
- Prüfen Sie die Kompatibilität des G711ulaw-Codecs. Bandwidth und ElevenLabs unterstützen beide G711.
FAQ
Welchen Signalisierungstransport und welche Ports benötigt Bandwidth?
Bandwidth und ElevenLabs verwenden UDP auf Port 5060 für die SIP-Signalisierung. Wenn Ihr Bandwidth-Trunk für verschlüsselten Transport konfiguriert ist, verwenden Sie stattdessen TLS auf Port 5061.
Welches Telefonnummernformat sollte ich verwenden?
Verwenden Sie das E.164-Format mit führendem + (z. B. +19192971100). Bandwidth sendet und erwartet Nummern in diesem Format.
Welche Audio-Codecs sind kompatibel?
ElevenLabs unterstützt G711 und G722. Bandwidth unterstützt G711ulaw und G729a. G711ulaw ist der empfohlene Codec für die Kompatibilität zwischen beiden Plattformen.