Open in
Povežite VoIP pružatelja usluga
Povežite pružatelja usluga kojeg već koristite (Twilio ili Telnyx putem API ključa; SignalWire, Vonage, Plivo ili bilo koji SIP trunk putem SIP-a) ili otvorite novi Telnyx račun uz vođeno postavljanje.
Produkcijski promet trebao bi se odvijati putem brojeva koje posjedujete, preko vlastitog VoIP pružatelja usluga. Stranica nadzorne ploče Povezivanja → VoIP (/dashboard/voip-connections) povezuje račun vašeg pružatelja; nakon povezivanja uvozite brojeve koji podržavaju dolazne i odlazne pozive.
Kliknite Nova veza i odaberite jednu od dvije mogućnosti: Povežite pružatelja usluga kojeg već koristite ili Postavite novi Telnyx račun.
Povežite pružatelja kojeg već koristite
Odaberite pružatelja kod kojeg su vaši brojevi:
| Pružatelj | Način povezivanja |
|---|---|
| Twilio | API ključ: zalijepite svoj SID računa i autentifikacijski token |
| Telnyx | API ključ: zalijepite svoj v2 API ključ |
| SignalWire | SIP konfiguracija |
| Vonage | SIP konfiguracija |
| Plivo | SIP konfiguracija |
| Drugi pružatelj | SIP konfiguracija s ThunderPhoneovim pomoćnikom za konfiguraciju, za bilo kojeg drugog pružatelja usluga ili PBX kojim upravljate |
Za Twilio i Telnyx zalijepite vjerodajnice i kliknite Povežite i
testirajte. ThunderPhone ih provjerava i konfigurira stranu pružatelja
umjesto vas.
Za Telnyx ThunderPhone dodaje vlastitu SIP vezu na vaš Telnyx račun
(nazvanu thunderphone-production-<org>-outbound-<id>) i preko nje upućuje
odlazne pozive, pa vam Telnyx naplaćuje te pozive. Koristi profil za
odlazne glasovne pozive Telnyx veze na kojoj su vaši brojevi, pa se
primjenjuju dopuštene države i ograničenja potrošnje tog profila. Ako ta
veza nema profil za odlazne glasovne pozive, a vaš račun ima točno jedan
omogućeni profil, ThunderPhone koristi taj profil. Da biste upotrijebili
drugi, dodijelite ga vezi na portalu Telnyx i ponovno spremite ThunderPhone
vezu. Ako račun nema nijedan omogućeni profil,
ili ih ima više, dodijelite jedan vezi na portalu Telnyx i ponovno spremite
ThunderPhone vezu. Do tada odlazni pozivi ne uspijevaju uz
outbound_trunk_unavailable; dolazni pozivi i dalje rade.
Kada Telnyx odbije odlazni poziv (na primjer SIP 403 Forbidden), odbijanje dolazi s vašeg vlastitog Telnyx računa. Uobičajeni uzroci su nedostupan kredit, broj pozivatelja koji nije na tom Telnyx računu ili profil za odlazne glasovne pozive koji ne dopušta odredišnu državu.
SIP konfiguracija za SignalWire, Vonage i Plivo
Ova tri pružatelja otvaraju obrazac za ručnu SIP konfiguraciju s koracima za tog pružatelja na vrhu, poveznicom na vlastiti vodič za konfiguraciju pružatelja i primjerom SIP domene:
- SignalWire: izradite SIP vjerodajnice za odlazne pozive, unesite SIP domenu, korisničko ime i lozinku te svakom broju dodijelite SWML skriptu koja povezuje dolazne pozive s ThunderPhone SIP krajnjom točkom.
- Vonage: na nadzornoj ploči SIP Trunking izradite trunk s
vjerodajnicama za odlazne pozive, unesite njegovu domenu (na primjer
your-trunk.sip-us.vonage.com) i vjerodajnice, dodajte ThunderPhone SIP krajnju točku kao ulazni SIP URI trunka i povežite svoje brojeve s trunkom. - Plivo: izradite odlazni trunk s vjerodajnicom i unesite njegovu
Termination SIP Domain (
<trunk-id>.zt.plivo.com), korisničko ime i lozinku; izradite ulazni trunk čiji je Primary URI ThunderPhone SIP krajnja točka iza koje slijedi;transport=tcp; zatim za svaki broj postavite Application Type na taj trunk.
Rezultat je ručna SIP veza (provider: "manual" u
API-ju), testirana i provjerena jednako kao ručno unesena veza. Kartica
veze prikazuje naziv pružatelja, na primjer
SignalWire · SIP.
Postavite novi Telnyx račun
Još nemate pružatelja usluge? Vođeni postupak vodi vas kroz otvaranje Telnyx računa i njegovo povezivanje:
- Izradite račun
Kliknite Otvorite registraciju za Telnyx, izradite račun i označite "Izradio/la sam račun."
- Dohvatite API ključ
Kliknite Otvorite stranicu API ključeva, generirajte ključ i zalijepite ga u API ključ (v2). Po želji imenujte povezivanje.
- Povežite i testirajte
Kliknite Povežite i testirajte — ThunderPhone provjerava vjerodajnice i na Telnyxovoj strani postavlja što mu je potrebno prije spremanja.
Što ThunderPhone postavlja u Telnyxu
Ako ne unesete vlastiti ID veze, oba Telnyxova načina (vođeno
postavljanje i lijepljenje API ključa) ostavljaju istu stvar na vašem
Telnyx računu: jednu SIP vezu pod nazivom
thunderphone-<your organization id>. To je FQDN veza
čiji FQDN zapis upućuje na ThunderPhoneov SIP krajnji punkt, a svaki
broj koji uvezete dodjeljuje se toj vezi. Telnyx pozive za te
brojeve šalje izravno ThunderPhoneu putem SIP-a.
- Polja za webhook namjerno su prazna. Ne upotrebljavaju se webhook, aplikacija Call Control, aplikacija TeXML ni registrirani SIP telefon.
- Nemojte premještati uvezene brojeve na drugu vezu ili aplikaciju i nemojte registrirati uređaj na njoj.
- Ako ste pri povezivanju unijeli vlastiti ID veze, ThunderPhone umjesto toga upotrebljava tu vezu i nikad je ne mijenja; mora biti FQDN veza koja upućuje na ThunderPhoneov SIP krajnji punkt.
Prije 30. kolovoza 2026. veza thunderphone-… koju je ThunderPhone
stvarao bila je veza s vjerodajnicama, koja ne može primati pozive.
Ako se vaša i dalje prikazuje kao veza s vjerodajnicama, obratite se
podršci i pretvorit ćemo je.
Ručna SIP konfiguracija
Pločice SignalWire, Vonage i Plivo otvaraju ovaj obrazac, kao i
Sve ću postavke unijeti samostalno u odjeljku Drugi pružatelj usluga. Funkcionira bilo koji SIP trunk, uključujući DIDWW ili PBX koji sami pokrećete.
Unesite naziv veze, SIP domenu / URI,
neobavezno korisničko ime i lozinku, priključak i prijenos; Napredne
postavke dodaju šifriranje medija (SRTP). Obrazac prikazuje i SIP
adresu na koju Vaš trunk mora slati dolazne pozive: sip.thunderphone.com,
na priključku 5060 za UDP ili TCP odnosno 5061 za TLS. Putem TLS-a SIP
signalizacija ostaje šifrirana sve do LiveKit Clouda, gdje
ThunderPhone obrađuje poziv; zvuk nikada ne prolazi kroz
sip.thunderphone.com, pa SRTP funkcionira kao i prije. Svaki poziv adresirajte na
birani broj u formatu E.164, s istim brojem, uključujući
+, u retku zahtjeva i zaglavlju To: na primjer
sip:+14155550142@sip.thunderphone.com. Znak + omogućuje
ThunderPhoneu obradu poziva u ispravnoj regiji (pogledajte napomenu u odjeljku
IP popis dopuštenih adresa).
Trunkovi prethodno postavljeni s adresom <your-project>.sip.livekit.cloud
nastavljaju raditi dok je Dopuštene izvorne IP adrese prazno; ne morate
ih mijenjati. ThunderPhone
pretvara te postavke u namjenski par SIP trunkova na LiveKit
Cloudu: odlazni pozivi
s brojeva veze usmjeravaju se na Vašu SIP domenu s Vašim
vjerodajnicama, a dolazni pozivi na te brojeve prihvaćaju se sa svake
adrese, osim ako ispunite neobavezno polje Dopuštene izvorne IP adrese.
Ispunite ga samo ako Vaš pružatelj usluga objavljuje fiksne IP adrese za signalizaciju: netočan
ili nepotpun popis uzrokuje da ThunderPhone odbije dolazne pozive Vašeg pružatelja usluga. Dva gumba obavljaju glavni posao:
- Generirajte vodič za postavljanje AI-ja — stvara upute specifične za pružatelja usluge za potrebnu konfiguraciju na strani trunka.
- Testirajte i spremite vezu — provjerava razrješava li se SIP krajnja točka na javnu adresu i, za TCP/TLS, prihvaća li vezu na odabranom portu (UDP hostovi dobivaju samo DNS provjeru), zatim sprema. Još ne može uputiti poziv jer veza nema brojeve; stvarna potvrda dolazi pri uvozu (u nastavku).
Kasnije uređivanje veze ponovno pokreće istu provjeru promijenjenih postavki prije spremanja, zatim ponovno izgrađuje trunk i ponovno provjerava svaki broj na vezi kratkim testnim pozivom u pozadini — brojevi se prikazuju kao Priprema dok njihov testni poziv ne uspije. Promjena samo postavke Dopuštene izvorne IP adrese na Povezanoj vezi razlikuje se: nikada ne utječe na odlazne pozive, pa ThunderPhone odmah ažurira popis na dolaznom trunku, a brojevi ostaju Aktivni. Test dolaznog poziva vraća se na stanje nije testirano; ponovno ga pokrenite ili uputite stvarni poziv putem svojeg pružatelja usluga kako biste potvrdili da novi popis propušta pozive. Test ne uspijeva kada bi njegov poziv bio odbijen prema popisu. Spremljene lozinke nikada se ponovno ne prikazuju; ostavite polje lozinke praznim kako biste je zadržali ili označite "Ukloni spremljenu lozinku" za trunk s IP autentifikacijom.
Dopuštanje IP adresa i autentifikacija trunka
Neki pružatelji usluga (DIDWW, Telnyx veze s IP autentifikacijom, većina PBX-ova iza vatrozida) prihvaćaju SIP promet samo s adresa koje ste dodali na popis dopuštenih ili autentificiraju odlazne pozive prema izvornoj IP adresi. ThunderPhone koristi dva skupa adresa.
SIP rub. Dolazni pozivi koje šaljete na sip.thunderphone.com prolaze
kroz ThunderPhoneov SIP rub, koji prenosi samo SIP signalizaciju. Prvi
INVITE ide na sip.thunderphone.com; ostatak signalizacije poziva
(ACK, prekid, preusmjeravanja) odvija se između vašeg pružatelja usluga i
rubnog poslužitelja koji je prihvatio poziv, sip-1 ili sip-2. Ako vaš
vatrozid filtrira SIP signalizaciju, dopustite sva tri poslužitelja na UDP i TCP
portu 5060 te TLS portu 5061:
| Poslužitelj | IP adresa |
|---|---|
sip.thunderphone.com | 172.170.39.202 |
sip-1.thunderphone.com | 13.86.104.121 |
sip-2.thunderphone.com | 20.80.98.90 |
LiveKit Cloud. Zvuk (RTP) svakog poziva i SIP signalizacija odlaznih poziva odvijaju se između vašeg pružatelja usluga i LiveKit Clouda, nikada preko SIP ruba. Dopustite svaki raspon u nastavku, za SIP signalizaciju i medije:
| Raspon IP adresa |
|---|
143.223.88.0/21 |
161.115.160.0/19 |
153.57.128.0/18 |
LiveKit primjenjuje ove raspone na Realtime, SIP signalizaciju i medije te webhookove, a oni pokrivaju pozive obrađene u njegovim regijama Kanada, EU, Indija, Japan i SAD. Nazivi regija za fiksiranu krajnju točku: canada, eu, india, japan, us.
Nekoliko praktičnih pravila za sam trunk:
- ThunderPhone se ne registrira. Nikada ne šalje SIP
REGISTERvašem pružatelju usluga, zato konfigurirajte trunk za autentifikaciju na temelju IP adrese i/ili vjerodajnica (korisničko ime + lozinka), a ne za registraciju. - Odlazni pozivi trebaju koristiti vjerodajnice. Omogućite autentifikaciju korisničkim imenom/lozinkom na strani pružatelja usluga i unesite iste vrijednosti u ručni SIP obrazac. Popis dopuštenih IP adresa tretirajte kao drugi sloj, a ne kao jedini — odlazni pozivi prema odredištima izvan obuhvaćenih regija mogu potjecati s drugih adresa.
- Dolazni promet ide u suprotnom smjeru. Neobavezno polje Dopuštene izvorne
IP adrese u obrascu mjesto je na koje unosite signalizacijske
adrese svojeg pružatelja usluga kako bi ThunderPhone prihvaćao pozive samo s njih. Unesite IP
adrese ili CIDR raspone; nazivi hostova nikada se ne podudaraju. Ostavite polje praznim
osim ako vaš pružatelj usluga objavljuje fiksni popis. ThunderPhone provjerava
popis za svaki dolazni poziv prema adresi koju vidi njegov SIP rub, stoga,
nakon što postavite popis, šaljite pozive na
sip.thunderphone.com. Poziv s adrese koja nije na popisu ili poziv poslan izravno na adresu<your-project>.sip.livekit.cloudodbija se: ne uspije ili se uspostavi pa se odmah prekine.
Raspone objavljuje LiveKit na stranici Regije, regionalne krajnje točke i statične IP adrese; ThunderPhone tu stranicu provjerava tjedno i ažurira ovaj vodič kada se promijeni.
Nakon povezivanja
Uvezite brojeve iz Brojevi telefona → Dodajte broj → Povežite VoIP pružatelja usluga (ili izravno iz veze). Svaki uvezeni broj potvrđuje se prije aktivacije. Za ručnu SIP vezu ta potvrda upućuje kratki (nekoliko sekundi) testni poziv s vašeg broja, preko vašeg SIP trunka, na ThunderPhone broj — tako se stvarno provjeravaju korisničko ime, lozinka, prijenos i izlazno usmjeravanje vašeg pružatelja usluga. Vaš pružatelj usluga taj poziv naplaćuje kao i svaki drugi. Ako ga pružatelj usluga odbije, broj ostaje u stanju Dodjeljivanje, a stranica s telefonskim brojevima prikazuje odgovor pružatelja usluga (na primjer „odbijene su vjerodajnice za ThunderPhone (SIP 401)“); ispravite vezu i ponovno potvrdite broj. Ako vaš pružatelj usluga prihvati trunk, ali njegov plan usmjeravanja ne obuhvaća ThunderPhone testni broj (DIDWW odgovara „odredišni broj na crnoj listi plana usmjeravanja“), broj se prikazuje kao Potvrđeno · pružatelj usluga prihvatio: može se koristiti, ali pozivi na druga odredišta nisu testirani. Taj poziv dokazuje da vaš trunk može upućivati pozive s tog broja; nije dokaz da ste vlasnik broja i ne testira pozive na taj broj; to čini neobavezni test dolaznih poziva u nastavku.
Ručni SIP brojevi izvan SAD-a i Kanade potvrđuju se drugačije: broj zove sam sebe preko vašeg SIP trunka. To je domaći poziv, pa se trunk kojem su blokirani međunarodni pozivi i dalje može potvrditi. Ako vaše dolazno usmjeravanje upućuje na ThunderPhone, poziv se odmah vraća, a ThunderPhone ga prekida prije nego što se na njega odgovori; taj jedan poziv dokazuje da pozivi rade u oba smjera, a test dolaznih poziva za broj također se bilježi kao položen. Ako pozivi tog broja idu nekamo drugdje, taj telefon može zvoniti do 25 sekundi; ako se netko javi, odlazni pozivi i dalje se smatraju potvrđenima. Ako vaš pružatelj usluga odbije poziv broja samom sebi na način koji ne govori ništa o vašem računu (zauzeto, nema rute do broja, nema odgovora), ThunderPhone umjesto toga zove vlastiti testni broj. Odbijanje koje slijedi nakon duže stanke obično znači da je vaš pružatelj najprije reproducirao snimljenu poruku, primjerice o nedostatku kredita ili blokiranom odredištu; razlog to navodi. Potvrđeni brojevi podržavaju dolazne i odlazne pozive — što omogućuje odlazne kampanje i programske odlazne pozive).
Test dolaznog poziva
Provjerite broj otvara dijalog koji može testirati i dolazne pozive. Test upućuje poziv na vaš broj, provjerava stiže li poziv do ThunderPhonea, a zatim prekida poziv bez pokretanja vašeg agenta:
- Brojevi s vlastitim odlaznim SIP trunkom (ručno dodani SIP brojevi i Twilio brojevi nakon što ThunderPhone postavi odlazno pozivanje na vašem Twilio računu) najprije pozivaju sami sebe: ThunderPhone bira broj s tog broja putem tog trunka. Dijaloški okvir vas obavještava prije upućivanja poziva. Poziv odlazi putem vašeg operatera i, ako je vaše dolazno usmjeravanje ispravno, vraća se izravno u ThunderPhone. Kada se vrati s vlastitim ID-om pozivatelja broja, taj jedan poziv dokazuje i da vaš operater prihvaća ThunderPhoneove pozive s tog broja i da pozivi na taj broj stižu u ThunderPhone, u bilo kojoj zemlji. Neki operateri odbijaju ili ne povezuju poziv s broja na njega samog; to ne govori ništa o vašem usmjeravanju, pa ThunderPhone tada umjesto toga poziva s jednog od svojih brojeva. Ako vaš broj preusmjerava na drugo mjesto, taj telefon može zazvoniti dvaput: najprije s vlastitim ID-om pozivatelja broja, a zatim s ThunderPhoneovim testnim brojem. Izvan SAD-a i Kanade nakon samopoziva ne može uslijediti ništa, pa telefon zvoni jednom, najviše 25 sekundi.
- Ostali brojevi (i prethodna zamjenska opcija) pozivaju se s jednog od ThunderPhoneovih brojeva. ThunderPhone zasad može upućivati te pozive samo na brojeve u SAD-u i Kanadi; za ostale brojeve test prijavljuje da se nije mogao pokrenuti, uz odgovor vašeg operatera ako je samopoziv odbijen.
Ako vaš operater usput promijeni identifikaciju pozivatelja, ThunderPhone ne može prepoznati poziv pa vaš agent može nakratko odgovoriti na njega. Test dolaznog poziva nije obavezan. Preskočite ga i broj će i dalje raditi; stranica telefonskih brojeva tada prikazuje Dolazni pozivi nisu testirani, a možete ga pokrenuti kasnije pomoću Testirajte ili stavke izbornika broja Testirajte dolazne pozive. Odmah nakon uvoza stranica telefonskih brojeva također traži da testirate dolazne pozive na novim brojevima. Ništa se ne bira dok ne potvrdite u dijalogu.
Ako vaš pružatelj usmjeri broj nekamo drugdje, ono na što upućuje može zvoniti do 8 sekundi po pozivu prije nego što ThunderPhone prekine poziv. Ako nešto prvo odgovori (Twilio aplikacija koja odgovori, a zatim proslijedi poziv, telefonski izbornik), test čeka da proslijeđeni poziv stigne do ThunderPhonea: do 8 sekundi za poziv broja na samog sebe i 15 sekundi za poziv s ThunderPhoneova broja. Rezultat ostaje na broju (Dolazni pozivi uspješni ili neuspješni) dok ne promijenite vezu ili ponovno uvezete broj, čime se vraća na nije testirano. Promjena veze u pozadini ponovno provjerava odlazne pozive, ali nikad ne poziva vaš broj bez vašeg zahtjeva.
Rješavanje problema s dolaznim pozivima
Gumb Test veze provjerava vjerodajnice, a provjera provjerava odlazno biranje. Da biste provjerili dolazne pozive, pokrenite test dolaznog poziva iznad ili nazovite broj s telefona i potražite poziv u Povijesti poziva. Testovi Razgovora u pregledniku i simulacije između botova ne prolaze kroz vašeg operatora, pa ne pokazuju funkcioniraju li dolazni pozivi. Simulacija usmjerena na telefonski broj (SIP povratna petlja) bira ga putem vašeg operatora, pa simulacija na koju je odgovoreno provjerava usmjeravanje dolaznih poziva.
- Čujete poruku svojeg mobilnog operatora (na primjer „Dobro došli u Verizon” ili „broj koji ste birali nije u upotrebi”): poziv nije uspio prije nego što je stigao do ThunderPhonea. Provjerite je li broj aktivan na računu vašeg pružatelja usluge i dodijeljen ThunderPhone vezi ili trunku.
- Signal zauzeća ili poziv zvoni bez odgovora: pružatelj je prihvatio poziv,
ali ga nije mogao proslijediti. Ako koristite Telnyx, provjerite
Vezu broja na portalu Telnyx: to bi trebala biti prethodno
opisana FQDN veza
thunderphone-…ili vaša vlastita FQDN veza usmjerena na ThunderPhone SIP krajnju točku. Ako koristite Twilio, broj bi trebao biti povezan s ThunderPhone SIP trunkom, a ne s Voice webhookom ili aplikacijom TwiML. - Zapisi vašeg operatora prikazuju
404 No trunk found(ručni SIP): poziv je stigao do ThunderPhonea, ali se nije podudarao ni s jednim trunkom. Provjerite je li broj uvezen u ovu vezu i je li trunk usmjeren nasip.thunderphone.com. Ako je usmjeren na adresu<your-project>.sip.livekit.cloud, Dopuštene izvorne IP adrese moraju biti prazne: ako je popis postavljen, prihvaćaju se samo pozivi poslani nasip.thunderphone.com. 404 Not Foundodsip.thunderphone.com(ručni SIP): poziv nije bio adresiran na telefonski broj ili redak zahtjeva i zaglavljeTonavode različite brojeve. Pošaljite birani broj u oba, kao što je navedeno iznad.403 Forbiddenodsip.thunderphone.com: redak zahtjeva navodi drugi host. Adresirajte poziv nasip.thunderphone.com, na primjersip:+14155550142@sip.thunderphone.com.- Poziv stiže do ThunderPhonea, ali odgovara pogrešan agent ili nitko: provjerite agenta za dolazne pozive broja u odjeljku Telefonski brojevi.
Kopilot u aplikaciji može provjeriti broj umjesto vas: pitajte ga zašto pozivi na broj ne uspijevaju. Za Telnyx veze također, samo za čitanje i za administratore organizacije, provjerava kojoj vezi Telnyx dodjeljuje broj.
Sljedeći koraci
Cjelovit postupak dodavanja broja, ThunderPhone brojevi i VoIP.
Isti postupak povezivanja, uvoza i potvrde putem REST-a.
CSV popisi, vremenski prozori za pozivanje i pravila ponovnih pokušaja.
Svako polje za veze, dokaze i uvoze.