Prijunkite VoIP teikėją

Prijunkite jau naudojamą teikėją (Twilio arba Telnyx naudodami API raktą; SignalWire, Vonage, Plivo arba bet kurią SIP magistralę per SIP) arba atidarykite naują Telnyx paskyrą naudodami vedamąją sąranką.

Produkcinis srautas turėtų vykti per jums priklausančius numerius ir jūsų VoIP tiekėją. Valdymo skydelio puslapyje Connections → VoIP (/dashboard/voip-connections) prijungiate savo tiekėjo paskyrą; ją prijungę, importuokite numerius, palaikančius įeinančius ir išeinančius skambučius.

Spustelėkite Naujas ryšys ir pasirinkite vieną iš dviejų būdų: Prijunkite jau naudojamą paslaugų teikėją arba Sukurkite naują Telnyx paskyrą.

Prijunkite jau naudojamą teikėją#

Pasirinkite teikėją, pas kurį yra jūsų numeriai:

Jei naudojate Twilio arba Telnyx, įklijuokite prisijungimo duomenis ir spustelėkite Prijungti ir išbandyti. ThunderPhone juos patikrina ir sukonfigūruoja teikėjo pusę už jus. Jei naudojate Telnyx, ThunderPhone į jūsų Telnyx paskyrą prideda savo SIP jungtį (pavadintą thunderphone-production-<org>-outbound-<id>) ir per ją atlieka išeinančius skambučius, todėl Telnyx šiuos skambučius apmokestina jums. Naudojamas Telnyx jungties, prie kurios priskirti jūsų numeriai, išeinančių balso skambučių profilis, todėl taikomos to profilio leidžiamos šalys ir išlaidų limitai. Jei ši jungtis neturi išeinančių balso skambučių profilio, o jūsų paskyroje yra tik vienas įjungtas profilis, ThunderPhone naudoja jį. Norėdami naudoti kitą profilį, priskirkite jį jungčiai Telnyx portale ir dar kartą išsaugokite ThunderPhone jungtį. Jei paskyroje nėra įjungtų profilių arba jų yra keli, priskirkite vieną jungčiai Telnyx portale ir dar kartą išsaugokite ThunderPhone jungtį. Iki tol išeinantys skambučiai nepavyks ir bus pateikta klaida outbound_trunk_unavailable; įeinantys skambučiai veiks toliau.

Kai Telnyx atmeta išeinantį skambutį (pavyzdžiui, SIP 403 Forbidden), atmetimas gaunamas iš jūsų Telnyx paskyros. Įprastos priežastys yra nepakankamas turimas kreditas, skambinančiojo numeris, nepriklausantis tai Telnyx paskyrai, arba išeinančių balso skambučių profilis, neleidžiantis skambinti į paskirties šalį.

SignalWire, Vonage ir Plivo SIP sąranka#

Šie trys teikėjai atidaro rankinę SIP formą, kurioje viršuje pateikiami to teikėjo veiksmai, nuoroda į paties teikėjo sąrankos vadovą ir SIP domeno pavyzdys:

• SignalWire: sukurkite SIP prisijungimo duomenis išeinantiems skambučiams, įveskite SIP domeną, naudotojo vardą ir slaptažodį bei kiekvienam numeriui priskirkite SWML scenarijų, kuris sujungia įeinančius skambučius su ThunderPhone SIP galiniu tašku.
• Vonage: SIP magistralių valdymo skydelyje sukurkite magistralę su išeinančių skambučių prisijungimo duomenimis, įveskite jos domeną (pavyzdžiui, your-trunk.sip-us.vonage.com) ir prisijungimo duomenis, pridėkite ThunderPhone SIP galinį tašką kaip magistralės įeinančių skambučių SIP URI ir susiekite savo numerius su magistrale.
• Plivo: sukurkite išeinančių skambučių magistralę su prisijungimo duomenimis ir įveskite jos Termination SIP Domain (<trunk-id>.zt.plivo.com), naudotojo vardą ir slaptažodį; sukurkite įeinančių skambučių magistralę, kurios Primary URI yra ThunderPhone SIP galinis taškas, po kurio nurodyta ;transport=tcp; tada kiekvieno numerio Application Type nustatykite į tą magistralę.

