Połącz dostawcę VoIP

Połącz dostawcę, z którego już korzystasz (Twilio lub Telnyx za pomocą klucza API; SignalWire, Vonage, Plivo lub dowolny trunk SIP przez SIP), albo otwórz nowe konto Telnyx z konfiguracją krok po kroku.

Ruch produkcyjny powinien działać na numerach, które posiadasz, za pośrednictwem własnego dostawcy VoIP. Strona Połączenia → VoIP w panelu (/dashboard/voip-connections) łączy konto dostawcy; po połączeniu importujesz numery obsługujące połączenia przychodzące i wychodzące.

Kliknij Nowe połączenie i wybierz jedną z dwóch opcji: Połącz dostawcę, z którego już korzystasz lub Skonfiguruj nowe konto Telnyx.

Połącz dostawcę, z którego już korzystasz#

Wybierz dostawcę, u którego masz swoje numery:

W przypadku Twilio i Telnyx wklej dane uwierzytelniające i kliknij Połącz i przetestuj. ThunderPhone je weryfikuje i konfiguruje stronę dostawcy za Ciebie. W przypadku Telnyx ThunderPhone dodaje jedno własne połączenie SIP do Twojego konta Telnyx (o nazwie thunderphone-production-<org>-outbound-<id>) i realizuje przez nie połączenia wychodzące, dlatego Telnyx rozlicza te połączenia na Twoim koncie. Używa profilu połączeń głosowych wychodzących połączenia Telnyx, do którego przypisane są Twoje numery, dlatego obowiązują dozwolone kraje i limity wydatków tego profilu. Jeśli to połączenie nie ma profilu połączeń głosowych wychodzących, a Twoje konto ma dokładnie jeden włączony profil, ThunderPhone użyje tego profilu. Aby użyć innego, przypisz go do połączenia w portalu Telnyx i ponownie zapisz połączenie ThunderPhone. Jeśli konto nie ma włączonego profilu lub ma ich kilka, przypisz jeden do połączenia w portalu Telnyx i ponownie zapisz połączenie ThunderPhone. Do tego czasu połączenia wychodzące kończą się błędem outbound_trunk_unavailable; połączenia przychodzące nadal działają.

Gdy Telnyx odrzuca połączenie wychodzące (na przykład SIP 403 Forbidden), odrzucenie pochodzi z Twojego własnego konta Telnyx. Zwykle przyczyną jest brak dostępnych środków, numer rozmówcy, który nie znajduje się na tym koncie Telnyx, lub profil połączeń głosowych wychodzących, który nie zezwala na połączenia do kraju docelowego.

Konfiguracja SIP dla SignalWire, Vonage i Plivo#

Te trzy opcje otwierają ręczny formularz SIP z instrukcjami dla danego dostawcy u góry, linkiem do własnego przewodnika konfiguracji dostawcy oraz przykładową domeną SIP:

• SignalWire: utwórz dane uwierzytelniające SIP dla połączeń wychodzących, wprowadź domenę SIP, nazwę użytkownika i hasło, a następnie przypisz do każdego numeru skrypt SWML, który łączy połączenia przychodzące z punktem końcowym SIP ThunderPhone.
• Vonage: w panelu SIP Trunking utwórz trunk z danymi uwierzytelniającymi dla połączeń wychodzących, wprowadź jego domenę (na przykład your-trunk.sip-us.vonage.com) i dane uwierzytelniające, dodaj punkt końcowy SIP ThunderPhone jako przychodzący identyfikator URI SIP trunku i połącz swoje numery z trunkem.
• Plivo: utwórz trunk wychodzący z danymi uwierzytelniającymi i wprowadź jego Termination SIP Domain (<trunk-id>.zt.plivo.com), nazwę użytkownika oraz hasło; utwórz trunk przychodzący, którego Primary URI jest punktem końcowym SIP ThunderPhone, po którym następuje ;transport=tcp; następnie ustaw dla każdego numeru Application Type na ten trunk.

Wynikiem jest ręczne połączenie SIP (provider: "manual" w API), testowane i weryfikowane dokładnie tak samo jak połączenie wprowadzone ręcznie. Karta połączenia wyświetla nazwę dostawcy, na przykład SignalWire · SIP.

Skonfiguruj nowe konto Telnyx#

Nie masz jeszcze dostawcy? Przewodnik przeprowadzi Cię przez utworzenie konta Telnyx i jego połączenie:

1. Utwórz konto

   Kliknij Otwórz rejestrację Telnyx, utwórz konto i zaznacz „Utworzyłem(-am) konto”.

