Pripojte poskytovateľa VoIP

Pripojte poskytovateľa, ktorého už používate (Twilio alebo Telnyx pomocou kľúča API; SignalWire, Vonage, Plivo alebo ľubovoľný SIP trunk prostredníctvom SIP), alebo si otvorte nový účet Telnyx so sprievodcom nastavením.

Produkčnú prevádzku spúšťajte na číslach, ktoré vlastníte, prostredníctvom vlastného poskytovateľa VoIP. Stránka Pripojenia → VoIP (/dashboard/voip-connections) na paneli pripojí váš účet poskytovateľa; po pripojení importujete čísla, ktoré podporujú prichádzajúce aj odchádzajúce hovory.

Kliknite na Nové pripojenie a vyberte jednu z dvoch možností: Pripojiť poskytovateľa, ktorého už používate, alebo Nastaviť nový účet Telnyx.

Pripojte poskytovateľa, ktorého už používate#

Vyberte poskytovateľa, u ktorého máte svoje čísla:

Pre Twilio a Telnyx vložte prihlasovacie údaje a kliknite na Pripojiť a otestovať. ThunderPhone ich overí a nakonfiguruje stranu poskytovateľa za vás. Pre Telnyx ThunderPhone pridá do vášho účtu Telnyx jedno vlastné pripojenie SIP (s názvom thunderphone-production-<org>-outbound-<id>) a uskutočňuje cezň odchádzajúce hovory, takže Telnyx vám tieto hovory účtuje. Používa profil odchádzajúcich hlasových hovorov pripojenia Telnyx, na ktorom sú vaše čísla, preto sa uplatňujú povolené krajiny a limity výdavkov daného profilu. Ak toto pripojenie nemá profil odchádzajúcich hlasových hovorov a váš účet má presne jeden povolený profil, ThunderPhone použije tento profil. Ak chcete použiť iný profil, priraďte ho pripojeniu v portáli Telnyx a znova uložte pripojenie ThunderPhone. Ak účet nemá žiadny povolený profil alebo ich má viacero, priraďte jeden profil pripojeniu v portáli Telnyx a znova uložte pripojenie ThunderPhone. Dovtedy odchádzajúce hovory zlyhávajú s chybou outbound_trunk_unavailable; prichádzajúce hovory naďalej fungujú.

Keď Telnyx odmietne odchádzajúci hovor (napríklad SIP 403 Forbidden), odmietnutie pochádza z vášho vlastného účtu Telnyx. Bežnými príčinami sú nedostupný kredit, číslo volajúceho, ktoré sa nenachádza v danom účte Telnyx, alebo profil odchádzajúcich hlasových hovorov, ktorý nepovoľuje cieľovú krajinu.

Nastavenie SIP pre SignalWire, Vonage a Plivo#

Tieto tri možnosti otvoria formulár manuálneho SIP s krokmi pre daného poskytovateľa navrchu, odkazom na vlastného sprievodcu nastavením poskytovateľa a príkladom domény SIP:

• SignalWire: vytvorte prihlasovacie údaje SIP pre odchádzajúce hovory, zadajte doménu SIP, používateľské meno a heslo a každému číslu priraďte skript SWML, ktorý pripojí prichádzajúce hovory ku koncovému bodu SIP ThunderPhone.
• Vonage: na paneli SIP Trunking vytvorte trunk s prihlasovacími údajmi pre odchádzajúce hovory, zadajte jeho doménu (napríklad your-trunk.sip-us.vonage.com) a prihlasovacie údaje, pridajte koncový bod SIP ThunderPhone ako prichádzajúci identifikátor URI SIP trunku a prepojte svoje čísla s trunkom.
• Plivo: vytvorte odchádzajúci trunk s prihlasovacím údajom a zadajte jeho Termination SIP Domain (<trunk-id>.zt.plivo.com), používateľské meno a heslo; vytvorte prichádzajúci trunk, ktorého Primary URI je koncový bod SIP ThunderPhone nasledovaný hodnotou ;transport=tcp; potom nastavte pre každé číslo Typ aplikácie na tento trunk.

Výsledkom je manuálne pripojenie SIP (provider: "manual" v rozhraní API), otestované a overené presne rovnako ako ručne zadané pripojenie. Karta pripojenia zobrazuje názov poskytovateľa, napríklad SignalWire · SIP.

Nastavte si nový účet Telnyx#

Ešte nemáte poskytovateľa? Sprievodca vás prevedie vytvorením účtu Telnyx a jeho pripojením:

