Připojení poskytovatele VoIP

Připojte poskytovatele, kterého již používáte (Twilio nebo Telnyx pomocí klíče API; SignalWire, Vonage, Plivo nebo libovolný SIP trunk přes SIP), nebo si otevřete nový účet Telnyx s provázeným nastavením.

Produkční provoz by měl běžet na číslech, která vlastníte, prostřednictvím vlastního poskytovatele VoIP. Stránka Připojení → VoIP v dashboardu (/dashboard/voip-connections) propojí váš účet u poskytovatele; po připojení importujete čísla, která podporují příchozí i odchozí volání.

Klikněte na Nové připojení a vyberte jednu ze dvou možností: Připojit poskytovatele, kterého již používáte, nebo Založit nový účet Telnyx.

Připojení poskytovatele, kterého již používáte#

Vyberte poskytovatele, u kterého máte svá čísla:

Pro Twilio a Telnyx vložte přihlašovací údaje a klikněte na Připojit a otestovat. ThunderPhone je ověří a nakonfiguruje stranu poskytovatele za vás. Pro Telnyx ThunderPhone přidá do vašeho účtu Telnyx jedno vlastní připojení SIP (s názvem thunderphone-production-<org>-outbound-<id>) a uskutečňuje přes něj odchozí hovory, takže vám Telnyx tyto hovory účtuje. Používá profil odchozího hlasového provozu připojení Telnyx, na kterém máte svá čísla, proto platí povolené země a limity útraty daného profilu. Pokud toto připojení nemá profil odchozího hlasového provozu a váš účet má právě jeden aktivovaný profil, ThunderPhone použije tento profil. Chcete-li použít jiný, přiřaďte jej k připojení na portálu Telnyx a připojení ThunderPhone znovu uložte. Pokud účet nemá žádný aktivovaný profil nebo jich má několik, přiřaďte jeden k připojení na portálu Telnyx a znovu uložte připojení ThunderPhone. Do té doby odchozí hovory selžou s chybou outbound_trunk_unavailable; příchozí hovory budou nadále fungovat.

Když Telnyx odmítne odchozí hovor (například SIP 403 Forbidden), odmítnutí pochází z vašeho vlastního účtu Telnyx. Obvyklými příčinami jsou nedostupný kredit, číslo volajícího, které není v daném účtu Telnyx, nebo profil odchozího hlasového provozu, který nepovoluje cílovou zemi.

Nastavení SIP pro SignalWire, Vonage a Plivo#

Všichni tři otevřou ruční formulář SIP s kroky pro daného poskytovatele nahoře, odkazem na vlastní průvodce nastavením poskytovatele a ukázkovou doménou SIP:

• SignalWire: vytvořte přihlašovací údaje SIP pro odchozí hovory, zadejte doménu SIP, uživatelské jméno a heslo a každému číslu přiřaďte skript SWML, který připojí příchozí hovory ke koncovému bodu SIP ThunderPhone.
• Vonage: v dashboardu SIP Trunking vytvořte trunk s přihlašovacími údaji pro odchozí hovory, zadejte jeho doménu (například your-trunk.sip-us.vonage.com) a přihlašovací údaje, přidejte koncový bod SIP ThunderPhone jako příchozí SIP URI trunku a propojte svá čísla s trunkem.
• Plivo: vytvořte odchozí trunk s přihlašovacími údaji a zadejte jeho Termination SIP Domain (<trunk-id>.zt.plivo.com), uživatelské jméno a heslo; vytvořte příchozí trunk, jehož Primary URI je koncový bod SIP ThunderPhone následovaný ;transport=tcp; poté nastavte Typ aplikace každého čísla na tento trunk.

Výsledkem je ruční připojení SIP (provider: "manual" v API), otestované a ověřené stejně jako připojení zadané ručně. Karta připojení zobrazuje název poskytovatele, například SignalWire · SIP.

Nastavení nového účtu Telnyx#

Ještě nemáte operátora? Provázený postup vás provede založením účtu Telnyx a jeho připojením:

1. Vytvořte účet

   Klikněte na Otevřít registraci Telnyx, vytvořte si účet a zaškrtněte „Vytvořil/a jsem si účet“.

