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:

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:

1. Izradite račun

   Kliknite Otvorite registraciju za Telnyx, izradite račun i označite "Izradio/la sam račun."

2. Dohvatite API ključ

   Kliknite Otvorite stranicu API ključeva, generirajte ključ i zalijepite ga u API ključ (v2). Po želji imenujte povezivanje.

3. 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:

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:

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 REGISTER vaš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.cloud odbija 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 putem Brojevi telefona → Dodajte broj → Povežite VoIP pružatelja usluga (ili izravno iz veze). Svaki uvezeni broj provjerava se prije aktivacije. Za ručnu SIP vezu ta provjera upućuje kratak (nekoliko sekundi) testni poziv s vašeg broja, putem vašeg SIP trunka, na ThunderPhone broj — tako se korisničko ime, lozinka, transport i odlazno usmjeravanje vašeg pružatelja usluga stvarno ispituju. Vaš pružatelj usluga taj poziv naplaćuje kao i svaki drugi. Ako ga pružatelj usluga odbije, broj ostaje u stanju Postavljanje, a stranica s telefonskim brojevima prikazuje odgovor pružatelja usluga (na primjer „odbijene su vjerodajnice za ThunderPhone (SIP 401)”); ispravite vezu i ponovno je provjerite. Ako vaš pružatelj usluga prihvati trunk, ali njegov plan usmjeravanja ne obuhvaća ThunderPhone testni broj (DIDWW odgovara „Odredišni broj na crnoj je listi plana usmjeravanja”), broj se prikazuje kao Potvrđeno · pružatelj usluga prihvatio: upotrebljiv je, ali pozivi na druga odredišta nisu testirani. Taj poziv dokazuje da vaš trunk može upućivati pozive kao taj broj; ne dokazuje da ste vlasnik broja i ne testira pozive na taj broj; to čini neobavezni dolazni test u nastavku. Potvrđeni brojevi podržavaju dolazne i odlazne pozive — čime se otključavaju odlazne kampanje i programski odlazni pozivi.

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čni SIP brojevi i Twilio brojevi nakon što ThunderPhone postavi odlazne pozive na vašem Twilio računu) najprije zovu sami sebe: ThunderPhone bira broj s tog broja, putem tog trunka. Dijalog vas obavještava prije upućivanja poziva. Poziv odlazi putem vašeg operatera i, ako je dolazno usmjeravanje ispravno, vraća se izravno u ThunderPhone. Kada se vrati s identifikacijom pozivatelja vlastitog broja, taj jedan poziv dokazuje i da vaš operater prihvaća ThunderPhoneove pozive kao da dolaze s tog broja i da pozivi na taj broj stižu do ThunderPhonea, u bilo kojoj zemlji. Neki operateri odbijaju ili ne povezuju poziv s broja na isti broj; to ne govori ništa o vašem usmjeravanju, pa ThunderPhone tada poziva s jednog od vlastitih brojeva. Ako se vaš broj preusmjerava nekamo drugdje, taj telefon može zazvoniti dvaput: najprije s identifikacijom pozivatelja vlastitog broja, a zatim s ThunderPhoneovim testnim brojem.
• Ostali brojevi (i prethodno navedena zamjenska opcija) pozivaju se s jednog od ThunderPhoneovih vlastitih brojeva. ThunderPhone zasad može upućivati te pozive samo na brojeve u SAD-u i Kanadi; za ostale brojeve test javlja da se nije mogao pokrenuti, uz odgovor vašeg operatera ako je poziv broja na samog sebe 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 na sip.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 na sip.thunderphone.com.
• 404 Not Found od sip.thunderphone.com (ručni SIP): poziv nije bio adresiran na telefonski broj ili redak zahtjeva i zaglavlje To navode različite brojeve. Pošaljite birani broj u oba, kao što je navedeno iznad.
• 403 Forbidden od sip.thunderphone.com: redak zahtjeva navodi drugi host. Adresirajte poziv na sip.thunderphone.com, na primjer sip:+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#