1. Vytvoriť účet

   Kliknite na Otvoriť registráciu Telnyx, vytvorte si účet a začiarknite možnosť „Vytvoril som si účet“.

2. Získať kľúč API

   Kliknite na Otvoriť stránku kľúčov API, vygenerujte kľúč a vložte ho do poľa Kľúč API (v2). Pripojenie môžete voliteľne pomenovať.

3. Pripojiť a otestovať

   Kliknite na Pripojiť a otestovať — ThunderPhone overí prihlasovacie údaje a pred uložením zriadi na strane Telnyx všetko potrebné.

Čo ThunderPhone nastaví v Telnyx#

Ak nezadáte vlastné ID pripojenia, oba postupy Telnyx (sprievodca nastavením a vloženie kľúča API) zanechajú vo vašom účte Telnyx to isté: jedno pripojenie SIP s názvom thunderphone-<your organization id>. Ide o pripojenie FQDN, ktorého záznam FQDN smeruje na koncový bod SIP ThunderPhone, a je mu priradené každé číslo, ktoré importujete. Telnyx odosiela hovory na tieto čísla priamo do ThunderPhone cez SIP.

• Jeho polia webhookov sú zámerne prázdne. Nepoužíva sa žiadny webhook, aplikácia Call Control, aplikácia TeXML ani registrovaný telefón SIP.
• Neprenášajte importované čísla do iného pripojenia ani aplikácie a neregistrujte k nemu zariadenie.
• Ak ste pri pripájaní zadali vlastné ID pripojenia, ThunderPhone namiesto toho použije toto pripojenie a nikdy ho nezmení; musí ísť o pripojenie FQDN smerujúce na koncový bod SIP ThunderPhone.

Pred 30. augustom 2026 bolo pripojenie thunderphone-…, ktoré vytvoril ThunderPhone, pripojením s povereniami, ktoré nemôže prijímať hovory. Ak sa vaše pripojenie stále zobrazuje ako pripojenie s povereniami, kontaktujte podporu a prevedieme ho.

Manuálna konfigurácia SIP#

Dlaždice SignalWire, Vonage a Plivo otvoria tento formulár, rovnako ako možnosť Všetky nastavenia zadám manuálne v časti Iný poskytovateľ. Funguje akýkoľvek SIP trunk vrátane DIDWW alebo vlastnej pobočkovej ústredne PBX. Zadajte názov pripojenia, doménu SIP / URI, voliteľné používateľské meno a heslo, port a transport; Pokročilé nastavenia pridávajú šifrovanie médií (SRTP). Formulár tiež zobrazuje adresu SIP, na ktorú musí váš trunk odosielať prichádzajúce hovory: sip.thunderphone.com, na porte 5060 pre UDP alebo TCP, prípadne 5061 pre TLS. Pri TLS zostáva signalizácia SIP šifrovaná až do LiveKit Cloud, kde ThunderPhone spracúva hovor; zvuk nikdy neprechádza cez sip.thunderphone.com, takže SRTP funguje ako predtým. Každý hovor smerujte na volané číslo vo formáte E.164, s rovnakým číslom vrátane znaku + v riadku požiadavky aj v hlavičke To: napríklad sip:+14155550142@sip.thunderphone.com. Znak + umožňuje službe ThunderPhone spracovať hovor v správnom regióne (pozrite si poznámku v časti Pridanie IP adries na zoznam povolených). Trunky nastavené skôr s adresou <your-project>.sip.livekit.cloud fungujú aj naďalej, kým je pole Povolené zdrojové IP adresy prázdne; nemusíte ich meniť. ThunderPhone z týchto nastavení vytvorí vyhradenú dvojicu SIP trunkov v LiveKit Cloud: odchádzajúce hovory z čísel pripojenia sa uskutočňujú na vašu doménu SIP s vašimi prihlasovacími údajmi a prichádzajúce hovory na tieto čísla sa prijímajú z ľubovoľnej adresy, pokiaľ nevyplníte voliteľné pole Povolené zdrojové IP adresy. Vyplňte ho iba vtedy, ak váš operátor zverejňuje pevné signalizačné IP adresy: nesprávny alebo neúplný zoznam spôsobí, že ThunderPhone odmietne prichádzajúce hovory vášho operátora. Dve tlačidlá vykonávajú hlavnú časť konfigurácie:

