Ühenda VoIP-teenusepakkuja

Ühenda juba kasutatav teenusepakkuja (Twilio või Telnyx API-võtmega; SignalWire, Vonage, Plivo või mis tahes SIP-trunk SIP-i kaudu) või ava uue Telnyxi konto juhendatud seadistusega.

Tootmisliiklus peaks käima sulle kuuluvatel numbritel sinu enda VoIP-teenusepakkuja kaudu. Juhtpaneeli leht Ühendused → VoIP (/dashboard/voip-connections) ühendab sinu teenusepakkuja konto; pärast ühendamist impordid numbrid, mis toetavad nii sissetulevaid kui ka väljaminevaid kõnesid.

Klõpsa Uus ühendus ja vali üks kahest võimalusest: Ühenda juba kasutatav pakkuja või Seadista uus Telnyxi konto.

Ühenda juba kasutatav teenusepakkuja#

Vali teenusepakkuja, kelle juures sinu numbrid asuvad:

Twilio ja Telnyxi puhul kleebi sisselogimisandmed ning klõpsa Ühenda ja testi. ThunderPhone kontrollib need ja seadistab teenusepakkuja poole sinu eest. Telnyxi puhul lisab ThunderPhone sinu Telnyxi kontole ühe enda SIP-ühenduse (nimega thunderphone-production-<org>-outbound-<id>) ning teeb selle kaudu väljaminevaid kõnesid, seega esitab Telnyx nende kõnede eest arve sulle. See kasutab selle Telnyxi ühenduse väljamineva hääleprofiili, millel sinu numbrid asuvad, seega kehtivad selle profiili lubatud riigid ja kululimiidid. Kui sellel ühendusel puudub väljamineva hääle profiil ja sinu kontol on täpselt üks lubatud profiil, kasutab ThunderPhone seda. Muu profiili kasutamiseks määra see Telnyxi portaalis ühendusele ja salvesta ThunderPhone'i ühendus uuesti. Kui kontol pole ühtegi lubatud profiili või neid on mitu, määra üks Telnyxi portaalis ühendusele ja salvesta ThunderPhone'i ühendus uuesti. Seni nurjuvad väljaminevad kõned veaga outbound_trunk_unavailable; sissetulevad kõned toimivad edasi.

Kui Telnyx keeldub väljaminevast kõnest (näiteks SIP 403 Forbidden), tuleb keeldumine sinu enda Telnyxi kontolt. Tavapärased põhjused on puuduv vaba krediit, helistaja number, mis ei kuulu sellele Telnyxi kontole, või väljamineva hääle profiil, mis ei luba sihtriiki.

SignalWire'i, Vonage'i ja Plivo SIP-i seadistamine#

Need kolm avavad käsitsi SIP-i seadistusvormi, kus selle teenusepakkuja juhised on üleval, lisaks link teenusepakkuja enda seadistusjuhendile ja näidis-SIP-domeen:

• SignalWire: loo väljaminevate kõnede jaoks SIP-i sisselogimisandmed, sisesta SIP-domeen, kasutajanimi ja parool ning määra igale numbrile SWML-skript, mis ühendab sissetulevad kõned ThunderPhone'i SIP-lõpp-punktiga.
• Vonage: loo SIP Trunkingu töölaual trunk väljaminevate sisselogimisandmetega, sisesta selle domeen (näiteks your-trunk.sip-us.vonage.com) ja sisselogimisandmed, lisa ThunderPhone'i SIP-lõpp-punkt trunk'i sissetuleva SIP URI-na ning seo oma numbrid trunk'iga.
• Plivo: loo sisselogimisandmetega väljaminev trunk ja sisesta selle lõpetamise SIP-domeen (<trunk-id>.zt.plivo.com), kasutajanimi ja parool; loo sissetulev trunk, mille Primary URI on ThunderPhone'i SIP-lõpp-punkt, millele järgneb ;transport=tcp; seejärel määra iga numbri Application Type'iks see trunk.

Tulemuseks on käsitsi seadistatud SIP-ühendus (provider: "manual" API-s), mida testitakse ja kontrollitakse täpselt nagu käsitsi sisestatud ühendust. Ühenduse kaardil kuvatakse teenusepakkuja nimi, näiteks SignalWire · SIP.

Seadista uus Telnyxi konto#

Kas pakkujat veel pole? Juhendatud protsess aitab sul luua Telnyxi konto ja selle ühendada:

1. Loo konto

   Klõpsa Ava Telnyxi registreerimine, loo konto ja märgi "Olen konto loonud."

