Povežite ponudnika VoIP

Povežite ponudnika, ki ga že uporabljate (Twilio ali Telnyx s ključem API; SignalWire, Vonage, Plivo ali kateri koli SIP trunk prek SIP), ali odprite nov račun Telnyx z vodenim postopkom nastavitve.

Produkcijski promet naj poteka prek številk, ki jih imate v lasti pri svojem ponudniku VoIP. Stran Povezave → VoIP na nadzorni plošči (/dashboard/voip-connections) poveže račun vašega ponudnika; po povezavi uvozite številke, ki podpirajo dohodne in odhodne klice.

Kliknite Nova povezava in izberite eno od dveh možnosti: Povežite ponudnika, ki ga že uporabljate, ali Nastavite nov račun Telnyx.

Povežite ponudnika, ki ga že uporabljate#

Izberite ponudnika, pri katerem imate svoje številke:

Za Twilio in Telnyx prilepite poverilnice ter kliknite Povežite in preizkusite. ThunderPhone jih preveri in na strani ponudnika vse nastavi namesto vas. Za Telnyx ThunderPhone v vaš račun Telnyx doda eno lastno povezavo SIP (z imenom thunderphone-production-<org>-outbound-<id>) in prek nje izvaja odhodne klice, zato vam Telnyx te klice zaračuna. Uporablja profil za odhodne glasovne klice povezave Telnyx, na kateri so vaše številke, zato za ta profil veljajo dovoljene države in omejitve porabe. Če ta povezava nima profila za odhodne glasovne klice in ima vaš račun natanko en omogočen profil, ThunderPhone uporabi tega. Če želite uporabiti drugega, ga dodelite povezavi na portalu Telnyx in znova shranite povezavo ThunderPhone. Če račun nima nobenega omogočenega profila ali jih ima več, enega dodelite povezavi na portalu Telnyx in znova shranite povezavo ThunderPhone. Do takrat odhodni klici ne uspejo z outbound_trunk_unavailable; dohodni klici še naprej delujejo.

Ko Telnyx zavrne odhodni klic (na primer SIP 403 Forbidden), zavrnitev prihaja iz vašega lastnega računa Telnyx. Običajni vzroki so premalo razpoložljivega dobroimetja, klicna številka, ki ni v tem računu Telnyx, ali profil za odhodne glasovne klice, ki ne dovoljuje ciljne države.

Nastavitev SIP za SignalWire, Vonage in Plivo#

Ti trije odprejo ročni obrazec SIP s koraki za tega ponudnika na vrhu, povezavo do lastnega vodnika za nastavitev ponudnika in primerom domene SIP:

• SignalWire: ustvarite poverilnice SIP za odhodne klice, vnesite domeno SIP, uporabniško ime in geslo ter vsaki številki dodelite skript SWML, ki dohodne klice poveže s končno točko SIP ThunderPhone.
• Vonage: na nadzorni plošči SIP Trunking ustvarite trunk z poverilnicami za odhodne klice, vnesite njegovo domeno (na primer your-trunk.sip-us.vonage.com) in poverilnice, dodajte končno točko SIP ThunderPhone kot dohodni URI SIP trunka ter povežite svoje številke s trunkom.
• Plivo: ustvarite odhodni trunk s poverilnico in vnesite njegovo domeno Termination SIP (<trunk-id>.zt.plivo.com), uporabniško ime in geslo; ustvarite dohodni trunk, katerega primarni URI je končna točka SIP ThunderPhone, ki ji sledi ;transport=tcp; nato pri vsaki številki nastavite vrsto aplikacije na ta trunk.

Rezultat je ročna povezava SIP (provider: "manual" v API-ju), preizkušena in preverjena natanko tako kot ročno vnesena. Na kartici povezave je prikazano ime ponudnika, na primer SignalWire · SIP.

Nastavite nov račun Telnyx#

Še nimate ponudnika? Vodeni postopek vas vodi skozi ustvarjanje računa Telnyx in njegovo povezovanje:

1. Ustvarite račun

   Kliknite Odprite prijavo za Telnyx, ustvarite račun in označite »Ustvaril/-a sem račun.«