• Vygenerovať príručku nastavenia AI — vytvorí pokyny špecifické pre poskytovateľa na konfiguráciu potrebnú na strane trunku.
• Otestovať a uložiť pripojenie — skontroluje, či sa endpoint SIP preloží na verejnú adresu a či pri TCP/TLS prijíma spojenie na zvolenom porte (hostitelia UDP získajú iba kontrolu DNS), a potom ho uloží. Zatiaľ nemôže uskutočniť hovor, pretože pripojenie nemá žiadne čísla; skutočné overenie prebehne pri importe (nižšie).

Neskoršia úprava pripojenia pred uložením čohokoľvek znova spustí rovnakú kontrolu zmenených nastavení, potom trunk znovu vytvorí a znova overí každé číslo pripojenia krátkym testovacím hovorom na pozadí — čísla sa zobrazujú ako Zriaďovanie, kým ich testovací hovor neuspeje. Zmena iba položky Povolené zdrojové IP adresy pri pripojení v stave Pripojené je odlišná: nikdy neovplyvní odchádzajúce hovory, takže ThunderPhone okamžite aktualizuje zoznam na prichádzajúcom trunku a čísla zostanú Aktívne. Test prichádzajúcich hovorov sa obnoví na stav netestované; spustite ho znova alebo uskutočnite skutočný hovor cez svojho operátora, aby ste potvrdili, že nový zoznam povoľuje prichádzajúce hovory. Test zlyhá, ak by bol jeho hovor podľa zoznamu odmietnutý. Uložené heslá sa nikdy znova nezobrazujú; ak ho chcete zachovať, nechajte pole hesla prázdne, alebo pri trunku s overovaním IP začiarknite možnosť "Odstrániť uložené heslo".

Zaradenie IP adries na zoznam povolených a autentifikácia trunku#

Niektorí operátori (DIDWW, pripojenia Telnyx s autentifikáciou IP, väčšina pobočkových ústrední PBX za firewallom) prijímajú SIP prevádzku iba z adries vo vašom zozname povolených adries alebo autentifikujú odchádzajúce hovory podľa zdrojovej IP adresy. ThunderPhone používa dve sady adries.

Okrajový server SIP. Prichádzajúce hovory, ktoré odosielate na sip.thunderphone.com, prechádzajú cez okrajový server SIP ThunderPhone, ktorý prenáša iba signalizáciu SIP. Prvý INVITE smeruje na sip.thunderphone.com; zvyšok signalizácie hovoru (ACK, ukončenie hovoru, presmerovania) prebieha medzi vaším operátorom a okrajovým serverom, ktorý hovor prijal, sip-1 alebo sip-2. Ak váš firewall filtruje signalizáciu SIP, povoľte všetky tri adresy na porte UDP a TCP 5060 a porte TLS 5061:

LiveKit Cloud. Zvuk (RTP) každého hovoru a signalizácia SIP odchádzajúcich hovorov prebiehajú medzi vaším operátorom a LiveKit Cloud, nikdy nie cez okrajový server SIP. Povoľte každý rozsah nižšie pre signalizáciu SIP aj médiá:

LiveKit používa tieto rozsahy pre Realtime, signalizáciu a médiá SIP a webhooky a pokrývajú hovory obslúžené v jeho regiónoch Kanada, EÚ, India, Japonsko a USA. Názvy regiónov pre endpoint pripnutý ku konkrétnemu regiónu: canada, eu, india, japan, us.

Pre samotný trunk platí niekoľko základných pravidiel:

• ThunderPhone sa neregistruje. Nikdy neodosiela SIP REGISTER vášmu operátorovi, preto trunk nakonfigurujte na autentifikáciu na základe IP adresy a/alebo poverení (používateľské meno + heslo), nie na registráciu.
• Odchádzajúce hovory majú používať poverenia. Na strane operátora povoľte autentifikáciu používateľským menom/heslom a do manuálneho formulára SIP zadajte rovnaké hodnoty. Zoznam povolených IP adries považujte za druhú vrstvu, nie za jedinú — odchádzajúce hovory do cieľov mimo pokrytých regiónov môžu pochádzať z iných adries.
• Prichádzajúce hovory fungujú opačným smerom. Voliteľné pole Povolené zdrojové IP adresy vo formulári slúži na zadanie signalizačných adries vášho operátora, aby ThunderPhone prijímal hovory iba z nich. Zadajte IP adresy alebo rozsahy CIDR; názvy hostiteľov sa nikdy nezhodujú. Ak váš operátor nezverejňuje pevný zoznam, ponechajte pole prázdne. ThunderPhone pri každom prichádzajúcom hovore kontroluje zoznam podľa adresy, ktorú vidí jeho okrajový server SIP, takže po nastavení zoznamu odosielajte hovory na sip.thunderphone.com. Hovor z adresy, ktorá nie je v zozname, alebo hovor odoslaný priamo na adresu <your-project>.sip.livekit.cloud, sa odmietne: zlyhá alebo sa pripojí a okamžite skončí.

