SIP trunking

Przegląd

SIP (Session Initiation Protocol) trunking pozwala połączyć obecną infrastrukturę telefoniczną bezpośrednio z ElevenLabs Agents. Ta integracja umożliwia wszystkim klientom korzystanie z obecnych systemów telefonicznych i zaawansowanych funkcji głosu AI ElevenLabs.

Dzięki SIP trunking możesz:

• Połączyć swoją centralę Private Branch Exchange (PBX) lub system telefoniczny z obsługą SIP z platformą głosu AI ElevenLabs
• Kierować połączenia do agentów AI bez zmiany obecnej infrastruktury telefonicznej
• Obsługiwać połączenia przychodzące i wychodzące
• Korzystać z szyfrowanego transportu TLS i szyfrowania mediów dla większego bezpieczeństwa

Jak działa SIP trunking

SIP trunking tworzy bezpośrednie połączenie między twoją infrastrukturą telefoniczną a platformą ElevenLabs:

1. Połączenia przychodzące: Połączenia z twojego SIP trunk są kierowane na platformę ElevenLabs przy użyciu skonfigurowanego adresu SIP INVITE.
2. Połączenia wychodzące: Połączenia inicjowane przez ElevenLabs są kierowane do twojego SIP trunk przy użyciu skonfigurowanej nazwy hosta, dzięki czemu twoi agenci mogą wykonywać połączenia wychodzące.
3. Uwierzytelnianie: Bezpieczeństwo połączenia dla sygnalizacji jest utrzymywane przez uwierzytelnianie Digest (nazwa użytkownika/hasło) lub uwierzytelnianie Access Control List (ACL) oparte na źródłowym adresie IP sygnalizacji.
4. Sygnalizacja i media: Początkowe zestawianie połączenia (sygnalizacja) obsługuje wiele protokołów transportowych, w tym TLS dla szyfrowanej komunikacji. Po zestawieniu połączenia właściwe dane audio (strumień RTP) mogą być szyfrowane zgodnie z ustawieniami szyfrowania mediów.

Bezpieczeństwo transportu: certyfikaty i zestawy szyfrów

Gdy używasz transportu TLS, obie strony wykonują uzgadnianie TLS, zanim wymienią sygnalizację SIP. Podczas uzgadniania weryfikują certyfikat i uzgadniają zestaw szyfrów. Strona akceptująca połączenie działa jako serwer TLS i przedstawia certyfikat; strona otwierająca połączenie działa jako klient TLS i go weryfikuje. ElevenLabs wymaga TLS 1.2 lub nowszego.

Role zależą od kierunku połączenia:

• Połączenia przychodzące do ElevenLabs: Twój system otwiera połączenie, więc ElevenLabs działa jako serwer TLS. ElevenLabs przedstawia ważny certyfikat dla sip.rtc.elevenlabs.io, a twój system weryfikuje go jako klient TLS.
• Połączenia wychodzące z ElevenLabs: ElevenLabs otwiera połączenie z adresem, który skonfigurowałeś, więc twój serwer SIP lub SBC działa jako serwer TLS. Twój system musi przedstawić ważny, zaufany certyfikat, który ElevenLabs weryfikuje jako klient TLS.

Upewnij się, że obie strony ufają swoim certyfikatom i mają przynajmniej jeden wspólny zestaw szyfrów. Jeśli nie, uzgadnianie TLS nie powiedzie się przed nawiązaniem połączenia. Definicje tych pojęć znajdziesz w dokumentacji SIP.

Kolejne połączenia

Niektóre żądania w trakcie dialogu, takie jak BYE lub REFER, mogą wymagać nowego połączenia TLS, gdy pierwotne połączenie zostało już zamknięte. Zachowanie certyfikatów dla tych kolejnych połączeń różni się od początkowego zestawiania połączenia:

• Kolejne połączenia do ElevenLabs: Twój system nawiązuje połączenie z adresem nagłówka Contact zwróconym w odpowiedzi, który wskazuje konkretny serwer SIP w formie <ip>.hosts.rtc.elevenlabs.io. Ten serwer przedstawia certyfikat ważny dla *.hosts.rtc.elevenlabs.io, który twój system weryfikuje jako klient TLS.
• Kolejne połączenia z ElevenLabs: Gdy ElevenLabs inicjuje połączenie TLS dla BYE lub REFER, łączy się z adresem w najwyższym nagłówku Via, którym często jest adres IP. Twój system zwykle zwraca certyfikat ważny dla w pełni kwalifikowanej nazwy domeny (FQDN), a nie dla tego adresu IP. Aby zweryfikować ten certyfikat, skonfiguruj pole Remote domains w ustawieniach numeru telefonu. Jeśli dowolna domena, dla której otrzymany certyfikat jest ważny, pasuje do skonfigurowanej domeny zdalnej, weryfikacja się powiedzie; w przeciwnym razie zakończy się niepowodzeniem.

Nawiązywanie połączeń z trunkem SIP ElevenLabs

Podczas inicjowania połączeń z platformą ElevenLabs musisz używać właściwego formatu URI SIP. URI trunku SIP ElevenLabs zależy od transportu, którego chcesz użyć do sygnalizacji:

• 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 (eksperymentalne; używaj tylko do testów, nie na produkcji)

Aby nawiązać połączenie, utwórz pełny URI SIP zawierający identyfikator. Na przykład, aby zadzwonić pod numer +19991234567 przez TCP:

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

Gdzie:

• +19991234567 to identyfikator (zwykle numer telefonu w formacie E.164)
• Identyfikatorem może być też dowolna wartość tekstowa, np. 1000 lub john

Wymagania

Przed konfiguracją trunku SIP upewnij się, że masz:

1. Centralę PBX lub system telefoniczny zgodny z SIP
2. Numery telefonów, które chcesz połączyć z ElevenLabs
3. Dostęp administratora do konfiguracji trunku SIP
4. Odpowiednie ustawienia zapory zezwalające na ruch SIP
5. Obsługę TLS: Aby zwiększyć bezpieczeństwo, upewnij się, że dostawca trunku SIP obsługuje transport TLS
6. Zgodność kodeków audio: Twój system musi obsługiwać co najmniej jeden kodek audio G.722 lub G.711 (PCMU albo PCMA) albo umożliwiać resampling audio po twojej stronie. Nie zależy to od formatu audio skonfigurowanego w agencie dla bezpośrednich połączeń websocket.

Konfiguracja trunku SIP

1

Przejdź do Numerów telefonów

Przejdź do sekcji Numerów telefonów w panelu ElevenLabs Agents.

2

Zaimportuj trunk SIP

Kliknij przycisk „Importuj numer”, a następnie wybierz „Z trunku SIP”, aby otworzyć okno konfiguracji.

3

Wprowadź podstawową konfigurację

Uzupełnij podstawową konfigurację o poniższe informacje:

• Etykieta: Opisowa nazwa numeru telefonu
• Numer telefonu: Numer telefonu w formacie E.164 do połączenia (np. +15551234567)

4

Skonfiguruj ustawienia połączeń przychodzących

Skonfiguruj obsługę połączeń przychodzących do twojego trunku SIP przez ElevenLabs, w tym szyfrowanie mediów i kontrolę dostępu:

• Szyfrowanie mediów: Skonfiguruj szyfrowanie strumieni RTP:
  • Wyłączone: Bez szyfrowania mediów
  • Dozwolone: Zezwala na szyfrowane strumienie mediów
  • Wymagane: Wymusza szyfrowane strumienie mediów
• Dozwolone numery (opcjonalnie): Numery telefonów uprawnione do dzwonienia na ten numer. Pozostaw puste, aby zezwolić na wszystkie numery.
• Dozwolone źródłowe adresy IP (opcjonalnie): Działa tylko z transportem TCP/TLS, nie UDP. Adresy IP lub zakresy CIDR, które mogą wysyłać połączenia do tego trunku. Pozostaw 0.0.0.0/0, aby zezwolić na wszystkie adresy.
• Domeny zdalne (opcjonalnie): Podaj domeny FQDN serwerów SIP, z których inicjujesz połączenia, np. example.pstn.twilio.com. Te domeny są używane do weryfikacji certyfikatów TLS. Pozostaw to pole puste, jeśli nie używasz TLS.
• Uwierzytelnianie (opcjonalnie): Podaj dane uwierzytelniania digest używane do uwierzytelniania połączeń przychodzących.
  • Nazwa użytkownika trunku SIP: Nazwa użytkownika do uwierzytelniania SIP digest
  • Hasło trunku SIP: Hasło do uwierzytelniania SIP digest