2. Pridobite ključ API

   Kliknite Odprite stran s ključi API, ustvarite ključ in ga prilepite v Ključ API (v2). Povezavo lahko po želji poimenujete.

3. Povežite in preskusite

   Kliknite Povežite in preskusite — ThunderPhone preveri poverilnice in pred shranjevanjem na strani Telnyx pripravi vse potrebno.

Kaj ThunderPhone nastavi v Telnyxu#

Če ne vnesete lastnega ID-ja povezave, oba načina Telnyx (vodena nastavitev in lepljenje ključa API) v vašem računu Telnyx ustvarita isto: eno povezavo SIP z imenom thunderphone-<your organization id>. Gre za povezavo FQDN, katere zapis FQDN kaže na končno točko SIP storitve ThunderPhone, in vsaka številka, ki jo uvozite, je dodeljena tej povezavi. Telnyx pošilja klice za te številke neposredno storitvi ThunderPhone prek SIP.

• Njena polja za webhook so namenoma prazna. Ne uporablja se noben webhook, aplikacija Call Control, aplikacija TeXML ali registriran telefon SIP.
• Uvoženih številk ne premaknite v drugo povezavo ali aplikacijo in nanjo ne registrirajte naprave.
• Če ste ob povezovanju vnesli lasten ID povezave, ThunderPhone namesto tega uporabi to povezavo in je nikoli ne spremeni; to mora biti povezava FQDN, ki kaže na končno točko SIP storitve ThunderPhone.

Pred 30. avgustom 2026 je bila povezava thunderphone-…, ki jo je ustvaril ThunderPhone, povezava Credential, ki ne more prejemati klicev. Če je vaša še vedno prikazana kot povezava Credential, se obrnite na podporo in jo bomo pretvorili.

Ročna konfiguracija SIP#

Ploščice SignalWire, Vonage in Plivo odprejo ta obrazec, prav tako možnost Vse nastavitve bom vnesel/-la sam/-a pod Drugi ponudnik. Deluje kateri koli SIP-trunk, vključno z DIDWW ali PBX-om, ki ga upravljate sami. Vnesite ime povezave, domeno / URI SIP, izbirno uporabniško ime in geslo, vrata ter transport; Napredne nastavitve dodajo šifriranje medijev (SRTP). Obrazec prikazuje tudi naslov SIP, na katerega mora vaš trunk pošiljati dohodne klice: sip.thunderphone.com, na vratih 5060 za UDP ali TCP oziroma 5061 za TLS. Pri TLS signalizacija SIP ostane šifrirana vse do LiveKit Cloud, kjer ThunderPhone obravnava klic; zvok nikoli ne potuje prek sip.thunderphone.com, zato SRTP deluje kot prej. Vsak klic naslovite na izbrano številko v obliki E.164, pri čemer uporabite isto številko, vključno z +, tako v vrstici zahteve kot v glavi To: na primer sip:+14155550142@sip.thunderphone.com. Znak + omogoča, da ThunderPhone klic obravnava v pravilni regiji (glejte opombo pod Seznam dovoljenih naslovov IP). Trunki, ki so bili prej nastavljeni z naslovom <your-project>.sip.livekit.cloud, ostanejo delujoči, dokler je polje Dovoljeni izvorni naslovi IP prazno; ni jih treba spreminjati. ThunderPhone te nastavitve pretvori v namenski par SIP-trunkov v LiveKit Cloud: odhodni klici s številk povezave se z vašimi poverilnicami vzpostavijo do vaše domene SIP, dohodni klici na te številke pa so sprejeti s katerega koli naslova, razen če izpolnite izbirno polje Dovoljeni izvorni naslovi IP. Izpolnite ga le, če vaš operater objavlja fiksne naslove IP za signalizacijo: zaradi napačnega ali nepopolnega seznama ThunderPhone zavrne dohodne klice vašega operaterja. Dva gumba opravita glavno delo:

• Ustvarite vodnik za nastavitev AI — pripravi navodila, specifična za ponudnika, za potrebno konfiguracijo na strani trunka.
• Preizkusite in shranite povezavo — preveri, ali se končna točka SIP razreši v javni naslov in ali pri TCP/TLS sprejme povezavo na izbranih vratih (gostitelji UDP dobijo samo preverjanje DNS), nato pa jo shrani. Klica še ne more vzpostaviti, ker povezava nima številk; dejansko preverjanje se izvede ob uvozu (spodaj).

Poznejše urejanje povezave pred shranjevanjem znova zažene isto preverjanje spremenjenih nastavitev, nato znova ustvari trunk in v ozadju s kratkim preskusnim klicem znova preveri vsako številko v povezavi — številke so prikazane kot Priprava, dokler njihov preskusni klic ne uspe. Spreminjanje samo polja Dovoljeni izvorni naslovi IP pri povezavi Povezano je drugačno: nikoli ne vpliva na odhodne klice, zato ThunderPhone seznam takoj posodobi na dohodnem trunku, številke pa ostanejo Aktivne. Njihov preskus dohodnega klica se ponastavi na ni preizkušeno; znova ga zaženite ali opravite dejanski klic prek svojega operaterja, da potrdite, da novi seznam dovoljuje klice. Preskus ne uspe, če bi bil njegov klic zaradi seznama zavrnjen. Shranjena gesla niso nikoli znova prikazana; pustite polje za geslo prazno, da ga ohranite, ali označite »Odstrani shranjeno geslo« za trunk, preverjen z naslovom IP.

Seznam dovoljenih IP-naslovov in avtentikacija trunka#

Nekateri ponudniki (DIDWW, povezave Telnyx z avtentikacijo IP, večina central PBX za požarnim zidom) sprejemajo promet SIP samo z naslovov na vašem seznamu dovoljenih naslovov ali pa odhodne klice avtentikirajo glede na izvorni IP. ThunderPhone uporablja dva sklopa naslovov.

Rob SIP. Dohodni klici, ki jih pošljete na sip.thunderphone.com, potekajo prek roba SIP ThunderPhone, ki prenaša samo signalizacijo SIP. Prvi INVITE se pošlje na sip.thunderphone.com; preostanek signalizacije klica (ACK, prekinitev, prenosi) poteka med vašim ponudnikom in robnim strežnikom, ki je sprejel klic, sip-1 ali sip-2. Če vaš požarni zid filtrira signalizacijo SIP, dovolite vse tri na vratih UDP in TCP 5060 ter vratih TLS 5061:

LiveKit Cloud. Zvok (RTP) vsakega klica in signalizacija SIP odhodnih klicev potekata med vašim ponudnikom in LiveKit Cloud, nikoli prek roba SIP. Dovolite vse spodnje obsege za signalizacijo SIP in medije:

LiveKit te obsege uporablja za Realtime, signalizacijo SIP, medije in spletne kljuke, pokrivajo pa klice, obravnavane v njegovih regijah Kanada, EU, Indija, Japonska in ZDA. Imena regij za pripeto končno točko: canada, eu, india, japan, us.

Nekaj praktičnih pravil za sam trunk:

• ThunderPhone se ne registrira. Vašemu ponudniku nikoli ne pošlje SIP REGISTER, zato trunk konfigurirajte za avtentikacijo na podlagi IP-ja in/ali poverilnic (uporabniško ime + geslo), ne za registracijo.
• Odhodni klici naj uporabljajo poverilnice. Na strani ponudnika omogočite avtentikacijo z uporabniškim imenom/geslom in v ročni obrazec SIP vnesite iste vrednosti. Seznam dovoljenih naslovov IP obravnavajte kot drugo plast, ne kot edino — odhodni klici na cilje zunaj podprtih regij lahko izvirajo z drugih naslovov.
• Dohodni promet poteka v obratni smeri. Neobvezno polje Dovoljeni izvorni naslovi IP v obrazcu je namenjeno vnosu signalizacijskih naslovov vašega ponudnika, da ThunderPhone sprejema klice samo z njih. Vnesite naslove IP ali obsege CIDR; imena gostiteljev se nikoli ne ujemajo. Polje pustite prazno, razen če vaš ponudnik objavlja nespremenljiv seznam. ThunderPhone preveri seznam pri vsakem dohodnem klicu glede na naslov, ki ga vidi njegov rob SIP, zato po nastavitvi seznama klice pošiljajte na sip.thunderphone.com. Klic z naslova, ki ni na seznamu, ali klic, poslan neposredno na naslov <your-project>.sip.livekit.cloud, je zavrnjen: ne uspe ali pa se poveže in se takoj prekine.