2. Získejte klíč API

   Klikněte na Otevřít stránku klíčů API, vygenerujte klíč a vložte jej do Klíč API (v2). Připojení můžete volitelně pojmenovat.

3. Připojit a otestovat

   Klikněte na Připojit a otestovat — ThunderPhone ověří přihlašovací údaje a před uložením nastaví na straně Telnyx vše potřebné.

Co ThunderPhone nastaví v Telnyx#

Pokud nezadáte vlastní ID připojení, oba postupy Telnyx (provázené nastavení a vložení klíče API) ve vašem účtu Telnyx vytvoří totéž: jedno připojení SIP s názvem thunderphone-<your organization id>. Jde o připojení FQDN, jehož záznam FQDN odkazuje na koncový bod SIP ThunderPhone a všechna importovaná čísla jsou k němu přiřazena. Telnyx odesílá hovory na tato čísla přímo do ThunderPhone přes SIP.

• Jeho pole webhooku jsou záměrně prázdná. Nepoužívá se žádný webhook, aplikace Call Control, aplikace TeXML ani registrovaný telefon SIP.
• Nepřesouvejte importovaná čísla do jiného připojení nebo aplikace ani k němu neregistrujte zařízení.
• Pokud jste při připojování zadali vlastní ID připojení, ThunderPhone místo toho použije toto připojení a nikdy je nezmění; musí jít o připojení FQDN odkazující na koncový bod SIP ThunderPhone.

Před 30. srpnem 2026 bylo připojení thunderphone-…, které ThunderPhone vytvořil, připojením s přihlašovacími údaji, které nemůže přijímat hovory. Pokud se vaše připojení stále zobrazuje jako připojení s přihlašovacími údaji, kontaktujte podporu a převedeme je.

Ruční konfigurace SIP#

Dlaždice SignalWire, Vonage a Plivo otevírají tento formulář, stejně jako možnost Všechna nastavení zadám ručně v části Jiný poskytovatel. Funguje libovolný SIP trunk včetně DIDWW nebo pobočkové ústředny PBX, kterou provozujete sami. Zadejte název připojení, doménu / URI SIP, volitelné uživatelské jméno a heslo, port a transport; Pokročilá nastavení přidávají šifrování médií (SRTP). Formulář také zobrazuje adresu SIP, na kterou musí váš trunk odesílat příchozí hovory: sip.thunderphone.com, na portu 5060 pro UDP nebo TCP, případně 5061 pro TLS. Při použití TLS zůstává signalizace SIP šifrovaná až do LiveKit Cloud, kde ThunderPhone hovor zpracovává; zvuk nikdy neprochází přes sip.thunderphone.com, takže SRTP funguje jako dříve. Každý hovor adresujte na vytáčené číslo ve formátu E.164; stejné číslo včetně znaku + uveďte v řádku požadavku i v hlavičce To: například sip:+14155550142@sip.thunderphone.com. Znak + umožňuje ThunderPhone zpracovat hovor ve správném regionu (viz poznámka v části Seznam povolených IP adres). Trunky dříve nastavené s adresou <your-project>.sip.livekit.cloud nadále fungují, pokud je pole Povolené zdrojové IP adresy prázdné; nemusíte je měnit. ThunderPhone tato nastavení převede na vyhrazenou dvojici SIP trunků v LiveKit Cloud: odchozí hovory z čísel připojení jsou směrovány do vaší domény SIP s vašimi přihlašovacími údaji a příchozí hovory na tato čísla jsou přijímány z libovolné adresy, pokud nevyplníte volitelné pole Povolené zdrojové IP adresy. Vyplňte je pouze v případě, že váš operátor zveřejňuje pevné IP adresy signalizace: nesprávný nebo neúplný seznam způsobí, že ThunderPhone odmítne příchozí hovory od vašeho operátora. Dvě tlačítka zajišťují hlavní práci:

• Vygenerovat průvodce nastavením AI — vytvoří pokyny specifické pro poskytovatele pro požadovanou konfiguraci na straně trunku.
• Otestovat a uložit připojení — ověří, že koncový bod SIP se překládá na veřejnou adresu a že u TCP/TLS přijímá připojení na zvoleném portu (hostitelé UDP získají pouze kontrolu DNS), a poté připojení uloží. Zatím nemůže uskutečnit hovor, protože připojení nemá žádná čísla; skutečné ověření proběhne při importu (níže).

Pozdější úprava připojení před uložením čehokoli znovu spustí stejnou kontrolu pro změněná nastavení, poté trunk znovu vytvoří a na pozadí znovu ověří každé číslo v připojení krátkým testovacím hovorem — čísla se zobrazují jako Zřizování, dokud jejich testovací hovor neuspěje. Změna pouze Povolených zdrojových IP adres u připojení ve stavu Připojeno je jiná: nikdy neovlivní odchozí hovory, takže ThunderPhone seznam na příchozím trunku ihned aktualizuje a čísla zůstanou Aktivní. Test příchozího hovoru se obnoví na stav netestováno; spusťte jej znovu nebo uskutečněte skutečný hovor přes svého operátora, abyste potvrdili, že nový seznam propouští hovory. Test selže, pokud by jeho hovor byl podle seznamu odmítnut. Uložená hesla se nikdy znovu nezobrazují; chcete-li je zachovat, nechte pole pro heslo prázdné, nebo u trunku ověřovaného pomocí IP zaškrtněte možnost „Odstranit uložené heslo“.

Povolené IP adresy a ověřování trunku#

Někteří operátoři (DIDWW, připojení Telnyx s ověřováním IP, většina ústředen PBX za firewallem) přijímají provoz SIP pouze z adres, které jste zařadili na seznam povolených, nebo ověřují odchozí hovory podle zdrojové IP adresy. ThunderPhone používá dvě sady adres.

Okrajový server SIP. Příchozí hovory, které posíláte na sip.thunderphone.com, procházejí okrajovým serverem SIP ThunderPhone, který přenáší pouze signalizaci SIP. První INVITE směřuje na sip.thunderphone.com; zbytek signalizace hovoru (ACK, ukončení hovoru, přepojení) probíhá mezi vaším operátorem a okrajovým serverem, který hovor přijal, sip-1 nebo sip-2. Pokud váš firewall filtruje signalizaci SIP, povolte všechny tři adresy na portech UDP a TCP 5060 a portu TLS 5061:

LiveKit Cloud. Zvuk (RTP) každého hovoru a signalizace SIP odchozích hovorů probíhají mezi vaším operátorem a LiveKit Cloud, nikdy přes okrajový server SIP. Povolte všechny níže uvedené rozsahy pro signalizaci SIP i média:

LiveKit používá tyto rozsahy pro Realtime, signalizaci SIP a média i webhooky a pokrývají hovory zpracované v jeho regionech Kanada, EU, Indie, Japonsko a USA. Názvy regionů pro připnutý koncový bod: canada, eu, india, japan, us.

Pro samotný trunk platí několik praktických pravidel:

• ThunderPhone se neregistruje. Nikdy vašemu operátorovi neodesílá SIP REGISTER, proto trunk nakonfigurujte pro ověřování na základě IP adresy a/nebo přihlašovacích údajů (uživatelské jméno + heslo), nikoli pro registraci.
• Odchozí hovory by měly používat přihlašovací údaje. Na straně operátora povolte ověřování uživatelským jménem a heslem a stejné hodnoty zadejte do ručního formuláře SIP. Seznam povolených IP adres považujte za druhou vrstvu, nikoli za jedinou — odchozí hovory do cílů mimo pokryté regiony mohou pocházet z jiných adres.
• Příchozí hovory fungují opačným směrem. Do volitelného pole Povolené zdrojové IP adresy ve formuláři zadáváte signalizační adresy svého operátora, aby ThunderPhone přijímal hovory pouze z nich. Zadejte IP adresy nebo rozsahy CIDR; názvy hostitelů se nikdy neshodují. Nechte pole prázdné, pokud váš operátor nezveřejňuje pevný seznam. ThunderPhone kontroluje tento seznam u každého příchozího hovoru podle adresy, kterou vidí jeho okrajový server SIP, takže po nastavení seznamu posílejte hovory na sip.thunderphone.com. Hovor z adresy, která není na seznamu, nebo hovor odeslaný přímo na adresu <your-project>.sip.livekit.cloud, je odmítnut: selže nebo se připojí a ihned skončí.