5

Skonfiguruj ustawienia połączeń wychodzących

Skonfiguruj, gdzie ElevenLabs ma wysyłać połączenia na twój numer telefonu:

• Adres: Nazwa hosta lub adres IP, na który wysyłany jest SIP INVITE (np. sip.telnyx.com). Powinna to być wyłącznie nazwa hosta lub adres IP, a nie pełny URI SIP. Jeśli używasz TLS, użyj nazwy hosta z ważnym certyfikatem.

• Typ transportu: Wybierz protokół transportu dla sygnalizacji SIP:

  • TCP: Standardowy transport TCP
  • TLS: Szyfrowany transport TLS dla większego bezpieczeństwa
  • UDP: Transport bezpołączeniowy (eksperymentalny; na produkcji używaj TCP lub TLS)

• Szyfrowanie mediów: Skonfiguruj szyfrowanie strumieni RTP:

  • Wyłączone: Bez szyfrowania mediów
  • Dozwolone: Zezwala na szyfrowane strumienie mediów
  • Wymagane: Wymusza szyfrowane strumienie mediów

• Włączone kodeki: Kodeki oferowane w SDP dla połączeń wychodzących (G.722, PCMU, PCMA). Przydatne, gdy dostawca SIP obsługuje tylko niektóre kodeki.

• Niestandardowe nagłówki (opcjonalnie): Dodaj niestandardowe nagłówki SIP dołączane do połączeń wychodzących. Kliknij „Dodaj nagłówek”, aby wpisać nazwę i wartość nagłówka wymaganą przez dostawcę; w razie potrzeby możesz dodać wiele nagłówków. Nagłówki niestandardowe mogą służyć do routingu i identyfikacji połączeń, rozliczeń i śledzenia oraz spełniania wymagań konkretnego dostawcy.

• Uwierzytelnianie (opcjonalnie): Podaj dane uwierzytelniania digest, jeśli wymaga tego dostawca trunku SIP.

  • Nazwa użytkownika trunku SIP: Nazwa użytkownika do uwierzytelniania SIP digest
  • Hasło trunku SIP: Hasło do uwierzytelniania SIP digest

  Jeśli pozostawisz puste, zostanie użyte uwierzytelnianie za pomocą listy kontroli dostępu (ACL), które wymaga dodania adresów IP ElevenLabs do listy dozwolonych w ustawieniach dostawcy.

Dobra praktyka bezpieczeństwa: Używaj transportu TLS z wymaganym szyfrowaniem mediów, aby zapewnić maksymalne bezpieczeństwo. Dzięki temu sygnalizacja i media są szyfrowane end-to-end.

Metody uwierzytelniania:

• Uwierzytelnianie digest: Używa nazwy użytkownika i hasła do bezpiecznego uwierzytelniania (zalecane)
• Uwierzytelnianie ACL: Używa listy dozwolonych adresów IP do kontroli dostępu

Zdecydowanie zalecamy uwierzytelnianie digest, ponieważ zapewnia lepsze bezpieczeństwo bez polegania na listach dozwolonych adresów IP, które mogą być trudne w zarządzaniu przy dynamicznych adresach IP.

Pole Adres określa, gdzie ElevenLabs będzie wysyłać połączenia wychodzące od twoich agentów AI. Wpisz tylko nazwę hosta lub adres IP bez prefiksu protokołu sip:.

6

Zakończ konfigurację

Kliknij „Importuj”, aby zakończyć konfigurację.

Dane klienta i personalizacja

Aby zapewnić prawidłowe przekazywanie i śledzenie metadanych połączeń, dodaj poniższe niestandardowe nagłówki SIP do payloadu webhooka i żądania SIP INVITE:

• X-CALL-ID: Unikalny identyfikator połączenia
• X-CALLER-ID: Identyfikator strony dzwoniącej

Te nagłówki pozwalają systemowi powiązać metadane połączenia z rozmową i zapewnić kontekst do personalizacji.

Obsługa nagłówka zastępczego

Jeśli powyższe standardowe nagłówki nie są obecne, system automatycznie wyszuka nagłówek SIP specyficzny dla Twilio:

• sip.twilio.callSid: Unikalny identyfikator połączenia Twilio

