SIP-Trunking

Überblick

SIP-Trunking (Session Initiation Protocol) ermöglicht Ihnen, Ihre bestehende Telefonieinfrastruktur direkt mit ElevenLabs Agents zu verbinden. Mit dieser Integration können alle Kunden ihre bestehenden Telefonsysteme nutzen und gleichzeitig die fortschrittlichen Voice-AI-Funktionen von ElevenLabs einsetzen.

Mit SIP-Trunking können Sie:

• Ihre Private Branch Exchange (PBX) oder Ihr SIP-fähiges Telefonsystem mit der Voice-AI-Plattform von ElevenLabs verbinden
• Anrufe an KI-Agenten weiterleiten, ohne Ihre bestehende Telefonieinfrastruktur zu ändern
• Eingehende und ausgehende Anrufe abwickeln
• Verschlüsselten TLS-Transport und Medienverschlüsselung für mehr Sicherheit nutzen

So funktioniert SIP-Trunking

SIP-Trunking stellt eine direkte Verbindung zwischen Ihrer Telefonieinfrastruktur und der ElevenLabs-Plattform her:

1. Eingehende Anrufe: Anrufe über Ihren SIP-Trunk werden über Ihre konfigurierte SIP-INVITE-Adresse an die ElevenLabs-Plattform weitergeleitet.
2. Ausgehende Anrufe: Von ElevenLabs initiierte Anrufe werden über Ihren konfigurierten Hostnamen an Ihren SIP-Trunk weitergeleitet, sodass Ihre Agenten ausgehende Anrufe tätigen können.
3. Authentifizierung: Die Verbindungssicherheit für die Signalisierung wird entweder durch Digest-Authentifizierung (Benutzername/Passwort) oder durch Access-Control-List-Authentifizierung (ACL) basierend auf der IP-Quelladresse der Signalisierung gewährleistet.
4. Signalisierung und Medien: Der anfängliche Verbindungsaufbau (Signalisierung) unterstützt mehrere Transportprotokolle, einschließlich TLS für verschlüsselte Kommunikation. Nach dem Aufbau des Anrufs können die eigentlichen Audiodaten (RTP-Stream) abhängig von Ihren Einstellungen zur Medienverschlüsselung verschlüsselt werden.

Transportsicherheit: Zertifikate und Cipher Suites

Bei der Verwendung von TLS-Transport führen beide Seiten einen TLS-Handshake durch, bevor SIP-Signalisierung ausgetauscht wird. Während des Handshakes validieren sie ein Zertifikat und handeln eine Cipher Suite aus. Die Seite, die die Verbindung annimmt, fungiert als TLS-Server und präsentiert das Zertifikat; die Seite, die die Verbindung öffnet, fungiert als TLS-Client und validiert es. ElevenLabs erfordert TLS 1.2 oder höher.

Die Rollen hängen von der Anrufrichtung ab:

• Eingehende Anrufe bei ElevenLabs: Ihr System öffnet die Verbindung, daher fungiert ElevenLabs als TLS-Server. ElevenLabs präsentiert ein gültiges Zertifikat für sip.rtc.elevenlabs.io, das Ihr System als TLS-Client validiert.
• Ausgehende Anrufe von ElevenLabs: ElevenLabs öffnet die Verbindung zu der von Ihnen konfigurierten Adresse, daher fungiert Ihr SIP-Server oder SBC als TLS-Server. Ihr System muss ein gültiges, vertrauenswürdiges Zertifikat präsentieren, das ElevenLabs als TLS-Client validiert.

Stellen Sie sicher, dass beide Seiten den Zertifikaten der jeweils anderen Seite vertrauen und mindestens eine gemeinsame Cipher Suite unterstützen. Andernfalls schlägt der TLS-Handshake fehl, bevor der Anruf aufgebaut wird. Definitionen dieser Begriffe finden Sie im SIP-Referenzhandbuch.

Folge-Verbindungen

Einige Anfragen innerhalb eines Dialogs, etwa BYE oder REFER, können eine neue TLS-Verbindung erfordern, wenn die ursprüngliche Verbindung bereits geschlossen wurde. Das Zertifikatsverhalten für diese Folge-Verbindungen unterscheidet sich vom anfänglichen Verbindungsaufbau:

• Folge-Verbindungen zu ElevenLabs: Ihr System stellt die Verbindung zur Adresse im Contact-Header her, die in der Antwort zurückgegeben wird. Diese wird zu einem bestimmten SIP-Server im Format <ip>.hosts.rtc.elevenlabs.io aufgelöst. Dieser Server präsentiert ein Zertifikat, das für *.hosts.rtc.elevenlabs.io gültig ist und von Ihrem System als TLS-Client validiert wird.
• Folge-Verbindungen von ElevenLabs: Wenn ElevenLabs eine TLS-Verbindung für ein BYE oder REFER initiiert, verbindet es sich mit der Adresse im obersten Via-Header, bei der es sich häufig um eine IP-Adresse handelt. Ihr System gibt normalerweise ein Zertifikat zurück, das für einen vollständig qualifizierten Domainnamen (FQDN) statt für diese IP-Adresse gültig ist. Um dieses Zertifikat zu validieren, konfigurieren Sie das Feld Remote domains in Ihren Telefonnummerneinstellungen. Wenn eine Domain, für die das empfangene Zertifikat gültig ist, mit einer konfigurierten Remote-Domain übereinstimmt, ist die Validierung erfolgreich; andernfalls schlägt sie fehl.

Anrufe an den ElevenLabs-SIP-Trunk tätigen

Wenn Sie Anrufe an die ElevenLabs-Plattform initiieren, müssen Sie das richtige SIP-URI-Format verwenden. Die URI des ElevenLabs-SIP-Trunks hängt vom Transport ab, den Sie für die Signalisierung verwenden möchten:

• TCP: sip:sip.rtc.elevenlabs.io:5060;transport=tcp
• TLS: sip:sip.rtc.elevenlabs.io:5061;transport=tls
• UDP: sip:sip.rtc.elevenlabs.io:5060;transport=udp (experimentell; nur zum Testen verwenden, nicht in Produktion)

Um einen Anruf zu tätigen, erstellen Sie eine vollständige SIP-URI mit einer Kennung. Um beispielsweise die Telefonnummer +19991234567 über TCP anzurufen:

sip:+19991234567@sip.rtc.elevenlabs.io:5060

Dabei gilt:

• +19991234567 ist die Kennung (normalerweise eine Telefonnummer im E.164-Format)
• Die Kennung kann auch ein beliebiger Zeichenfolgenwert sein, z. B. 1000 oder john

Anforderungen

Stellen Sie vor der Einrichtung von SIP-Trunking sicher, dass Sie über Folgendes verfügen:

1. Eine SIP-kompatible PBX oder Telefonanlage
2. Telefonnummern, die Sie mit ElevenLabs verbinden möchten
3. Administratorzugriff auf Ihre SIP-Trunk-Konfiguration
4. Geeignete Firewall-Einstellungen, um SIP-Datenverkehr zuzulassen
5. TLS-Unterstützung: Stellen Sie für mehr Sicherheit sicher, dass Ihr SIP-Trunk-Anbieter TLS-Transport unterstützt
6. Audiocodec-Kompatibilität: Ihr System muss mindestens einen der Audiocodecs G.722 oder G.711 (PCMU oder PCMA) unterstützen oder Audio auf Ihrer Seite neu sampeln können. Dies ist unabhängig von einem Audioformat, das für direkte WebSocket-Verbindungen auf dem Agenten konfiguriert ist.

SIP-Trunking einrichten

1

Zu Telefonnummern navigieren

Gehen Sie im ElevenLabs-Agents-Dashboard zum Bereich Phone Numbers.

2

SIP-Trunk importieren

Klicken Sie auf die Schaltfläche „Import number“ und wählen Sie dann „From SIP Trunk“, um den Konfigurationsdialog zu öffnen.

3

Grundkonfiguration eingeben

Vervollständigen Sie die Grundkonfiguration mit folgenden Informationen:

• Label: Ein beschreibender Name für die Telefonnummer
• Phone Number: Die zu verbindende Telefonnummer im E.164-Format (z. B. +15551234567)

4

Einstellungen für eingehende Anrufe konfigurieren

Konfigurieren Sie, wie ElevenLabs Anrufe behandelt, die an Ihrem SIP-Trunk eingehen, einschließlich Medienverschlüsselung und Zugriffskontrollen:

• Media Encryption: Konfigurieren Sie die Verschlüsselung für RTP-Medienstreams:
  • Disabled: Keine Medienverschlüsselung
  • Allowed: Erlaubt verschlüsselte Medienstreams
  • Required: Erzwingt verschlüsselte Medienstreams
• Allowed Numbers (optional): Telefonnummern, die zum Anrufen dieser Nummer berechtigt sind. Lassen Sie das Feld leer, um alle Nummern zuzulassen.
• Allowed Source IP Addresses (optional): Funktioniert nur mit TCP/TLS-Transport, nicht mit UDP. IP-Adressen oder CIDR-Bereiche, die Anrufe an diesen Trunk senden dürfen. Lassen Sie 0.0.0.0/0 stehen, um alle Adressen zuzulassen.
• Remote Domains (optional): Geben Sie die FQDN-Domains Ihrer SIP-Server an, von denen Sie die Anrufe initiieren, z. B. example.pstn.twilio.com. Diese Domains werden für die TLS-Zertifikatsvalidierung verwendet. Lassen Sie dieses Feld leer, wenn Sie kein TLS verwenden.
• Authentication (optional): Geben Sie die Anmeldedaten für die Digest-Authentifizierung an, die zur Authentifizierung eingehender Anrufe verwendet werden.
  • SIP Trunk Username: Benutzername für die SIP-Digest-Authentifizierung
  • SIP Trunk Password: Passwort für die SIP-Digest-Authentifizierung

