SIP-Trunking

Überblick

Mit SIP-Trunking (Session Initiation Protocol) können Sie Ihre bestehende Telefonieinfrastruktur direkt mit ElevenLabs Agents verbinden. Diese Integration ermöglicht es allen Kunden, ihre bestehenden Telefonsysteme zu nutzen und gleichzeitig die fortschrittlichen Voice-KI-Funktionen von ElevenLabs einzusetzen.

Mit SIP-Trunking können Sie:

• Ihre Private Branch Exchange (PBX) oder Ihr SIP-fähiges Telefonsystem mit der Voice-KI-Plattform von ElevenLabs verbinden
• Anrufe ohne Änderungen an Ihrer bestehenden Telefonieinfrastruktur an KI-Agents weiterleiten
• Eingehende und ausgehende Anrufe verarbeiten
• 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 aus Ihrem 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. So können Ihre Agents ausgehende Anrufe tätigen.
3. Authentifizierung: Die Verbindungssicherheit für die Signalisierung wird entweder durch Digest-Authentifizierung (Benutzername/Passwort) oder durch eine Access Control List (ACL)-Authentifizierung anhand der Quell-IP der Signalisierung gewährleistet.
4. Signalisierung und Medien: Der anfängliche Anrufaufbau (Signalisierung) unterstützt mehrere Transportprotokolle, darunter TLS für verschlüsselte Kommunikation. Nach dem Aufbau des Anrufs können die eigentlichen Audiodaten (RTP-Stream) je nach Ihren Einstellungen für die Medienverschlüsselung verschlüsselt werden.

Transportsicherheit: Zertifikate und Cipher Suites

Bei 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 akzeptiert, 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, und Ihr System validiert es als TLS-Client.
• 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 in der SIP-Referenz.

Folge-Verbindungen

Einige dialoginterne Anfragen wie 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 Anrufaufbau:

• 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, stellt es die Verbindung zu der Adresse im obersten Via-Header her, die häufig eine IP-Adresse ist. Ihr System gibt in der Regel ein Zertifikat zurück, das für einen vollständig qualifizierten Domainnamen (FQDN) und nicht für diese IP-Adresse gültig ist. Um dieses Zertifikat zu validieren, konfigurieren Sie das Feld Remote Domains in den Einstellungen Ihrer Telefonnummer. 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 durchführen

Wenn Sie Anrufe zur 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 für Tests verwenden, nicht in der Produktion)

Um einen Anruf durchzuführen, erstellen Sie eine vollständige SIP-URI, die einen Identifikator enthält. Um beispielsweise die Telefonnummer +19991234567 über TCP anzurufen:

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

Dabei gilt:

• +19991234567 ist der Identifikator (in der Regel eine Telefonnummer im E.164-Format)
• Der Identifikator kann auch ein beliebiger Zeichenfolgenwert sein, etwa 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 ein Telefonsystem
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: Für erhöhte Sicherheit muss Ihr SIP-Trunk-Anbieter TLS-Transport unterstützen
6. Kompatibilität mit Audio-Codecs: Ihr System muss mindestens einen der Audio-Codecs G.722 oder G.711 (PCMU oder PCMA) unterstützen oder auf Ihrer Seite Audio-Resampling durchführen können. Dies ist unabhängig von Audioformaten, die für direkte WebSocket-Verbindungen im Agenten konfiguriert sind.

SIP-Trunking einrichten

1

Zu Telefonnummern navigieren

Öffnen Sie den Bereich Phone Numbers im ElevenLabs-Agents-Dashboard.

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 Telefonnummer im E.164-Format, die verbunden werden soll (z. B. +15551234567)

4

Einstellungen für eingehende Anrufe konfigurieren

Konfigurieren Sie, wie ElevenLabs Anrufe verarbeitet, die bei 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: Ermöglicht verschlüsselte Medienstreams
  • Required: Erzwingt verschlüsselte Medienstreams