2. Uzyskaj klucz API

   Kliknij Otwórz stronę kluczy API, wygeneruj klucz i wklej go w polu Klucz API (v2). Opcjonalnie nadaj nazwę połączeniu.

3. Połącz i przetestuj

   Kliknij Połącz i przetestuj — ThunderPhone zweryfikuje dane uwierzytelniające i skonfiguruje po stronie Telnyx to, czego potrzebuje, przed zapisaniem.

Co ThunderPhone konfiguruje w Telnyx#

Jeśli nie podasz własnego identyfikatora Connection ID, obie ścieżki Telnyx (przewodnik konfiguracji i wklejenie klucza API) pozostawiają na Twoim koncie Telnyx to samo: jedno połączenie SIP o nazwie thunderphone-<your organization id>. Jest to połączenie FQDN, którego rekord FQDN wskazuje na punkt końcowy SIP ThunderPhone, a każdy zaimportowany numer jest do niego przypisany. Telnyx wysyła połączenia na te numery bezpośrednio do ThunderPhone przez SIP.

• Pola webhooków są celowo puste. Nie są używane żadne webhooki, aplikacje Call Control, aplikacje TeXML ani zarejestrowane telefony SIP.
• Nie przenoś zaimportowanych numerów do innego połączenia ani aplikacji i nie rejestruj względem niego urządzenia.
• Jeśli podczas łączenia podasz własny identyfikator Connection ID, ThunderPhone użyje tego połączenia i nigdy go nie zmieni; musi to być połączenie FQDN wskazujące na punkt końcowy SIP ThunderPhone.

Przed 30 sierpnia 2026 roku połączenie thunderphone-… utworzone przez ThunderPhone było połączeniem Credential, które nie może odbierać połączeń. Jeśli nadal jest wyświetlane jako połączenie Credential, skontaktuj się z pomocą techniczną, a przekonwertujemy je.

Ręczna konfiguracja SIP#

Kafelki SignalWire, Vonage i Plivo otwierają ten formularz, podobnie jak Wprowadzę wszystkie ustawienia samodzielnie w sekcji Inny dostawca. Działa dowolny trunk SIP, w tym DIDWW lub PBX, który obsługujesz samodzielnie. Wprowadź nazwę połączenia, domenę / URI SIP, opcjonalną nazwę użytkownika i hasło, port oraz transport; Ustawienia zaawansowane dodają szyfrowanie mediów (SRTP). Formularz pokazuje również adres SIP, na który trunk musi wysyłać połączenia przychodzące: sip.thunderphone.com, na porcie 5060 dla UDP lub TCP albo 5061 dla TLS. W przypadku TLS sygnalizacja SIP pozostaje szyfrowana aż do LiveKit Cloud, gdzie ThunderPhone obsługuje połączenie; dźwięk nigdy nie przechodzi przez sip.thunderphone.com, więc SRTP działa jak wcześniej. Każde połączenie kieruj na wybrany numer w formacie E.164, używając tego samego numeru, łącznie ze znakiem +, zarówno w wierszu żądania, jak i w nagłówku To: na przykład sip:+14155550142@sip.thunderphone.com. Znak + pozwala ThunderPhone obsłużyć połączenie w odpowiednim regionie (zobacz uwagę w sekcji lista dozwolonych adresów IP). Trunki skonfigurowane wcześniej z adresem <your-project>.sip.livekit.cloud nadal działają, gdy pole Dozwolone źródłowe adresy IP jest puste; nie musisz ich zmieniać. ThunderPhone przekształca te ustawienia w dedykowaną parę trunków SIP w LiveKit Cloud: połączenia wychodzące z numerów połączenia są kierowane do Twojej domeny SIP z użyciem Twoich poświadczeń, a połączenia przychodzące na te numery są akceptowane z dowolnego adresu, chyba że wypełnisz opcjonalne pole Dozwolone źródłowe adresy IP. Wypełniaj je tylko wtedy, gdy Twój operator publikuje stałe adresy IP sygnalizacji: błędna lub niepełna lista spowoduje, że ThunderPhone odrzuci połączenia przychodzące od Twojego operatora. Dwa przyciski wykonują najważniejszą pracę:

• Wygeneruj przewodnik konfiguracji AI — tworzy instrukcje specyficzne dla dostawcy dotyczące potrzebnej konfiguracji po stronie trunku.
• Przetestuj i zapisz połączenie — sprawdza, czy endpoint SIP wskazuje publiczny adres i, w przypadku TCP/TLS, akceptuje połączenie na wybranym porcie (hosty UDP otrzymują tylko sprawdzenie DNS), a następnie zapisuje połączenie. Nie może jeszcze wykonać połączenia, ponieważ połączenie nie ma numerów; rzeczywiste potwierdzenie następuje podczas importowania (poniżej).