Obsege objavlja LiveKit na strani Regije, regionalne končne točke in statični IP-naslovi; ThunderPhone to stran preverja tedensko in posodobi ta vodnik, ko se spremeni.

Po povezavi#

Uvozite številke iz Phone Numbers → Add number → Connect VoIP provider (ali neposredno iz povezave). Vsaka uvožena številka je preverjena, preden postane aktivna. Pri ročni povezavi SIP to preverjanje izvede kratek (nekajsekundni) preskusni klic z vaše številke prek vašega SIP-trunka na številko ThunderPhone — tako se v praksi preverijo uporabniško ime, geslo, transport in odhodno usmerjanje vašega operaterja. Vaš operater ta klic zaračuna kot vsak drug klic. Če ga operater zavrne, številka ostane v stanju Provisioning, stran s telefonskimi številkami pa prikaže odgovor operaterja (na primer »rejected ThunderPhone's credentials (SIP 401)«); popravite povezavo in znova preverite. Če vaš operater sprejme trunk, vendar njegov načrt usmerjanja ne pokriva preskusne številke ThunderPhone (DIDWW odgovori »Destination number blacklisted by routing plan«), je številka prikazana kot Verified · carrier accepted: je uporabna, vendar klici na druge ciljne številke niso bili preskušeni. Ta klic dokazuje, da lahko vaš trunk vzpostavlja klice kot ta številka; ne dokazuje, da ste lastnik številke, in ne preskuša klicev na številko; to opravi spodnji izbirni preskus dohodnih klicev. Preverjene številke podpirajo dohodne in odhodne klice — kar omogoči odhodne kampanje in programske odhodne klice.

Preizkus dohodnega klica#

Preverite številko odpre pogovorno okno, ki lahko preizkusi tudi dohodne klice. Preizkus pokliče vašo številko, preveri, ali klic doseže ThunderPhone, nato pa prekine brez zagona vašega agenta:

• Številke z lastnim odhodnim vodom SIP (ročne številke SIP in številke Twilio, ko ThunderPhone v vašem računu Twilio nastavi odhodno klicanje) najprej pokličejo same sebe: ThunderPhone pokliče številko z nje same prek tega voda. Pogovorno okno vas obvesti, preden izvede klic. Klic gre prek vašega operaterja in se, če je vaše dohodno usmerjanje pravilno, vrne neposredno v ThunderPhone. Ko se vrne z lastnim ID-jem klicatelja številke, ta en klic potrdi tako, da vaš operater sprejema klice ThunderPhone kot ta številka, kot tudi, da klici na številko dosežejo ThunderPhone, v kateri koli državi. Nekateri operaterji zavrnejo ali ne povežejo klica s številke na isto številko; to ne pove ničesar o vašem usmerjanju, zato ThunderPhone nato pokliče z ene od svojih številk. Če se vaša številka preusmerja drugam, lahko ta telefon zazvoni dvakrat: prvič z lastnim ID-jem klicatelja številke, nato pa s testno številko ThunderPhone.
• Druge številke (in zgornji nadomestni način) so poklicane z ene od lastnih številk ThunderPhone. ThunderPhone lahko te klice trenutno izvede le na številke v ZDA in Kanadi; za druge številke preizkus sporoči, da ga ni bilo mogoče izvesti, skupaj z odgovorom vašega operaterja, če je bil klic na lastno številko zavrnjen.

Če vaš operater med potjo spremeni ID klicatelja, ThunderPhone klica ne more prepoznati, zato lahko vaš agent nanj za trenutek odgovori. Preizkus dohodnega klica ni obvezen. Preskočite ga in številka bo še vedno delovala; stran s telefonskimi številkami bo nato prikazala Dohodni klici niso preizkušeni, pozneje pa ga lahko izvedete z možnostjo Preizkusite ali menijskim elementom številke Preizkusite dohodne klice. Takoj po uvozu vas stran s telefonskimi številkami prav tako pozove, da preizkusite dohodne klice za nove številke. Dokler ne potrdite v pogovornem oknu, se ne izvede noben klic.

Če vaš ponudnik številko usmeri drugam, lahko tam, kamor kaže, zvoni do 8 sekund na klic, preden ThunderPhone prekine klic. Če se nekaj oglasi prej (aplikacija Twilio, ki se oglasi in nato preusmeri, telefonski meni), preizkus počaka, da preusmerjeni klic doseže ThunderPhone: do 8 sekund pri klicu na lastno številko in 15 sekund pri klicu s številke ThunderPhone. Rezultat ostane pri številki (Dohodni klici uspešni ali neuspešni), dokler ne spremenite povezave ali znova uvozite številke, kar ga ponastavi na ni preizkušeno. Sprememba povezave v ozadju znova preveri odhodne klice, vendar nikoli ne pokliče vaše številke brez vaše zahteve.

Odpravljanje težav z dohodnimi klici#

Gumb Preizkus povezave preveri poverilnice, preverjanje pa preveri odhodno klicanje. Če želite preveriti dohodne klice, zaženite zgornji preizkus dohodnega klica ali pokličite številko s telefona in poiščite klic v Zgodovini klicev. Preizkusi Talk v brskalniku in simulacije med boti ne potekajo prek vašega operaterja, zato ne pokažejo, ali dohodni klici delujejo. Simulacija, usmerjena na telefonsko številko (povratna zanka SIP), jo pokliče prek vašega operaterja, zato sprejet klic dejansko preveri usmerjanje dohodnih klicev.

• Slišite sporočilo svojega mobilnega operaterja (na primer »Dobrodošli pri Verizon« ali »številka, ki ste jo poklicali, ni v uporabi«): klic ni uspel, preden je dosegel ThunderPhone. Preverite, ali je številka aktivna v računu pri ponudniku in dodeljena povezavi ali deblu ThunderPhone.
• Signal zasedene linije ali klic zvoni do prekinitve: ponudnik je klic sprejel, vendar ga ni mogel dostaviti. Pri Telnyx preverite Povezavo številke v portalu Telnyx: to mora biti zgoraj opisana povezava FQDN thunderphone-… ali vaša povezava FQDN, ki kaže na končno točko SIP ThunderPhone. Pri Twilio mora biti številka povezana z deblom SIP ThunderPhone in ne s spletnim klicem Voice ali aplikacijo TwiML.
• Dnevniki vašega operaterja prikazujejo 404 No trunk found (ročni SIP): klic je dosegel ThunderPhone, vendar se ni ujemal z nobenim deblom. Preverite, ali je številka uvožena v tej povezavi in ali deblo kaže na sip.thunderphone.com. Če kaže na naslov <your-project>.sip.livekit.cloud, morajo biti Dovoljeni izvorni IP-naslovi prazni: če je seznam nastavljen, so sprejeti samo klici, poslani na sip.thunderphone.com.
• 404 Not Found od sip.thunderphone.com (ročni SIP): klic ni bil naslovljen na telefonsko številko ali pa vrstica zahteve in glava To navajata različni številki. Poklicano številko pošljite v obeh, kot je opisano zgoraj.
• 403 Forbidden od sip.thunderphone.com: vrstica zahteve navaja drugega gostitelja. Klic naslovite na sip.thunderphone.com, na primer sip:+14155550142@sip.thunderphone.com.
• Klic doseže ThunderPhone, vendar se oglasi napačen agent ali pa se ne oglasi nihče: preverite dohodnega agenta številke v Telefonskih številkah.

Kopilot v aplikaciji lahko preveri številko namesto vas: vprašajte ga, zakaj klici na številko ne uspejo. Pri povezavah Telnyx lahko tudi samo za branje in za skrbnike organizacije poišče, kateri povezavi Telnyx dodeli številko.

Naslednji koraki#