2. Hangi API-võti

   Klõpsa Ava API-võtmete leht, loo võti ja kleebi see väljale API-võti (v2). Soovi korral pane ühendusele nimi.

3. Ühenda ja testi

   Klõpsa Ühenda ja testi — ThunderPhone kontrollib autentimisandmeid ja seadistab enne salvestamist Telnyxi poolel vajaliku.

Mida ThunderPhone Telnyxis seadistab#

Kui sa ei sisesta oma ühenduse ID-d, jätavad mõlemad Telnyxi viisid (juhendatud seadistus ja API võtme kleepimine) sinu Telnyxi kontole sama asja: ühe SIP-ühenduse nimega thunderphone-<your organization id>. See on FQDN-ühendus, mille FQDN-kirje osutab ThunderPhone'i SIP-lõpp-punktile ja sellele määratakse iga imporditud number. Telnyx saadab nendele numbritele tehtud kõned SIP-i kaudu otse ThunderPhone'i.

• Selle veebikonksu väljad on tahtlikult tühjad. Kasutusel ei ole ühtki veebikonksu, Call Controli rakendust, TeXML-i rakendust ega registreeritud SIP-telefoni.
• Ära liiguta imporditud numbreid teise ühenduse või rakenduse alla ega registreeri selle jaoks seadet.
• Kui sisestasid ühendamisel oma ühenduse ID, kasutab ThunderPhone selle asemel seda ühendust ega muuda seda kunagi; see peab olema ThunderPhone'i SIP-lõpp-punktile osutav FQDN-ühendus.

Enne 30. augustit 2026 oli ThunderPhone'i loodud thunderphone-… ühendus mandaatühendus, mis ei saa kõnesid vastu võtta. Kui sinu ühendus kuvatakse endiselt mandaatühendusena, võta ühendust toega ja me teisendame selle.

SIP-i käsitsi seadistamine#

SignalWire'i, Vonage'i ja Plivo paanid avavad selle vormi, nagu ka Sisestan kõik seaded ise jaotises Muu teenusepakkuja. Sobib mis tahes SIP-trunk, sealhulgas DIDWW või sinu hallatav PBX. Sisesta ühenduse nimi, SIP-domeen / URI, valikuline kasutajanimi ja parool, port ning transpordiprotokoll; Täpsemad seaded lisavad meediumikrüpteerimise (SRTP). Vormil kuvatakse ka SIP-aadress, kuhu sinu trunk peab sissetulevad kõned saatma: sip.thunderphone.com, UDP või TCP puhul pordil 5060 ja TLS-i puhul pordil 5061. TLS-i kaudu jääb SIP-signalisatsioon krüpteerituks kuni LiveKit Cloudini, kus ThunderPhone kõnet haldab; heli ei liigu kunagi läbi sip.thunderphone.com, seega toimib SRTP endiselt samamoodi. Suuna iga kõne valitud numbrile E.164 vormingus, kasutades sama numbrit koos märgiga + nii päringureal kui ka päises To: näiteks sip:+14155550142@sip.thunderphone.com. Märk + võimaldab ThunderPhone'il kõnet õiges piirkonnas hallata (vt märkust jaotises IP-aadresside lubatud loend). Varem aadressiga <your-project>.sip.livekit.cloud seadistatud trunkid töötavad edasi, kui väli Lubatud lähte-IP-aadressid on tühi; neid ei ole vaja muuta. ThunderPhone muudab need seaded LiveKit Cloudis eraldi SIP-trunkide paariks: väljaminevad kõned ühenduse numbritelt suunatakse sinu SIP-domeeni sinu autentimisandmetega ning nendele numbritele tehtavad sissetulevad kõned võetakse vastu mis tahes aadressilt, välja arvatud juhul, kui täidad valikulise välja Lubatud lähte-IP-aadressid. Täida see ainult siis, kui sinu operaator avaldab fikseeritud signalisatsiooni-IP-aadressid: vale või mittetäielik loend paneb ThunderPhone'i sinu operaatori sissetulevaid kõnesid tagasi lükkama. Kaks nuppu teevad põhitöö ära:

• Loo AI seadistusjuhend — koostab teenusepakkujapõhised juhised vajalikuks trunkipoolseks seadistamiseks.
• Testi ja salvesta ühendus — kontrollib, kas SIP-lõpp-punkt lahendub avalikuks aadressiks ning TCP/TLS-i puhul aktsepteerib ühendust valitud pordis (UDP-hostide puhul tehakse ainult DNS-i kontroll), ja seejärel salvestab. See ei saa veel kõnet teha, kuna ühendusel pole numbreid; tegelik tõendus tuleb importimise ajal (allpool).