Ten mechanizm zastępczy zapewnia zgodność z Elastic SIP Trunking Twilio bez zmian w konfiguracji.

Przepływ przetwarzania

Gdy odpowiednie metadane zostaną odebrane przez dowolny z obsługiwanych nagłówków, caller_id i/lub call_id są dostępne w webhooku inicjacji rozmowy oraz jako systemowe zmienne dynamiczne.

Niestandardowe nagłówki przychodzące jako zmienne dynamiczne

Niestandardowe nagłówki SIP X- z przychodzących połączeń trunku SIP są automatycznie dostępne w rozmowie jako zmienne dynamiczne.

Nazwy nagłówków są normalizowane przez usunięcie prefiksu X-, zmianę nazwy na małe litery, zastąpienie myślników podkreśleniami i dodanie prefiksu sip_. Na przykład X-Contact-ID staje się {{sip_contact_id}}, a X-Campaign-ID staje się {{sip_campaign_id}}.

Używaj tych zmiennych w promptach agenta, pierwszych wiadomościach i narzędziach, aby personalizować rozmowę kontekstem przekazanym przez rozmówcę. Wartości są też widoczne w historii rozmowy na karcie Phone Call.

Nagłówki BYE ze zmiennych dynamicznych

Gdy połączenie się kończy, ElevenLabs wysyła SIP BYE, aby zakończyć dialog. Możesz dołączyć niestandardowe nagłówki do tego BYE, mapując zmienne dynamiczne na nazwy nagłówków w konfiguracji trunku SIP.

Ustaw attributes_to_headers w inbound_trunk_config lub outbound_trunk_config podczas tworzenia lub aktualizowania numeru telefonu trunku SIP przez API. Każdy wpis mapuje nazwę zmiennej dynamicznej na nazwę nagłówka SIP, który ma zostać uwzględniony w BYE:

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

Wartość nagłówka to końcowa wartość zmiennej dynamicznej na zakończenie rozmowy. Wartości ustawione podczas połączenia — za pomocą narzędzi agenta, nadpisań webhooków lub innych aktualizacji w czasie działania — są uwzględniane w BYE.

Na przykład, jeśli attributes_to_headers zawiera "disposition_code": "X-Disposition", a zmienna dynamiczna disposition_code ma wartość resolved po zakończeniu rozmowy, BYE zawiera X-Disposition: resolved.

Przypisywanie agentów do numerów telefonów

Po zaimportowaniu numeru telefonu trunku SIP możesz przypisać go do agenta ElevenLabs:

1. Przejdź do sekcji Numerów telefonów w panelu ElevenAgents
2. Wybierz zaimportowany numer telefonu trunku SIP
3. Kliknij „Przypisz agenta”
4. Wybierz agenta, który ma obsługiwać połączenia na ten numer

Rozwiązywanie problemów

Ograniczenia i kwestie do rozważenia

• Obsługa wielu równoczesnych połączeń zależy od twojego planu subskrypcji. Włącz kolejkowanie połączeń, aby utrzymywać osoby dzwoniące w kolejce po osiągnięciu limitu zamiast odrzucać ich połączenia
• Funkcje nagrywania i analityki połączeń są dostępne, ale mogą wymagać dodatkowej konfiguracji
• Możliwości wykonywania połączeń wychodzących mogą być ograniczone przez dostawcę trunku SIP
• Obsługa TLS: Upewnij się, że dostawca trunku SIP obsługuje TLS 1.2 lub nowszy dla szyfrowanego transportu
• Szyfrowanie mediów: Obsługa SRTP zależy od dostawcy; sprawdź zgodność przed wymaganiem szyfrowania
• Format audio: Wdrożenie SIP ElevenLabs wysyła i odbiera audio za pomocą kodeków PCMU lub PCMA (G.711, 8 kHz) albo G.722 (16 kHz). Nie zależy to od formatu audio skonfigurowanego w agencie dla bezpośrednich połączeń websocket. Twój system trunku SIP musi natywnie obsługiwać jeden z tych kodeków albo wykonywać resampling zgodnie z wymaganiami systemu

FAQ

Kolejne kroki

• Dokumentacja SIP: słownik pojęć SIP i sieciowych
• Dowiedz się, jak tworzyć agentów ElevenLabs