Rezultatas yra rankinė SIP jungtis (provider: "manual" API), išbandyta ir patikrinta lygiai taip pat kaip ranka įvesta jungtis. Jungties kortelėje rodomas teikėjo pavadinimas, pavyzdžiui, SignalWire · SIP.

Sukurkite naują Telnyx paskyrą#

Dar neturite teikėjo? Vedamas procesas padės jums atidaryti Telnyx paskyrą ir ją prijungti:

1. Sukurkite paskyrą

   Spustelėkite Atidaryti Telnyx registraciją, sukurkite savo paskyrą ir pažymėkite „Sukūriau savo paskyrą“.

2. Gaukite API raktą

   Spustelėkite Atidaryti API raktų puslapį, sugeneruokite raktą ir įklijuokite jį į API raktas (v2). Pasirinktinai suteikite ryšiui pavadinimą.

3. Prijunkite ir išbandykite

   Spustelėkite Prijungti ir išbandyti — ThunderPhone patikrina prisijungimo duomenis ir prieš išsaugodamas paruošia tai, ko reikia Telnyx pusėje.

Ką ThunderPhone nustato sistemoje Telnyx#

Jei neįvedate savo ryšio ID, abu Telnyx būdai (vedlys nustatymas ir API rakto įklijavimas) jūsų Telnyx paskyroje palieka tą patį: vieną SIP ryšį, pavadintą thunderphone-<your organization id>. Tai yra FQDN ryšys, kurio FQDN įrašas nukreipia į ThunderPhone SIP galinį tašką, ir kiekvienas importuojamas numeris jam priskiriamas. Telnyx šių numerių skambučius per SIP tiesiogiai siunčia į ThunderPhone.

• Jo saityno kabliukų laukai sąmoningai paliekami tušti. Nenaudojamas joks saityno kabliukas, Call Control programa, TeXML programa ar užregistruotas SIP telefonas.
• Neperkelkite importuotų numerių į kitą ryšį ar programą ir neregistruokite įrenginio šiame ryšyje.
• Jei jungdami įvedėte savo ryšio ID, ThunderPhone vietoj jo naudoja šį ryšį ir jo niekada nekeičia; tai turi būti FQDN ryšys, nukreiptas į ThunderPhone SIP galinį tašką.

Iki 2026 m. rugpjūčio 30 d. ThunderPhone sukurtas thunderphone-… ryšys buvo kredencialų ryšys, kuris negali priimti skambučių. Jei jūsų ryšys vis dar rodomas kaip kredencialų ryšys, susisiekite su palaikymo komanda ir mes jį pakeisime.

Rankinė SIP konfigūracija#

SignalWire, Vonage ir Plivo kortelėse atidaroma ši forma, taip pat ir pasirinkus Nustatymus įvesiu rankiniu būdu skiltyje Kitas teikėjas. Tinka bet kuri SIP magistralė, įskaitant DIDWW arba jūsų pačių valdomą PBX. Įveskite ryšio pavadinimą, SIP domeną / URI, pasirenkamą naudotojo vardą ir slaptažodį, prievadą bei perdavimo protokolą; Išplėstiniai nustatymai prideda medijos šifravimą (SRTP). Formoje taip pat nurodomas SIP adresas, į kurį jūsų magistralė turi nukreipti įeinančius skambučius: sip.thunderphone.com, naudojant 5060 prievadą UDP arba TCP ryšiui arba 5061 TLS ryšiui. Naudojant TLS, SIP signalizavimas lieka šifruotas iki pat LiveKit Cloud, kur ThunderPhone apdoroja skambutį; garsas niekada nepraeina per sip.thunderphone.com, todėl SRTP veikia kaip ir anksčiau. Kiekvieną skambutį adresuokite surinktam E.164 formato numeriui, tą patį numerį, įskaitant +, nurodydami ir užklausos eilutėje, ir To antraštėje: pavyzdžiui, sip:+14155550142@sip.thunderphone.com. Būtent + leidžia ThunderPhone apdoroti skambutį tinkamame regione (žr. pastabą skiltyje IP leidžiamųjų sąrašas). Anksčiau sukonfigūruotos magistralės su <your-project>.sip.livekit.cloud adresu veikia toliau, kol Leidžiami šaltinio IP adresai laukas yra tuščias; jų keisti nereikia. ThunderPhone šiuos nustatymus LiveKit Cloud paverčia specialia SIP magistralių pora: išeinantys skambučiai iš ryšio numerių nukreipiami į jūsų SIP domeną naudojant jūsų prisijungimo duomenis, o įeinantys skambučiai į tuos numerius priimami iš bet kurio adreso, nebent užpildote pasirenkamą lauką Leidžiami šaltinio IP adresai. Pildykite jį tik tuo atveju, jei jūsų ryšio teikėjas skelbia fiksuotus signalizavimo IP adresus: dėl neteisingo ar nepilno sąrašo ThunderPhone atmes jūsų ryšio teikėjo įeinančius skambučius. Du mygtukai atlieka pagrindinį darbą:

• Generuoti DI sąrankos vadovą — sukuria konkrečiam paslaugų teikėjui skirtas instrukcijas, reikalingas magistralės pusės konfigūracijai.
• Išbandyti ir išsaugoti ryšį — patikrina, ar SIP galinis taškas išsprendžiamas į viešą adresą ir, naudojant TCP/TLS, priima ryšį pasirinktame prievade (UDP prieglobos įrenginiams atliekamas tik DNS patikrinimas), tada išsaugo. Skambučio dar negalima atlikti, nes ryšys neturi numerių; tikrasis patvirtinimas gaunamas importavimo metu (toliau).

Vėliau redaguojant ryšį, prieš išsaugant bet kokius duomenis tas pats patikrinimas iš naujo atliekamas su pakeistais nustatymais, tada magistralė sukuriama iš naujo ir kiekvienas ryšio numeris dar kartą patikrinamas trumpu bandomuoju skambučiu fone — numeriai rodomi kaip Ruošiama, kol jų bandomasis skambutis pavyksta. Tik Leidžiamų šaltinio IP adresų pakeitimas Prisijungta būsenoje esančiame ryšyje yra kitoks: jis niekada neturi įtakos išeinantiems skambučiams, todėl ThunderPhone iš karto atnaujina sąrašą įeinančių skambučių magistralėje, o numeriai lieka Aktyvūs. Jų įeinančių skambučių testo būsena nustatoma iš naujo į netestuota; paleiskite jį dar kartą arba skambinkite realų skambutį per savo ryšio teikėją, kad patvirtintumėte, jog naujasis sąrašas leidžia skambučius. Testas nepavyksta, jei jo skambutis pagal sąrašą būtų atmestas. Išsaugoti slaptažodžiai niekada nerodomi; palikite slaptažodžio lauką tuščią, kad jį išsaugotumėte, arba pažymėkite „Pašalinti išsaugotą slaptažodį“, jei naudojate IP autentifikavimą turinčią magistralę.

IP adresų įtraukimas į leidžiamųjų sąrašą ir magistralės autentifikavimas#

Kai kurie ryšio paslaugų teikėjai (DIDWW, „Telnyx“ IP autentifikavimo ryšiai, dauguma už užkardos esančių PBX sistemų) priima SIP srautą tik iš adresų, kuriuos įtraukiate į leidžiamų adresų sąrašą, arba autentifikuoja siunčiamus skambučius pagal šaltinio IP adresą. ThunderPhone naudoja du adresų rinkinius.

SIP kraštinis mazgas. Įeinantys skambučiai, kuriuos siunčiate į sip.thunderphone.com, eina per ThunderPhone SIP kraštinį mazgą, kuris perduoda tik SIP signalizaciją. Pirmasis INVITE siunčiamas į sip.thunderphone.com; likusi skambučio signalizacija (ACK, skambučio nutraukimas, peradresavimai) vyksta tarp jūsų ryšio paslaugų teikėjo ir skambutį priėmusio kraštinio serverio, sip-1 arba sip-2. Jei jūsų užkarda filtruoja SIP signalizaciją, leiskite visus tris adresus per UDP ir TCP 5060 prievadą bei TLS 5061 prievadą:

LiveKit Cloud. Kiekvieno skambučio garso duomenys (RTP) ir siunčiamų skambučių SIP signalizacija vyksta tarp jūsų ryšio paslaugų teikėjo ir LiveKit Cloud, niekada ne per SIP kraštinį mazgą. Leiskite visus toliau nurodytus diapazonus tiek SIP signalizacijai, tiek medijai:

LiveKit šiuos diapazonus taiko „Realtime“, SIP signalizacijai, medijai ir žiniatinklio kabliams, jie apima skambučius, tvarkomus jos Kanados, ES, Indijos, Japonijos ir JAV regionuose. Fiksuoto galinio taško regionų pavadinimai: canada, eu, india, japan, us.

Keletas praktinių taisyklių pačiai magistralei:

• ThunderPhone nesiregistruoja. Jis niekada nesiunčia SIP REGISTER jūsų ryšio paslaugų teikėjui, todėl sukonfigūruokite magistralę IP pagrindu ir (arba) prisijungimo duomenimis (naudotojo vardu + slaptažodžiu) grindžiamam autentifikavimui, o ne registracijai.
• Siunčiamiems skambučiams turėtų būti naudojami prisijungimo duomenys. Ryšio paslaugų teikėjo pusėje įjunkite autentifikavimą naudotojo vardu ir slaptažodžiu ir rankinėje SIP formoje įveskite tas pačias reikšmes. Leidžiamų IP adresų sąrašą laikykite antru sluoksniu, o ne vieninteliu — siunčiami skambučiai į paskirties vietas už aprėpiamų regionų ribų gali būti vykdomi iš kitų adresų.
• Įeinantys skambučiai vyksta priešinga kryptimi. Pasirinktinis formos laukas Leidžiami šaltinio IP adresai skirtas įvesti jūsų ryšio paslaugų teikėjo signalizacijos adresus, kad ThunderPhone priimtų skambučius tik iš jų. Įveskite IP adresus arba CIDR diapazonus; kompiuterių vardai niekada neatitinka. Palikite šį lauką tuščią, nebent jūsų ryšio paslaugų teikėjas skelbia fiksuotą sąrašą. ThunderPhone tikrina sąrašą kiekvieno įeinančio skambučio metu pagal adresą, kurį mato jo SIP kraštinis mazgas, todėl nustatę sąrašą siųskite skambučius į sip.thunderphone.com. Skambutis iš sąraše nesančio adreso arba tiesiogiai į <your-project>.sip.livekit.cloud adresą siunčiamas skambutis atmetamas: jis nepavyksta arba prisijungia ir iškart baigiamas.

Diapazonus LiveKit skelbia puslapyje Regionai, regioniniai galiniai taškai ir statiniai IP adresai; ThunderPhone šį puslapį tikrina kas savaitę ir atnaujina šį vadovą, kai jis pasikeičia.

Po prijungimo#