Ühenduse hilisem muutmine käivitab enne muudatuste salvestamist uuesti sama kontrolli sinu muudetud seadetega, seejärel loob trunk'i uuesti ja kontrollib taustal lühikese testkõnega uuesti kõiki ühenduse numbreid — numbrite olekuks kuvatakse Seadistamisel, kuni nende testkõne õnnestub. Ainult välja Lubatud lähte-IP-aadressid muutmine Ühendatud ühenduses on teistsugune: see ei mõjuta kunagi väljaminevaid kõnesid, seega ThunderPhone värskendab loendi kohe sissetulevas trunk'is ja numbrite olek jääb Aktiivne. Nende sissetuleva kõne test lähtestatakse olekusse testimata; käivita see uuesti või tee oma operaatori kaudu päris kõne, et kinnitada, et uus loend lubab kõned sisse. Test nurjub, kui loend tõrjuks selle kõne. Salvestatud paroole ei kuvata kunagi uuesti; säilitamiseks jäta parool tühjaks või märgi IP-autenditud trunk'i puhul ruut "Eemalda salvestatud parool".

IP-aadresside lubatud loend ja trunk'i autentimine#

Mõned operaatorid (DIDWW, Telnyxi IP-autentimisega ühendused, enamik tulemüüri taga olevaid PBX-e) aktsepteerivad SIP-liiklust ainult sinu lubatud loendis olevatelt aadressidelt või autentivad väljaminevaid kõnesid lähte-IP-aadressi järgi. ThunderPhone kasutab kahte aadresside komplekti.

SIP-i ääreserver. Sissetulevad kõned, mille saadad aadressile sip.thunderphone.com, läbivad ThunderPhone'i SIP-i ääreserveri, mis edastab ainult SIP-signalisatsiooni. Esimene INVITE saadetakse aadressile sip.thunderphone.com; ülejäänud kõne signalisatsioon (ACK, kõne lõpetamine, ümbersuunamised) toimub sinu operaatori ja kõne vastu võtnud ääreserveri, sip-1 või sip-2, vahel. Kui sinu tulemüür filtreerib SIP-signalisatsiooni, luba kõik kolm aadressi UDP- ja TCP-pordis 5060 ning TLS-pordis 5061:

LiveKit Cloud. Iga kõne heli (RTP) ja väljaminevate kõnede SIP-signalisatsioon toimuvad sinu operaatori ja LiveKit Cloudi vahel, mitte kunagi SIP-i ääreserveri kaudu. Luba nii SIP-signalisatsiooni kui ka meedia jaoks kõik alltoodud vahemikud:

LiveKit rakendab neid vahemikke Realtime'i, SIP-signalisatsiooni ja meediumi ning veebikonksude jaoks ning need katavad kõnesid selle Kanada, EL-i, India, Jaapani ja USA piirkondades. Fikseeritud lõpp-punkti piirkonnanimed: canada, eu, india, japan, us.

Mõned praktilised reeglid trunk'i kohta:

• ThunderPhone ei registreeri end. See ei saada kunagi sinu operaatorile SIP-i REGISTER, seega seadista magistraal IP-põhiseks ja/või autentimisandmetel (kasutajanimi + parool) põhinevaks autentimiseks, mitte registreerimiseks.
• Väljaminevad kõned peaksid kasutama autentimisandmeid. Luba operaatori poolel kasutajanime/parooliga autentimine ja sisesta samad väärtused käsitsi SIP-vormi. Käsitle IP-lubatud loendit teise kihina, mitte ainsa kihina — hõlmatud piirkondadest väljapoole suunduvad kõned võivad pärineda muudelt aadressidelt.
• Sissetulev suund on vastupidine. Vormi valikuline väli Lubatud lähte-IP-aadressid on koht, kuhu sisestad oma operaatori signalisatsiooniaadressid, et ThunderPhone võtaks vastu kõnesid ainult neilt. Sisesta IP-aadressid või CIDR-vahemikud; hostinimed ei sobitu kunagi. Jäta see tühjaks, kui sinu operaator ei avalda kindlat loendit. ThunderPhone kontrollib loendit iga sissetuleva kõne puhul aadressi suhtes, mida selle SIP-i ääreserver näeb, seega pärast loendi seadistamist saada oma kõned aadressile sip.thunderphone.com. Kõne aadressilt, mida loendis ei ole, või otse aadressile <your-project>.sip.livekit.cloud saadetud kõne lükatakse tagasi: see nurjub või ühendatakse ja lõpetatakse kohe.