Późniejsza edycja połączenia ponownie uruchamia to samo sprawdzenie zmienionych ustawień, zanim cokolwiek zostanie zapisane, a następnie przebudowuje trunk i ponownie weryfikuje każdy numer w połączeniu za pomocą krótkiego połączenia testowego w tle — numery są oznaczone jako Konfigurowanie, dopóki ich połączenie testowe nie zakończy się powodzeniem. Zmiana tylko pola Dozwolone źródłowe adresy IP w połączeniu ze statusem Połączono działa inaczej: nigdy nie wpływa na połączenia wychodzące, dlatego ThunderPhone od razu aktualizuje listę na trunku przychodzącym, a numery zachowują status Aktywny. Test ich połączeń przychodzących jest resetowany do stanu nieprzetestowane; uruchom go ponownie lub wykonaj rzeczywiste połączenie przez swojego operatora, aby potwierdzić, że nowa lista przepuszcza połączenia. Test kończy się niepowodzeniem, gdy jego połączenie zostałoby odrzucone na podstawie listy. Zapisane hasła nigdy nie są ponownie wyświetlane; pozostaw pole hasła puste, aby je zachować, lub zaznacz „Usuń zapisane hasło” w przypadku trunku uwierzytelnianego adresem IP.

Lista dozwolonych adresów IP i uwierzytelnianie trunku#

Niektórzy operatorzy (DIDWW, połączenia Telnyx z uwierzytelnianiem IP, większość central PBX za zaporą) akceptują ruch SIP tylko z adresów dodanych do listy dozwolonych lub uwierzytelniają połączenia wychodzące według źródłowego adresu IP. ThunderPhone używa dwóch zestawów adresów.

Brzeg SIP. Połączenia przychodzące wysyłane do sip.thunderphone.com przechodzą przez brzeg SIP ThunderPhone, który obsługuje wyłącznie sygnalizację SIP. Pierwszy INVITE trafia do sip.thunderphone.com; pozostała część sygnalizacji połączenia (ACK, rozłączenie, przekierowania) odbywa się między Twoim operatorem a serwerem brzegowym, który odebrał połączenie, sip-1 lub sip-2. Jeśli Twoja zapora filtruje sygnalizację SIP, zezwól na wszystkie trzy adresy przez port 5060 UDP i TCP oraz port 5061 TLS:

LiveKit Cloud. Dźwięk (RTP) każdego połączenia oraz sygnalizacja SIP połączeń wychodzących odbywają się między Twoim operatorem a LiveKit Cloud, nigdy przez brzeg SIP. Zezwól na każdy z poniższych zakresów, zarówno dla sygnalizacji SIP, jak i multimediów:

LiveKit stosuje te zakresy do Realtime, sygnalizacji i mediów SIP oraz webhooków, a obejmują one połączenia obsługiwane w regionach Kanada, UE, Indie, Japonia i USA. Nazwy regionów dla przypiętego endpointu: canada, eu, india, japan, us.

Kilka praktycznych zasad dotyczących samego trunku:

• ThunderPhone nie rejestruje się. Nigdy nie wysyła do Twojego operatora żądania SIP REGISTER, dlatego skonfiguruj trunk do uwierzytelniania na podstawie IP i/lub poświadczeń (nazwa użytkownika + hasło), a nie rejestracji.
• Połączenia wychodzące powinny używać poświadczeń. Włącz uwierzytelnianie nazwą użytkownika/hasłem po stronie operatora i wprowadź te same wartości w ręcznym formularzu SIP. Traktuj listę dozwolonych adresów IP jako drugą warstwę, a nie jedyną — połączenia wychodzące do miejsc docelowych poza obsługiwanymi regionami mogą pochodzić z innych adresów.
• Połączenia przychodzące mają odwrotny kierunek. Opcjonalne pole Dozwolone źródłowe adresy IP w formularzu służy do wprowadzania adresów sygnalizacyjnych Twojego operatora, aby ThunderPhone akceptował połączenia tylko z nich. Wprowadź adresy IP lub zakresy CIDR; nazwy hostów nigdy nie są dopasowywane. Pozostaw pole puste, chyba że Twój operator publikuje stałą listę. ThunderPhone sprawdza tę listę przy każdym połączeniu przychodzącym względem adresu widocznego dla jego brzegu SIP, dlatego po ustawieniu listy wysyłaj połączenia do sip.thunderphone.com. Połączenie z adresu spoza listy lub wysłane bezpośrednio na adres <your-project>.sip.livekit.cloud zostaje odrzucone: nie dochodzi do skutku albo zostaje zestawione i natychmiast się kończy.