5

Einstellungen für ausgehende Anrufe konfigurieren

Konfigurieren Sie, wohin ElevenLabs Anrufe für Ihre Telefonnummer senden soll:

• Address: Hostname oder IP-Adresse, an die das SIP INVITE gesendet wird (z. B. sip.telnyx.com). Dies sollte nur ein Hostname oder eine IP-Adresse sein, keine vollständige SIP-URI. Verwenden Sie bei TLS einen Hostnamen mit gültigem Zertifikat.

• Transport Type: Wählen Sie das Transportprotokoll für SIP-Signalisierung:

  • TCP: Standard-TCP-Transport
  • TLS: Verschlüsselter TLS-Transport für mehr Sicherheit
  • UDP: Verbindungsloser Transport (experimentell; verwenden Sie TCP oder TLS in Produktion)

• Media Encryption: Konfigurieren Sie die Verschlüsselung für RTP-Medienstreams:

  • Disabled: Keine Medienverschlüsselung
  • Allowed: Erlaubt verschlüsselte Medienstreams
  • Required: Erzwingt verschlüsselte Medienstreams

• Enabled Codecs: Codecs, die im SDP für ausgehende Anrufe angeboten werden (G.722, PCMU, PCMA). Nützlich, wenn Ihr SIP-Anbieter nur bestimmte Codecs unterstützt.

• Custom Headers (optional): Fügen Sie benutzerdefinierte SIP-Header hinzu, die in ausgehende Anrufe aufgenommen werden. Klicken Sie auf „Add Header“, um den von Ihrem Anbieter benötigten Headernamen und -wert einzugeben. Sie können bei Bedarf mehrere Header hinzufügen. Benutzerdefinierte Header können für Anrufweiterleitung und -identifikation, Abrechnung und Tracking sowie anbieterspezifische Anforderungen verwendet werden.

• Authentication (optional): Geben Sie Anmeldedaten für die Digest-Authentifizierung an, falls Ihr SIP-Trunk-Anbieter dies verlangt.

  • SIP Trunk Username: Benutzername für die SIP-Digest-Authentifizierung
  • SIP Trunk Password: Passwort für die SIP-Digest-Authentifizierung

  Wenn diese Felder leer bleiben, wird die Access-Control-List-Authentifizierung (ACL) verwendet. Dazu müssen Sie die IP-Adressen von ElevenLabs in den Einstellungen Ihres Anbieters zulassen.

Sicherheits-Best-Practice: Verwenden Sie TLS-Transport mit erforderlicher Medienverschlüsselung für maximale Sicherheit. So werden sowohl Signalisierung als auch Medien durchgängig verschlüsselt.

Authentifizierungsmethoden:

• Digest-Authentifizierung: Verwendet Benutzername und Passwort zur sicheren Authentifizierung (empfohlen)
• ACL-Authentifizierung: Verwendet IP-Allowlisting zur Zugriffskontrolle

Die Digest-Authentifizierung wird dringend empfohlen, da sie mehr Sicherheit bietet, ohne auf IP-Allowlisting angewiesen zu sein, das bei dynamischen IP-Adressen komplex zu verwalten sein kann.

Das Feld Address gibt an, wohin ElevenLabs ausgehende Anrufe Ihrer KI-Agenten sendet. Geben Sie nur den Hostnamen oder die IP-Adresse ohne das Protokollpräfix sip: ein.

6

Einrichtung abschließen

Klicken Sie auf „Import“, um die Konfiguration abzuschließen.

Kundendaten und Personalisierung

Um die korrekte Weiterleitung und Nachverfolgbarkeit von Anrufmetadaten sicherzustellen, fügen Sie die folgenden benutzerdefinierten SIP-Header in Ihre Webhook-Nutzlast und SIP-INVITE-Anfrage ein:

• X-CALL-ID: Eindeutige Kennung für den Anruf
• X-CALLER-ID: Kennung der anrufenden Partei

Diese Header ermöglichen dem System, Anrufmetadaten mit der Konversation zu verknüpfen und Kontext für die Personalisierung bereitzustellen.

Unterstützung für Fallback-Header

Wenn die oben genannten Standard-Header nicht vorhanden sind, sucht das System automatisch nach dem Twilio-spezifischen SIP-Header:

• sip.twilio.callSid: Twilios eindeutige Anrufkennung