• Allowed Numbers (Optional): Telefonnummern, die berechtigt sind, diese Nummer anzurufen. 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 Digest-Authentifizierungsdaten 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 der 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 einem gültigen Zertifikat.

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

  • TCP: Standard-TCP-Transport
  • TLS: Verschlüsselter TLS-Transport für erhöhte Sicherheit
  • UDP: Verbindungsloser Transport (experimentell; verwenden Sie TCP oder TLS für die Produktion)

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

  • Disabled: Keine Medienverschlüsselung
  • Allowed: Ermöglicht 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 für ausgehende Anrufe hinzu. Klicken Sie auf „Add Header“, um den von Ihrem Anbieter benötigten Header-Namen und -Wert einzugeben. Sie können bei Bedarf mehrere Header hinzufügen. Benutzerdefinierte Header können für Anrufweiterleitung und -identifizierung, Abrechnungs- und Tracking-Zwecke sowie anbieterspezifische Anforderungen verwendet werden.

• Authentication (Optional): Geben Sie Digest-Authentifizierungsdaten an, falls Ihr SIP-Trunk-Anbieter diese verlangt.

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

  Wenn die Felder leer bleiben, wird die Authentifizierung über eine Access Control List (ACL) verwendet. Dazu müssen Sie ElevenLabs-IP-Adressen in den Einstellungen Ihres Anbieters auf die Allowlist setzen.

Sicherheits-Best-Practice: Verwenden Sie TLS-Transport mit Required-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-Adress-Allowlisting für die Zugriffskontrolle

Die Digest-Authentifizierung wird dringend empfohlen, da sie bessere Sicherheit bietet, ohne auf IP-Allowlisting angewiesen zu sein, das bei dynamischen IP-Adressen aufwendig 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-Payload und SIP-INVITE-Anfrage ein:

• X-CALL-ID: Eindeutiger Identifikator für den Anruf
• X-CALLER-ID: Identifikator der anrufenden Partei

Diese Header ermöglichen es 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 eindeutiger Anrufidentifikator

Dieser Fallback gewährleistet Kompatibilität mit Twilios Elastic SIP Trunking, ohne dass Konfigurationsänderungen erforderlich sind.

Verarbeitungsablauf

Sobald die relevanten Metadaten über einen der unterstützten Header empfangen wurden, stehen caller_id und/oder call_id im Webhook zur Gesprächsinitiierung und als dynamische Systemvariablen zur Verfügung.

Benutzerdefinierte Header für eingehende Anrufe als dynamische Variablen

Benutzerdefinierte SIP-X--Header aus eingehenden SIP-Trunking-Anrufen werden in der Konversation automatisch als dynamische Variablen verfügbar gemacht.

Header-Namen 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 vom Anrufer bereitgestelltem Kontext zu personalisieren. Die Werte sind auch im Gesprächsverlauf 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 in Ihrer SIP-Trunk-Konfiguration dynamische Variablen Header-Namen zuordnen.

Setzen Sie attributes_to_headers für 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-Header-Namen zu, der im BYE enthalten sein soll:

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

Der Header-Wert ist der endgültige Wert der dynamischen Variable am Ende der Konversation. Werte, die während des Anrufs festgelegt werden – über Agent-Tools, Webhook-Überschreibungen oder andere Laufzeitaktualisierungen –, werden im BYE übernommen.

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. Öffnen Sie den Bereich Phone Numbers im ElevenAgents-Dashboard
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 Abonnementtarif ab. Aktivieren Sie die Anrufwarteschlange, um eingehende Anrufer bei Erreichen des Limits in die Warteschlange zu setzen, statt sie abzuweisen
• Anrufaufzeichnung und Analysefunktionen sind verfügbar, erfordern jedoch 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. Überprüfen Sie die Kompatibilität, bevor Sie Verschlüsselung verpflichtend machen
• Audioformat: Die SIP-Bereitstellung von ElevenLabs sendet und empfängt Audio über die Codecs PCMU oder PCMA (G.711, 8 kHz) bzw. G.722 (16 kHz). Dies ist unabhängig von Audioformaten, die für direkte WebSocket-Verbindungen im Agenten konfiguriert sind. Ihr SIP-Trunk-System muss entweder einen dieser Codecs nativ unterstützen oder Resampling durchführen, um den Anforderungen Ihres Systems zu entsprechen

FAQ

Nächste Schritte

• SIP-Referenz: Glossar zu SIP- und Netzwerkbegriffen
• Erfahren Sie mehr über das Erstellen von ElevenLabs-Agents