Zakresy są publikowane przez LiveKit na stronie Regiony, regionalne endpointy i statyczne adresy IP; ThunderPhone sprawdza tę stronę co tydzień i aktualizuje ten przewodnik, gdy ulega ona zmianie.

Po połączeniu#

Importuj numery z Numery telefonów → Dodaj numer → Połącz dostawcę VoIP (lub bezpośrednio z połączenia). Każdy zaimportowany numer jest weryfikowany przed aktywacją. W przypadku ręcznego połączenia SIP weryfikacja wykonuje krótkie, kilkusekundowe połączenie testowe z Twojego numeru, przez trunk SIP, na numer ThunderPhone — dzięki temu nazwa użytkownika, hasło, transport i routing wychodzący operatora są faktycznie sprawdzane. Operator nalicza opłatę za to połączenie jak za każde inne. Jeśli operator je odrzuci, numer pozostanie w stanie Konfigurowanie, a strona numerów telefonów wyświetli odpowiedź operatora (na przykład „odrzucono poświadczenia ThunderPhone (SIP 401)”); popraw połączenie i zweryfikuj je ponownie. Jeśli operator zaakceptuje trunk, ale jego plan routingu nie obejmuje numeru testowego ThunderPhone (DIDWW odpowiada „Numer docelowy zablokowany przez plan routingu”), numer będzie miał status Zweryfikowano · operator zaakceptował: można go używać, ale połączenia z innymi numerami docelowymi nie zostały przetestowane. To połączenie potwierdza, że Twój trunk może wykonywać połączenia z użyciem tego numeru; nie potwierdza, że jesteś właścicielem numeru, ani nie testuje połączeń na ten numer; robi to opcjonalny test połączeń przychodzących poniżej. Zweryfikowane numery obsługują połączenia przychodzące i wychodzące — co odblokowuje kampanie wychodzące oraz programowe połączenia wychodzące.

Test połączeń przychodzących#

Zweryfikuj numer otwiera okno dialogowe, które może również testować połączenia przychodzące. Test wykonuje połączenie na Twój numer, sprawdza, czy połączenie dociera do ThunderPhone, a następnie je rozłącza bez uruchamiania agenta:

• Numery z własnym wychodzącym trunkiem SIP (ręczne numery SIP oraz numery Twilio, gdy ThunderPhone skonfiguruje połączenia wychodzące na Twoim koncie Twilio) najpierw dzwonią do siebie: ThunderPhone wybiera numer z tego numeru przez ten trunk. Okno dialogowe informuje o tym przed wykonaniem połączenia. Połączenie wychodzi przez Twojego operatora i, jeśli trasowanie połączeń przychodzących jest prawidłowe, wraca bezpośrednio do ThunderPhone. Gdy wraca z własnym identyfikatorem rozmówcy numeru, to jedno połączenie potwierdza zarówno, że operator akceptuje połączenia ThunderPhone prezentowane jako ten numer, jak i że połączenia na ten numer docierają do ThunderPhone, w dowolnym kraju. Niektórzy operatorzy odrzucają lub nie łączą połączenia z numeru na ten sam numer; nie mówi to nic o Twoim trasowaniu, dlatego ThunderPhone wykonuje wtedy połączenie z jednego ze swoich numerów. Jeśli Twój numer przekierowuje gdzieś indziej, ten telefon może zadzwonić dwa razy: najpierw wyświetlając własny identyfikator rozmówcy numeru, a następnie numer testowy ThunderPhone.
• Inne numery (oraz opisany wyżej wariant zapasowy) otrzymują połączenie z jednego z własnych numerów ThunderPhone. Na razie ThunderPhone może wykonywać te połączenia tylko na numery w USA i Kanadzie; w przypadku innych numerów test zgłasza, że nie mógł zostać wykonany, wraz z odpowiedzią Twojego operatora, jeśli połączenie na ten sam numer zostało odrzucone.