LiveKit avaldab need vahemikud lehel Piirkonnad, piirkondlikud lõpp-punktid ja staatilised IP-d; ThunderPhone kontrollib seda lehte igal nädalal ja uuendab seda juhendit, kui see muutub.

Pärast ühendamist#

Impordi numbreid menüüst Telefoninumbrid → Lisa number → Ühenda VoIP teenusepakkuja (või otse ühendusest). Iga imporditud number kontrollitakse enne selle aktiveerimist. Käsitsi loodud SIP-ühenduse korral teeb see kontroll lühikese (mõne sekundi pikkuse) testkõne sinu numbrilt, sinu SIP-trunki kaudu ThunderPhone'i numbrile — nii kontrollitakse tegelikus kasutuses kasutajanime, parooli, transpordiprotokolli ja sinu operaatori väljaminevate kõnede marsruutimist. Sinu operaator arveldab selle kõne nagu iga teise kõne. Kui operaator selle tagasi lükkab, jääb number olekusse Seadistamisel ja telefoninumbrite lehel kuvatakse operaatori vastus (näiteks „ThunderPhone'i tunnused lükati tagasi (SIP 401)”); paranda ühendus ja kontrolli uuesti. Kui sinu operaator aktsepteerib trunk'i, kuid selle marsruutimisplaan ei hõlma ThunderPhone'i testnumbrit (DIDWW vastab „Sihtnumber on marsruutimisplaani poolt musta nimekirja kantud”), kuvatakse numbri olekuna Kontrollitud · operaator aktsepteeris: see on kasutatav, kuid kõnesid teistele sihtkohtadele ei testitud. See kõne tõendab, et sinu trunk saab selle numbri nimel kõnesid teha; see ei tõenda, et number kuulub sulle, ega testi kõnesid numbrile; seda teeb allolev valikuline sissetulevate kõnede test. Kontrollitud numbrid toetavad sissetulevaid ja väljaminevaid kõnesid — see avab väljaminevad kampaaniad ja programmilised väljaminevad kõned.

Sissetuleva kõne test#

Kinnita number avab dialoogi, millega saab testida ka sissetulevaid kõnesid. Test helistab sinu numbrile, kontrollib, kas kõne jõuab ThunderPhone'i, ja lõpetab seejärel kõne häälagenti käivitamata:

• Oma väljamineva SIP-trunkiga numbrid (käsitsi lisatud SIP-numbrid ning Twilio numbrid pärast seda, kui ThunderPhone on sinu Twilio kontol väljaminevad kõned seadistanud) helistavad esmalt iseendale: ThunderPhone valib numbri sellelt numbrilt selle trunk'i kaudu. Dialoog teavitab sind enne kõne tegemist. Kõne läheb välja sinu operaatori kaudu ja tuleb õige sissetuleva kõne marsruutimise korral otse tagasi ThunderPhone'i. Kui kõne tuleb tagasi numbri enda helistaja ID-ga, tõendab see üks kõne nii seda, et sinu operaator aktsepteerib ThunderPhone'i kõnesid selle numbrina, kui ka seda, et sellele numbrile tehtud kõned jõuavad ThunderPhone'i mis tahes riigis. Mõni operaator keeldub numbrilt iseendale tehtud kõnest või ei ühenda seda; see ei ütle sinu marsruutimise kohta midagi, seega helistab ThunderPhone seejärel hoopis ühelt oma numbrilt. Kui sinu number on kuhugi mujale suunatud, võib see telefon heliseda kaks korda: esmalt numbri enda helistaja ID-ga, seejärel ThunderPhone'i testnumbriga.
• Muudele numbritele (ning ülaltoodud varuvariandina) helistatakse ühelt ThunderPhone'i enda numbrilt. ThunderPhone saab neid kõnesid praegu teha ainult USA ja Kanada numbritele; muude numbrite puhul teatab test, et seda ei saanud käivitada, ning kui iseendale helistamisest keelduti, kuvatakse ka sinu operaatori vastus.