Rozsahy zveřejňuje LiveKit na stránce Regiony, regionální koncové body a statické IP adresy; ThunderPhone tuto stránku kontroluje každý týden a při změně tohoto průvodce aktualizuje.

Po připojení#

Importujte čísla přes Telefonní čísla → Přidat číslo → Připojit poskytovatele VoIP (nebo přímo z připojení). Každé importované číslo je před aktivací ověřeno. U ručního připojení SIP toto ověření provede krátký (několik sekund) testovací hovor z vašeho čísla přes váš SIP trunk na číslo ThunderPhone — tím se v praxi ověří uživatelské jméno, heslo, transport i odchozí směrování vašeho operátora. Váš operátor tento hovor účtuje jako každý jiný. Pokud jej operátor odmítne, číslo zůstane ve stavu Zřizování a na stránce telefonních čísel se zobrazí odpověď operátora (například „přihlašovací údaje ThunderPhone byly odmítnuty (SIP 401)“); opravte připojení a ověření zopakujte. Pokud váš operátor trunk přijme, ale jeho směrovací plán nepokrývá testovací číslo ThunderPhone (DIDWW odpoví „Cílové číslo je na černé listině směrovacího plánu“), číslo se zobrazí jako Ověřeno · operátor přijal: lze je používat, ale hovory do jiných cílů nebyly otestovány. Tento hovor prokazuje, že váš trunk dokáže hovory uskutečňovat jako dané číslo; neprokazuje, že číslo vlastníte, ani netestuje hovory na toto číslo; to provádí volitelný test příchozích hovorů níže. Ověřená čísla podporují příchozí i odchozí hovory — tím se zpřístupní odchozí kampaně a programové odchozí hovory.

Test příchozího hovoru#

Ověřit číslo otevře dialog, který může také otestovat příchozí hovory. Test zavolá na vaše číslo, ověří, že hovor dorazí do ThunderPhone, a poté jej ukončí bez spuštění vašeho agenta:

• Čísla s vlastním odchozím SIP trunkem (ručně přidaná čísla SIP a čísla Twilio poté, co ThunderPhone nastaví odchozí volání ve vašem účtu Twilio) nejprve volají sama sobě: ThunderPhone vytočí číslo z tohoto čísla prostřednictvím daného trunku. Dialog vás o tom informuje před uskutečněním hovoru. Hovor odejde přes vašeho operátora a pokud je vaše směrování příchozích hovorů správné, vrátí se přímo do ThunderPhone. Když se vrátí s vlastním ID volajícího daného čísla, tento jeden hovor prokáže jak to, že váš operátor přijímá hovory ThunderPhone jako dané číslo, tak to, že hovory na toto číslo dorazí do ThunderPhone, v libovolné zemi. Někteří operátoři hovor z čísla na sebe sama odmítnou nebo jej nespojí; to nic nevypovídá o vašem směrování, proto ThunderPhone poté zavolá z jednoho ze svých vlastních čísel. Pokud se vaše číslo přesměrovává jinam, tento telefon může zazvonit dvakrát: nejprve se zobrazí vlastní ID volajícího daného čísla, poté testovací číslo ThunderPhone.
• Ostatní čísla (a výše uvedená záložní možnost) jsou volána z jednoho z vlastních čísel ThunderPhone. ThunderPhone může tyto hovory zatím uskutečňovat pouze na čísla v USA a Kanadě; u ostatních čísel test oznámí, že jej nebylo možné spustit, včetně odpovědi vašeho operátora, pokud byl hovor na stejné číslo odmítnut.