Jeśli Twój operator zmieni identyfikator rozmówcy po drodze, ThunderPhone nie może rozpoznać połączenia, więc Twój agent może odebrać je na chwilę. Test połączeń przychodzących jest opcjonalny. Pomiń go, a numer nadal będzie działać; strona numerów telefonów wyświetli wtedy Połączenia przychodzące nieprzetestowane, a test możesz uruchomić później za pomocą Test lub pozycji menu numeru Testuj połączenia przychodzące. Bezpośrednio po imporcie strona numerów telefonów prosi również o przetestowanie połączeń przychodzących na nowych numerach. Żadne połączenie nie jest wykonywane, dopóki nie potwierdzisz tego w oknie dialogowym.

Jeśli Twój dostawca kieruje numer gdzie indziej, niezależnie od tego, na co wskazuje, może dzwonić przez maksymalnie 8 sekund na połączenie, zanim ThunderPhone je rozłączy. Jeśli coś odbierze wcześniej (aplikacja Twilio, która odbiera, a następnie przekierowuje, menu telefoniczne), test czeka, aż przekierowane połączenie dotrze do ThunderPhone: maksymalnie 8 sekund przy połączeniu na ten sam numer i 15 sekund przy połączeniu z numeru ThunderPhone. Wynik pozostaje przy numerze (Przychodzące zaliczone lub niezaliczone), dopóki nie zmienisz połączenia lub ponownie nie zaimportujesz numeru, co resetuje go do stanu nieprzetestowane. Zmiana połączenia ponownie weryfikuje połączenia wychodzące w tle, ale nigdy nie dzwoni na Twój numer bez Twojej zgody.

Rozwiązywanie problemów z połączeniami przychodzącymi#

Przycisk Test połączenia sprawdza poświadczenia, a weryfikacja sprawdza wybieranie połączeń wychodzących. Aby sprawdzić połączenia przychodzące, uruchom test połączenia przychodzącego powyżej albo zadzwoń na numer z telefonu i znajdź połączenie w Historii połączeń. Testy Rozmowa w przeglądarce i symulacje bot–bot nie przechodzą przez Twojego operatora, więc nie pokazują, czy połączenia przychodzące działają. Symulacja kierowana na numer telefonu (pętla zwrotna SIP) wybiera go przez Twojego operatora, więc odebrane połączenie sprawdza trasowanie połączeń przychodzących.

• Słyszysz komunikat własnego operatora komórkowego (na przykład „Witamy w Verizon” lub „wybrany numer nie jest dostępny”): połączenie nie powiodło się, zanim dotarło do ThunderPhone. Sprawdź, czy numer jest aktywny na koncie dostawcy i przypisany do połączenia lub trunku ThunderPhone.
• Sygnał zajętości lub połączenie dzwoni bez odpowiedzi: dostawca przyjął połączenie, ale nie mógł go dostarczyć. W przypadku Telnyx sprawdź ustawienie numeru Połączenie w portalu Telnyx: powinno to być opisane powyżej połączenie FQDN thunderphone-… albo własne połączenie FQDN wskazujące na punkt końcowy SIP ThunderPhone. W przypadku Twilio numer powinien być dołączony do trunku SIP ThunderPhone, a nie do webhooka Voice ani aplikacji TwiML.
• Dzienniki Twojego operatora pokazują 404 No trunk found (ręczny SIP): połączenie dotarło do ThunderPhone, ale nie dopasowano żadnego trunku. Sprawdź, czy numer jest zaimportowany w tym połączeniu i czy trunk wskazuje na sip.thunderphone.com. Jeśli wskazuje na adres <your-project>.sip.livekit.cloud, pole Dozwolone źródłowe adresy IP musi być puste: gdy lista jest ustawiona, akceptowane są tylko połączenia wysłane do sip.thunderphone.com.
• 404 Not Found z sip.thunderphone.com (ręczny SIP): połączenie nie zostało skierowane na numer telefonu albo wiersz żądania i nagłówek To wskazują różne numery. Wyślij wybrany numer w obu miejscach, jak powyżej.
• 403 Forbidden z sip.thunderphone.com: wiersz żądania wskazuje inny host. Skieruj połączenie do sip.thunderphone.com, na przykład sip:+14155550142@sip.thunderphone.com.
• Połączenie dociera do ThunderPhone, ale odbiera niewłaściwy agent albo nikt: sprawdź agenta obsługującego połączenia przychodzące dla numeru w Numerach telefonów.

Copilot w aplikacji może sprawdzić numer: zapytaj go, dlaczego połączenia na ten numer się nie udają. W przypadku połączeń Telnyx może też sprawdzić, tylko do odczytu i dla administratorów organizacji, do którego połączenia Telnyx przypisuje numer.

Kolejne kroki#