Importuokite numerius iš Telefono numeriai → Pridėti numerį → Prijungti VoIP tiekėją (arba tiesiai iš ryšio). Kiekvienas importuotas numeris patvirtinamas prieš jį suaktyvinant. Naudojant rankinį SIP ryšį, šio patvirtinimo metu atliekamas trumpas (kelių sekundžių) bandomasis skambutis iš jūsų numerio per jūsų SIP magistralę į ThunderPhone numerį — taip realiai patikrinami naudotojo vardas, slaptažodis, transportas ir jūsų tiekėjo išeinančių skambučių maršrutizavimas. Jūsų tiekėjas už šį skambutį skaičiuoja mokestį kaip už bet kurį kitą. Jei tiekėjas jį atmeta, numerio būsena lieka Ruošiamas, o telefono numerių puslapyje rodomas tiekėjo atsakymas (pvz., „atmetė ThunderPhone prisijungimo duomenis (SIP 401)“); ištaisykite ryšį ir patvirtinkite dar kartą. Jei jūsų tiekėjas priima magistralę, tačiau jo maršrutizavimo planas neapima ThunderPhone bandomojo numerio (DIDWW atsako „Paskirties numeris įtrauktas į maršrutizavimo plano juodąjį sąrašą“), numerio būsena rodoma kaip Patvirtintas · tiekėjas priėmė: juo galima naudotis, tačiau skambučiai į kitas paskirties vietas nebuvo išbandyti. Šis skambutis įrodo, kad jūsų magistralė gali inicijuoti skambučius naudojant šį numerį; jis neįrodo, kad jums priklauso numeris, ir netikrina skambučių į numerį; tai patikrina toliau pateiktas pasirenkamas įeinančių skambučių testas. Patvirtinti numeriai palaiko įeinančius ir išeinančius skambučius — tai įgalina išeinančių skambučių kampanijas ir programinius išeinančius skambučius.

Įeinančio skambučio testas#

Patvirtinti numerį atidaro dialogo langą, kuriame taip pat galima testuoti įeinančius skambučius. Testas paskambina į jūsų numerį, patikrina, ar skambutis pasiekia ThunderPhone, tada jį nutraukia nepaleidęs jūsų agento:

• Numeriai su savo išeinančiąja SIP magistrale (rankiniu būdu pridėti SIP numeriai ir Twilio numeriai, kai ThunderPhone jūsų Twilio paskyroje nustato išeinančius skambučius) pirmiausia skambina patys sau: ThunderPhone skambina į numerį iš to paties numerio per tą magistralę. Dialogo langas jus apie tai informuoja prieš skambinant. Skambutis siunčiamas per jūsų ryšio tiekėją ir, jei įeinančių skambučių maršrutizavimas nustatytas teisingai, tiesiogiai grįžta į ThunderPhone. Kai jis grįžta su paties numerio skambinančiojo ID, vienas skambutis patvirtina ir tai, kad jūsų ryšio tiekėjas priima ThunderPhone skambučius su šiuo numeriu, ir tai, kad skambučiai į numerį pasiekia ThunderPhone bet kurioje šalyje. Kai kurie ryšio tiekėjai atsisako leisti arba nesujungia skambučio iš numerio į tą patį numerį; tai nieko nereiškia apie jūsų maršrutizavimą, todėl ThunderPhone tada skambina iš vieno savo numerių. Jei jūsų numeris peradresuojamas kitur, tas telefonas gali skambėti du kartus: pirmą kartą rodydamas paties numerio skambinančiojo ID, paskui ThunderPhone testo numerį.
• Kitiems numeriams (ir naudojant pirmiau nurodytą atsarginį būdą) skambinama iš vieno ThunderPhone numerių. Kol kas ThunderPhone gali skambinti tik į JAV ir Kanados numerius; kitų numerių atveju testas nurodo, kad jo nepavyko atlikti, ir pateikia jūsų ryšio tiekėjo atsakymą, jei skambutis į save buvo atmestas.

Jei jūsų ryšio tiekėjas pakeliui pakeičia skambinančiojo ID, ThunderPhone negali atpažinti skambučio, todėl jūsų agentas gali trumpam į jį atsiliepti. Įeinančių skambučių testas yra pasirenkamas. Praleiskite jį, ir numeris vis tiek veiks; numerių puslapyje tada bus rodoma Įeinantieji netestuoti, o vėliau galėsite jį atlikti naudodami Testuoti arba numerio meniu punktą Testuoti įeinančius skambučius. Iškart po importavimo numerių puslapyje taip pat prašoma testuoti naujų numerių įeinančius skambučius. Kol nepatvirtinate dialogo lange, neskambinama.