Pokud váš operátor po cestě změní ID volajícího, ThunderPhone hovor nemůže rozpoznat, takže jej může váš agent na okamžik přijmout. Test příchozího hovoru je volitelný. Můžete jej přeskočit a číslo bude stále fungovat; stránka telefonních čísel pak zobrazí Příchozí hovory netestovány a můžete jej spustit později pomocí Test nebo položky nabídky čísla Testovat příchozí hovory. Ihned po importu vás stránka telefonních čísel také vyzve k otestování příchozích hovorů na nových číslech. Dokud to v dialogu nepotvrdíte, žádný hovor se neuskuteční.

Pokud váš poskytovatel přesměruje číslo jinam, zařízení, na které číslo odkazuje, může před ukončením hovoru ThunderPhone zvonit až 8 sekund při každém hovoru. Pokud něco hovor přijme dříve (aplikace Twilio, která hovor přijme a poté přesměruje, telefonní nabídka), test čeká, až přesměrovaný hovor dorazí do ThunderPhone: až 8 sekund při hovoru na stejné číslo a 15 sekund při hovoru z čísla ThunderPhone. Výsledek zůstane u čísla (Příchozí hovory úspěšné nebo neúspěšné), dokud nezměníte připojení nebo číslo znovu neimportujete; tím se stav obnoví na netestováno. Změna připojení na pozadí znovu ověří odchozí hovory, ale nikdy nezavolá na vaše číslo bez vašeho vyžádání.

Řešení problémů s příchozími hovory#

Tlačítko Test připojení ověřuje přihlašovací údaje a ověření kontroluje odchozí volání. Příchozí volání ověříte spuštěním testu příchozího hovoru výše nebo zavoláním na číslo z telefonu a vyhledáním hovoru v Historii hovorů. Testy Hovor v prohlížeči a simulace mezi boty neprocházejí přes vašeho operátora, takže neukazují, zda příchozí volání funguje. Simulace zacílena na telefonní číslo (smyčka SIP) přes vašeho operátora skutečně volá na toto číslo, takže přijatý hovor ověří směrování příchozích hovorů.

• Slyšíte zprávu vlastního mobilního operátora (například „Vítejte u Verizonu“ nebo „volané číslo není v provozu“): hovor selhal ještě před dosažením ThunderPhone. Ověřte, že je číslo aktivní ve vašem účtu u poskytovatele a přiřazené k připojení nebo trunku ThunderPhone.
• Obsazovací tón nebo hovor vyzvání bez odpovědi: poskytovatel hovor přijal, ale nemohl jej doručit. U Telnyx zkontrolujte u čísla Připojení na portálu Telnyx: mělo by jít o výše popsané připojení FQDN thunderphone-… nebo o vaše vlastní připojení FQDN směřující ke koncovému bodu SIP ThunderPhone. U Twilio by mělo být číslo připojeno k trunku SIP ThunderPhone, nikoli k webhooku Voice nebo aplikaci TwiML.
• Protokoly vašeho operátora zobrazují 404 No trunk found (ruční SIP): hovor dorazil do ThunderPhone, ale neodpovídal žádnému trunku. Ověřte, že je číslo importováno v tomto připojení a že trunk směřuje na sip.thunderphone.com. Pokud směřuje na adresu <your-project>.sip.livekit.cloud, pole Povolené zdrojové IP adresy musí být prázdné: pokud je nastaven seznam, přijímají se pouze hovory odeslané na sip.thunderphone.com.
• 404 Not Found z sip.thunderphone.com (ruční SIP): hovor nebyl adresován na telefonní číslo nebo řádek požadavku a záhlaví To uvádějí různá čísla. Odešlete volané číslo v obou, jak je uvedeno výše.
• 403 Forbidden z sip.thunderphone.com: řádek požadavku uvádí jiného hostitele. Adresujte hovor na sip.thunderphone.com, například sip:+14155550142@sip.thunderphone.com.
• Hovor dorazí do ThunderPhone, ale odpoví nesprávný agent nebo nikdo: zkontrolujte příchozího agenta čísla v části Telefonní čísla.

Integrovaný copilot může číslo zkontrolovat za vás: zeptejte se ho, proč hovory na toto číslo selhávají. U připojení Telnyx také může v režimu pouze pro čtení a pro administrátory organizace zjistit, ke kterému připojení Telnyx číslo přiřazuje.

Další kroky#