Rozsahy publikuje LiveKit na stránke Regióny, regionálne endpointy a statické IP adresy; ThunderPhone túto stránku kontroluje každý týždeň a pri zmene túto príručku aktualizuje.

Po pripojení#

Importujte čísla cez Telefónne čísla → Pridať číslo → Pripojiť poskytovateľa VoIP (alebo priamo z pripojenia). Každé importované číslo sa pred aktiváciou overí. Pri manuálnom pripojení SIP toto overenie uskutoční krátky (niekoľkosekundový) testovací hovor z vášho čísla cez váš SIP trunk na číslo ThunderPhone — tým sa v praxi otestujú používateľské meno, heslo, prenos aj odchádzajúce smerovanie vášho operátora. Váš operátor tento hovor účtuje ako každý iný.

Ak ho operátor odmietne, číslo zostane v stave Zriaďovanie a stránka telefónnych čísel zobrazí odpoveď operátora (napríklad „poverenia ThunderPhone boli odmietnuté (SIP 401)“); opravte pripojenie a overte ho znova. Ak váš operátor trunk prijme, ale jeho plán smerovania nepokrýva testovacie číslo ThunderPhone (DIDWW odpovie „Cieľové číslo je na čiernej listine plánu smerovania“), číslo sa zobrazí ako Overené · prijaté operátorom: je použiteľné, ale hovory na iné ciele neboli otestované. Tento hovor dokazuje, že váš trunk dokáže hovory uskutočňovať ako dané číslo; nedokazuje, že číslo vlastníte, ani netestuje hovory na toto číslo; to robí voliteľný test prichádzajúcich hovorov nižšie. Overené čísla podporujú prichádzajúce aj odchádzajúce hovory — čo odomkne odchádzajúce kampane a programové odchádzajúce hovory.

Test prichádzajúceho hovoru#

Overiť číslo otvorí dialóg, ktorý môže otestovať aj prichádzajúce hovory. Test zavolá na vaše číslo, overí, že hovor dorazí do ThunderPhone, a potom ho ukončí bez spustenia vášho agenta:

• Čísla s vlastným odchádzajúcim trunkom SIP (manuálne čísla SIP a čísla Twilio po tom, ako ThunderPhone nastaví odchádzajúce volania vo vašom účte Twilio) najprv zavolajú samy sebe: ThunderPhone vytočí číslo z daného čísla cez tento trunk. Dialóg vás na to upozorní pred uskutočnením hovoru. Hovor odchádza cez vášho operátora a pri správnom smerovaní prichádzajúcich hovorov sa vráti priamo do ThunderPhone. Keď sa vráti s vlastnou identifikáciou volajúceho čísla, tento jeden hovor dokazuje, že váš operátor prijíma hovory ThunderPhone s identitou daného čísla aj že hovory na toto číslo dorazia do ThunderPhone, v ktorejkoľvek krajine. Niektorí operátori odmietnu alebo nespoja hovor z čísla na seba samé; nevypovedá to nič o vašom smerovaní, preto ThunderPhone následne zavolá z jedného zo svojich vlastných čísel. Ak vaše číslo presmerúva hovory inam, tento telefón môže zazvoniť dvakrát: najprv s vlastnou identifikáciou volajúceho čísla, potom s testovacím číslom ThunderPhone.
• Ostatným číslam (a v uvedenom záložnom prípade) sa volá z jedného z vlastných čísel ThunderPhone. ThunderPhone zatiaľ môže tieto hovory uskutočňovať iba na čísla v USA a Kanade; pri ostatných číslach test oznámi, že ho nebolo možné spustiť, spolu s odpoveďou vášho operátora, ak bol hovor na seba samé odmietnutý.

Ak váš operátor počas prenosu zmení identifikáciu volajúceho, ThunderPhone nedokáže hovor rozpoznať, takže ho váš agent môže na chvíľu prijať. Test prichádzajúceho hovoru je voliteľný. Môžete ho preskočiť a číslo bude naďalej fungovať; stránka telefónnych čísel potom zobrazí stav Prichádzajúce hovory neotestované a môžete ho spustiť neskôr pomocou Testovať alebo položky Testovať prichádzajúce hovory v ponuke čísla. Hneď po importe vás stránka telefónnych čísel tiež vyzve na otestovanie prichádzajúcich hovorov na nových číslach. Kým to nepotvrdíte v dialógu, nič sa nevytočí.