Dieser Fallback stellt die Kompatibilität mit Twilios Elastic SIP Trunking sicher, ohne Konfigurationsänderungen zu erfordern.

Verarbeitungsablauf

Sobald die relevanten Metadaten über einen der unterstützten Header empfangen wurden, sind caller_id und/oder call_id im Webhook zur Konversationsinitiierung und als dynamische Systemvariablen verfügbar.

Benutzerdefinierte Header eingehender Anrufe als dynamische Variablen

Benutzerdefinierte SIP-X--Header aus eingehenden SIP-Trunking-Anrufen werden automatisch als dynamische Variablen in der Konversation bereitgestellt.

Headernamen werden normalisiert, indem das Präfix X- entfernt, der Name in Kleinbuchstaben umgewandelt, Bindestriche durch Unterstriche ersetzt und das Präfix sip_ hinzugefügt wird. Beispielsweise wird X-Contact-ID zu {{sip_contact_id}} und X-Campaign-ID zu {{sip_campaign_id}}.

Verwenden Sie diese Variablen in Agent-Prompts, ersten Nachrichten und Tools, um die Konversation mit dem vom Anrufer bereitgestellten Kontext zu personalisieren. Die Werte sind auch im Konversationsverlauf auf dem Tab Phone Call sichtbar.

BYE-Header aus dynamischen Variablen

Wenn ein Anruf endet, sendet ElevenLabs ein SIP BYE, um den Dialog zu beenden. Sie können diesem BYE benutzerdefinierte Header hinzufügen, indem Sie dynamische Variablen in Ihrer SIP-Trunk-Konfiguration Headernamen zuordnen.

Setzen Sie attributes_to_headers auf inbound_trunk_config oder outbound_trunk_config, wenn Sie eine SIP-Trunk-Telefonnummer über die API erstellen oder aktualisieren. Jeder Eintrag ordnet einen Namen einer dynamischen Variable dem SIP-Headernamen zu, der im BYE enthalten sein soll:

"inbound_trunk_config": {
  "attributes_to_headers": {
    "dynamic_variable_name": "bye_header_name"
  }
}

Der Headerwert ist der endgültige Wert der dynamischen Variable am Ende der Konversation. Während des Anrufs gesetzte Werte – über Agent-Tools, Webhook-Überschreibungen oder andere Laufzeitaktualisierungen – werden im BYE berücksichtigt.

Wenn attributes_to_headers beispielsweise "disposition_code": "X-Disposition" enthält und die dynamische Variable disposition_code beim Ende der Konversation den Wert resolved hat, enthält das BYE X-Disposition: resolved.

Agenten Telefonnummern zuweisen

Nach dem Import Ihrer SIP-Trunk-Telefonnummer können Sie sie einem ElevenLabs-Agenten zuweisen:

1. Gehen Sie im ElevenAgents-Dashboard zum Bereich Phone Numbers
2. Wählen Sie Ihre importierte SIP-Trunk-Telefonnummer aus
3. Klicken Sie auf „Assign Agent“
4. Wählen Sie den Agenten aus, der Anrufe an diese Nummer bearbeiten soll

Fehlerbehebung

Einschränkungen und Hinweise

• Die Unterstützung mehrerer gleichzeitiger Anrufe hängt von Ihrem Abonnement ab. Aktivieren Sie Anrufwarteschlangen, um eingehende Anrufer bei Erreichen des Limits in die Warteschleife zu setzen, statt sie abzulehnen
• Funktionen für Anrufaufzeichnung und Analysen sind verfügbar, erfordern aber möglicherweise zusätzliche Konfiguration
• Die Möglichkeiten für ausgehende Anrufe können durch Ihren SIP-Trunk-Anbieter eingeschränkt sein
• TLS-Unterstützung: Stellen Sie sicher, dass Ihr SIP-Trunk-Anbieter TLS 1.2 oder höher für verschlüsselten Transport unterstützt
• Medienverschlüsselung: Die SRTP-Unterstützung variiert je nach Anbieter; prüfen Sie die Kompatibilität, bevor Sie Verschlüsselung vorschreiben
• Audioformat: Die SIP-Bereitstellung von ElevenLabs sendet und empfängt Audio mit den Codecs PCMU oder PCMA (G.711, 8 kHz) oder G.722 (16 kHz). Dies ist unabhängig von dem Audioformat, das für direkte WebSocket-Verbindungen beim Agenten konfiguriert ist. Ihr SIP-Trunk-System muss einen dieser Codecs entweder nativ unterstützen oder Resampling durchführen, um die Anforderungen Ihres Systems zu erfüllen

FAQ

Nächste Schritte

• SIP-Referenz: Glossar zu SIP- und Netzwerkbegriffen
• Mehr über das Erstellen von ElevenLabs-Agenten