Jei jūsų tiekėjas siunčia numerį kitur, tai, į ką jis nukreiptas, gali skambėti iki 8 sekundžių per skambutį, kol ThunderPhone jį nutrauks. Jei kas nors atsiliepia pirmiau (Twilio programa, kuri atsiliepia ir tada peradresuoja, telefono meniu), testas laukia, kol peradresuotas skambutis pasieks ThunderPhone: iki 8 sekundžių skambučio į save atveju ir 15 sekundžių skambinant iš ThunderPhone numerio. Rezultatas lieka prie numerio (Įeinantieji sėkmingai patikrinti arba nepavyko patikrinti), kol nepakeičiate ryšio arba pakartotinai neimportuojate numerio; tada jis grąžinamas į būseną netestuota. Pakeitus ryšį, išeinantys skambučiai fone patvirtinami iš naujo, tačiau į jūsų numerį niekada neskambinama be jūsų prašymo.

Įeinančių skambučių trikčių šalinimas#

Ryšio mygtukas Testas patikrina prisijungimo duomenis, o patikra patikrina išeinantį rinkimą. Norėdami patikrinti įeinančius skambučius, paleiskite pirmiau pateiktą įeinančio skambučio testą arba paskambinkite numeriu iš telefono ir ieškokite skambučio skiltyje Skambučių istorija. Naršyklės Pokalbio testai ir balso agentų tarpusavio simuliacijos nevyksta per jūsų ryšio teikėją, todėl jie neparodo, ar veikia įeinantys skambučiai. Simuliacija, nukreipta į telefono numerį (SIP atgalinis ryšys), jį surenka per jūsų ryšio teikėją, todėl į ją atsiliepus patikrinamas įeinančių skambučių maršrutizavimas.

• Girdite savo mobiliojo ryšio teikėjo pranešimą (pavyzdžiui, „Sveiki atvykę į Verizon“ arba „Jūsų surinktas numeris neveikia“): skambutis nepavyko, kol nepasiekė ThunderPhone. Patikrinkite, ar numeris yra aktyvus jūsų teikėjo paskyroje ir priskirtas ThunderPhone ryšiui arba magistralei.
• Užimtos linijos signalas arba skambutis skamba, bet neatsiliepiama: teikėjas priėmė skambutį, bet negalėjo jo pristatyti. Jei naudojate Telnyx, patikrinkite numerio Ryšį Telnyx portale: tai turėtų būti pirmiau aprašytas thunderphone-… FQDN ryšys arba jūsų FQDN ryšys, nukreiptas į ThunderPhone SIP galinį tašką. Jei naudojate Twilio, numeris turėtų būti prijungtas prie ThunderPhone SIP magistralės, o ne prie Voice webhook ar TwiML programos.
• Jūsų teikėjo žurnaluose rodoma 404 No trunk found (rankinis SIP): skambutis pasiekė ThunderPhone, bet neatitiko jokios magistralės. Patikrinkite, ar numeris importuotas į šį ryšį ir ar magistralė nukreipta į sip.thunderphone.com. Jei ji nukreipta į <your-project>.sip.livekit.cloud adresą, Leidžiami šaltinio IP adresai turi būti tušti: nustačius sąrašą, priimami tik skambučiai, siunčiami į sip.thunderphone.com.
• 404 Not Found iš sip.thunderphone.com (rankinis SIP): skambutis nebuvo adresuotas telefono numeriui arba užklausos eilutėje ir To antraštėje nurodyti skirtingi numeriai. Abiejuose nurodykite surinktą numerį, kaip pateikta aukščiau.
• 403 Forbidden iš sip.thunderphone.com: užklausos eilutėje nurodytas kitas pagrindinis kompiuteris. Adresuokite skambutį į sip.thunderphone.com, pavyzdžiui, sip:+14155550142@sip.thunderphone.com.
• Skambutis pasiekia ThunderPhone, bet atsiliepia netinkamas agentas arba niekas neatsiliepia: patikrinkite numerio įeinančių skambučių agentą skiltyje Telefono numeriai.

Programėlėje integruotas kopilotas gali patikrinti numerį už jus: paklauskite jo, kodėl skambučiai į numerį nepavyksta. Telnyx ryšiams jis taip pat tik skaitymo režimu ir tik organizacijos administratoriams nustato, kuriam ryšiui Telnyx priskiria numerį.

Tolesni veiksmai#