Kui sinu operaator muudab teel helistaja ID-d, ei saa ThunderPhone kõnet ära tunda, mistõttu võib sinu häälagent sellele hetkeks vastata. Sissetuleva kõne test on valikuline. Jäta see vahele ja number töötab ikkagi; telefoninumbrite lehel kuvatakse siis Sissetulevaid kõnesid pole testitud ning saad testi hiljem käivitada nupuga Testi või numbri menüüpunktiga Testi sissetulevaid kõnesid. Kohe pärast importimist palub telefoninumbrite leht sul testida ka uute numbrite sissetulevaid kõnesid. Ühtki numbrit ei valita enne, kui kinnitad selle dialoogis.

Kui sinu teenusepakkuja suunab numbri mujale, võib see, millele number osutab, heliseda kuni 8 sekundit kõne kohta, enne kui ThunderPhone kõne lõpetab. Kui miski vastab esimesena (Twilio rakendus, mis vastab ja seejärel suunab edasi, telefonimenüü), ootab test edasisuunatud kõne jõudmist ThunderPhone'i: iseendale tehtud kõne puhul kuni 8 sekundit ja ThunderPhone'i numbrilt tehtud kõne puhul 15 sekundit. Tulemus jääb numbrile (Sissetulev õnnestus või ebaõnnestus), kuni muudad ühendust või impordid numbri uuesti, mis lähtestab selle olekusse pole testitud. Ühenduse muutmine kinnitab väljaminevad kõned taustal uuesti, kuid ei helista sinu numbrile kunagi ilma sinult küsimata.

Sissetulevate kõnede tõrkeotsing#

Ühenduse nupp Testi kontrollib mandaate ning kinnitamine kontrollib väljaminevat helistamist. Sissetulevate kõnede kontrollimiseks käivita ülal olev sissetuleva kõne test või helista numbrile telefonilt ja otsi kõnet jaotisest Kõneajalugu. Brauseri Räägi testid ja robotitevahelised simulatsioonid ei läbi sinu operaatorit, seega ei näita need, kas sissetulevad kõned toimivad. Telefoninumbrile suunatud simulatsioon (SIP-tagasisilmus) helistab sellele sinu operaatori kaudu, seega vastatud kõne kontrollib sissetulevate kõnede suunamist.

• Kuulete oma mobiilioperaatori teadet (näiteks „Tere tulemast Verizoni” või „valitud number ei ole kasutusel”): kõne ebaõnnestus enne ThunderPhone'ini jõudmist. Kontrolli, et number oleks sinu teenusepakkuja kontol aktiivne ja määratud ThunderPhone'i ühendusele või trunkile.
• Kinnine toon või kõne heliseb lõpuni: teenusepakkuja võttis kõne vastu, kuid ei suutnud seda edastada. Telnyxi puhul kontrolli Telnyxi portaalis numbri Ühendust: see peab olema eespool kirjeldatud thunderphone-… FQDN-ühendus või sinu enda FQDN-ühendus, mis suunab ThunderPhone'i SIP-lõpp-punktile. Twilio puhul peab number olema ühendatud ThunderPhone'i SIP-trunkiga, mitte Voice'i veebikonksu või TwiML-i rakendusega.
• Sinu operaatori logides kuvatakse 404 No trunk found (käsitsi SIP): kõne jõudis ThunderPhone'i, kuid ei vastanud ühelegi trunkile. Kontrolli, et number oleks sellesse ühendusse imporditud ja trunk suunaks aadressile sip.thunderphone.com. Kui see suunab aadressile <your-project>.sip.livekit.cloud, peavad Lubatud lähte-IP-d olema tühjad: määratud loendi korral võetakse vastu ainult kõned, mis saadetakse aadressile sip.thunderphone.com.
• 404 Not Found aadressilt sip.thunderphone.com (käsitsi SIP): kõne ei olnud adresseeritud telefoninumbrile või päringurida ja To päis nimetavad erinevaid numbreid. Saada valitud number mõlemas, nagu eespool kirjeldatud.
• 403 Forbidden aadressilt sip.thunderphone.com: päringurida nimetab teist hosti. Adresseeri kõne aadressile sip.thunderphone.com, näiteks sip:+14155550142@sip.thunderphone.com.
• Kõne jõuab ThunderPhone'i, kuid vastab vale agent või ei vasta keegi: kontrolli numbri sissetulevate kõnede agenti jaotises Telefoninumbrid.

Rakendusesisene kaaspiloot saab numbrit sinu eest kontrollida: küsi, miks numbrile tehtavad kõned ebaõnnestuvad. Telnyxi ühenduste puhul otsib see kirjutuskaitstud režiimis ja organisatsiooni administraatorite jaoks ka välja, millisele ühendusele Telnyx numbri määrab.

Järgmised sammud#