Ak váš poskytovateľ smeruje číslo niekam inam, cieľ, na ktorý smeruje, môže zvoniť až 8 sekúnd pri každom hovore, kým ThunderPhone hovor neukončí. Ak niečo odpovie skôr (aplikácia Twilio, ktorá odpovie a potom presmeruje hovor, telefónne menu), test čaká, kým presmerovaný hovor dorazí do ThunderPhone: až 8 sekúnd pri hovore na seba samé a 15 sekúnd pri hovore z čísla ThunderPhone. Výsledok zostane pri čísle (Prichádzajúce hovory úspešné alebo neúspešné), kým nezmeníte pripojenie alebo číslo znova neimportujete, čím sa obnoví stav neotestované. Zmena pripojenia na pozadí znova overí odchádzajúce hovory, ale nikdy nezavolá na vaše číslo bez vyžiadania.

Riešenie problémov s prichádzajúcimi hovormi#

Tlačidlo Testovať pripojenia kontroluje prihlasovacie údaje a overenie kontroluje odchádzajúce vytáčanie. Ak chcete skontrolovať prichádzajúce hovory, spustite vyššie uvedený test prichádzajúceho hovoru alebo zavolajte na číslo z telefónu a vyhľadajte hovor v Histórii hovorov. Testy Hovoriť v prehliadači a simulácie medzi botmi neprechádzajú cez vášho operátora, preto neukazujú, či prichádzajúce hovory fungujú. Simulácia, ktorá cieli na telefónne číslo (spätná slučka SIP), ho vytáča cez vášho operátora, takže prijatý hovor overí smerovanie prichádzajúcich hovorov.

• Počujete správu svojho mobilného operátora (napríklad „Vitajte vo Verizon“ alebo „volané číslo nie je v prevádzke“): hovor zlyhal pred dosiahnutím ThunderPhone. Skontrolujte, či je číslo aktívne vo vašom účte poskytovateľa a priradené k pripojeniu alebo trunku ThunderPhone.
• Obsadzovací tón alebo hovor vyzváňa bez odpovede: poskytovateľ hovor prijal, ale nedokázal ho doručiť. Pri službe Telnyx skontrolujte Pripojenie čísla v portáli Telnyx: malo by ísť o pripojenie FQDN thunderphone-… opísané vyššie alebo o vaše vlastné pripojenie FQDN smerujúce na koncový bod SIP ThunderPhone. Pri službe Twilio by malo byť číslo pripojené k trunku SIP ThunderPhone, nie k webhooku Voice ani aplikácii TwiML.
• V záznamoch vášho operátora sa zobrazuje 404 No trunk found (manuálny SIP): hovor dosiahol ThunderPhone, ale nezodpovedal žiadnemu trunku. Skontrolujte, či je číslo importované v tomto pripojení a či trunk smeruje na sip.thunderphone.com. Ak smeruje na adresu <your-project>.sip.livekit.cloud, položka Povolené zdrojové IP adresy musí byť prázdna: ak je nastavený zoznam, prijímajú sa iba hovory odoslané na sip.thunderphone.com.
• 404 Not Found z adresy sip.thunderphone.com (manuálny SIP): hovor nebol adresovaný telefónnemu číslu alebo riadok požiadavky a hlavička To uvádzajú odlišné čísla. Odošlite vytáčané číslo v oboch, ako je uvedené vyššie.
• 403 Forbidden z adresy sip.thunderphone.com: riadok požiadavky uvádza iného hostiteľa. Adresujte hovor na sip.thunderphone.com, napríklad sip:+14155550142@sip.thunderphone.com.
• Hovor dosiahne ThunderPhone, ale odpovie nesprávny agent alebo neodpovie nikto: skontrolujte agenta pre prichádzajúce hovory daného čísla v časti Telefónne čísla.

Kopilot v aplikácii môže číslo skontrolovať za vás: opýtajte sa ho, prečo hovory na toto číslo zlyhávajú. Pri pripojeniach Telnyx tiež iba na čítanie a pre správcov organizácie vyhľadá, ku ktorému pripojeniu Telnyx priraďuje číslo.

Ďalšie kroky#