Yhdistä VoIP-palveluntarjoaja

Yhdistä jo käyttämäsi palveluntarjoaja (Twilio tai Telnyx API-avaimella; SignalWire, Vonage, Plivo tai mikä tahansa SIP-runko SIP:n kautta) tai avaa uusi Telnyx-tili ohjatun käyttöönoton avulla.

Tuotantoliikenteen tulisi kulkea omistamiesi numeroiden kautta oman VoIP-palveluntarjoajasi avulla. Hallintapaneelin Yhteydet → VoIP -sivulla (/dashboard/voip-connections) yhdistät palveluntarjoajatilisi; kun se on yhdistetty, voit tuoda numeroita, jotka tukevat saapuvia ja lähteviä puheluita.

Napsauta Uusi yhteys ja valitse jompikumpi kahdesta vaihtoehdosta: Yhdistä jo käyttämäsi palveluntarjoaja tai Luo uusi Telnyx-tili.

Yhdistä jo käyttämäsi palveluntarjoaja#

Valitse palveluntarjoaja, jolla numerosi ovat:

Liitä Twiliota ja Telnyxiä varten tunnistetiedot ja napsauta Yhdistä ja testaa. ThunderPhone vahvistaa ne ja määrittää palveluntarjoajan puolen puolestasi. Telnyxiä varten ThunderPhone lisää yhden oman SIP-yhteytensä Telnyx-tilillesi (nimeltään thunderphone-production-<org>-outbound-<id>) ja soittaa lähtevät puhelut sen kautta, joten Telnyx laskuttaa nämä puhelut sinulta. Se käyttää sen Telnyx-yhteyden lähtevän puheluliikenteen profiilia, johon numerosi on liitetty, joten kyseisen profiilin sallitut maat ja kulutusrajat ovat voimassa. Jos yhteydellä ei ole lähtevän puheluliikenteen profiilia ja tililläsi on tasan yksi käytössä oleva profiili, ThunderPhone käyttää sitä. Jos haluat käyttää toista profiilia, liitä se yhteyteen Telnyx-portaalissa ja tallenna ThunderPhone- yhteys uudelleen. Jos tilillä ei ole käytössä olevaa profiilia tai niitä on useita, liitä yksi yhteyteen Telnyx-portaalissa ja tallenna ThunderPhone-yhteys uudelleen. Siihen asti lähtevät puhelut epäonnistuvat virheellä outbound_trunk_unavailable; saapuvat puhelut toimivat edelleen.

Kun Telnyx hylkää lähtevän puhelun (esimerkiksi SIP 403 Forbidden), hylkäys tulee omalta Telnyx-tililtäsi. Tavallisia syitä ovat käytettävissä olevan saldon puuttuminen, soittajan numero, joka ei ole kyseisellä Telnyx-tilillä, tai lähtevän puheluliikenteen profiili, joka ei salli kohdemaita.

SIP-määritys SignalWirelle, Vonagelle ja Plivolle#

Nämä kolme avaavat manuaalisen SIP-lomakkeen, jossa kyseisen palveluntarjoajan vaiheet ovat ylhäällä, mukana on linkki palveluntarjoajan omaan määritysoppaaseen ja esimerkki-SIP-verkkotunnus:

• SignalWire: luo SIP-tunnistetiedot lähteviä puheluja varten, syötä SIP-verkkotunnus, käyttäjänimi ja salasana sekä anna jokaiselle numerolle SWML-skripti, joka yhdistää saapuvat puhelut ThunderPhone SIP-päätepisteeseen.
• Vonage: luo SIP Trunking -hallintapaneelissa trunk lähtevien puhelujen tunnistetiedoilla, syötä sen verkkotunnus (esimerkiksi your-trunk.sip-us.vonage.com) ja tunnistetiedot, lisää ThunderPhone SIP-päätepiste trunkin saapuvaksi SIP-URI:ksi ja liitä numerosi trunkkiin.
• Plivo: luo lähtevä trunk tunnistetiedoilla ja syötä sen Termination SIP Domain (<trunk-id>.zt.plivo.com), käyttäjänimi ja salasana; luo saapuva trunk, jonka Primary URI on ThunderPhone SIP-päätepiste, jota seuraa ;transport=tcp; aseta sitten jokaisen numeron Sovellustyypiksi kyseinen trunk.

Tuloksena on manuaalinen SIP-yhteys (provider: "manual" API:ssa), joka testataan ja vahvistetaan aivan kuten käsin syötetty yhteys. Yhteyskortissa näkyy palveluntarjoajan nimi, esimerkiksi SignalWire · SIP.

Luo uusi Telnyx-tili#

Eikö sinulla ole vielä palveluntarjoajaa? Ohjattu toiminto opastaa sinua Telnyx-tilin avaamisessa ja yhdistämisessä:

1. Luo tili

   Napsauta Avaa Telnyx-rekisteröityminen, luo tilisi ja valitse "Olen luonut tilini."

2. Hanki API-avain

   Napsauta Avaa API-avainten sivu, luo avain ja liitä se kohtaan API-avain (v2). Voit halutessasi nimetä yhteyden.

3. Yhdistä ja testaa

   Napsauta Yhdistä ja testaa — ThunderPhone vahvistaa tunnistetiedot ja ottaa käyttöön tarvitsemansa asetukset Telnyxin puolella ennen tallennusta.

Mitä ThunderPhone määrittää Telnyxissä#

Ellet anna omaa yhteystunnustasi, molemmat Telnyx-reitit (ohjattu määritys ja API-avaimen liittäminen) jättävät Telnyx-tilillesi saman asian: yhden SIP-yhteyden nimeltä thunderphone-<your organization id>. Se on FQDN-yhteys, jonka FQDN-tietue osoittaa ThunderPhonen SIP-päätepisteeseen, ja jokainen tuomasi numero liitetään siihen. Telnyx lähettää näihin numeroihin tulevat puhelut suoraan ThunderPhoneen SIP-yhteyden kautta.

• Sen webhook-kentät ovat tarkoituksella tyhjiä. Webhookia, Call Control -sovellusta, TeXML-sovellusta tai rekisteröityä SIP-puhelinta ei käytetä.
• Älä siirrä tuotuja numeroita toiseen yhteyteen tai sovellukseen äläkä rekisteröi laitetta siihen.
• Jos annoit oman yhteystunnuksesi yhdistäessäsi, ThunderPhone käyttää sitä yhteyttä eikä koskaan muuta sitä; sen on oltava FQDN-yhteys, joka osoittaa ThunderPhonen SIP-päätepisteeseen.

Ennen 30. elokuuta 2026 ThunderPhonen luoma thunderphone-…-yhteys oli tunnistetietoyhteys, joka ei voi vastaanottaa puheluita. Jos omasi näkyy yhä tunnistetietoyhteytenä, ota yhteyttä tukeen, niin muunnamme sen.

Manuaalinen SIP-määritys#

SignalWire-, Vonage- ja Plivo-ruudut avaavat tämän lomakkeen, samoin Syötän kaikki asetukset itse kohdassa Muu palveluntarjoaja. Mikä tahansa SIP-runko toimii, mukaan lukien DIDWW tai itse ylläpitämäsi PBX. Anna yhteyden nimi, SIP-toimialue / URI, valinnainen käyttäjänimi ja salasana, portti ja siirtotapa; Lisäasetukset lisää median salauksen (SRTP). Lomake näyttää myös SIP-osoitteen, johon runkosi on lähetettävä saapuvat puhelut: sip.thunderphone.com, portissa 5060 UDP:lle tai TCP:lle tai portissa 5061 TLS:lle. TLS:n kautta SIP-signalointi pysyy salattuna aina LiveKit Cloudiin asti, jossa ThunderPhone käsittelee puhelun; ääni ei koskaan kulje sip.thunderphone.com-osoitteen kautta, joten SRTP toimii entiseen tapaan. Osoita kukin puhelu valittuun numeroon E.164-muodossa käyttäen samaa numeroa, myös +-merkkiä, sekä pyyntörivillä että To-otsakkeessa: esimerkiksi sip:+14155550142@sip.thunderphone.com. +-merkki antaa ThunderPhonelle mahdollisuuden käsitellä puhelun oikealla alueella (katso huomautus kohdassa IP-sallittujen osoitteiden luettelo). Aiemmin <your-project>.sip.livekit.cloud-osoitteella määritetyt rungot toimivat edelleen, kun Sallitut lähde-IP-osoitteet on tyhjä; sinun ei tarvitse muuttaa niitä. ThunderPhone muuttaa nämä asetukset erilliseksi SIP-runkojen pariksi LiveKit Cloudissa: lähtevät puhelut yhteyden numeroista ohjataan SIP-toimialueellesi tunnuksillasi, ja näihin numeroihin tulevat saapuvat puhelut hyväksytään mistä tahansa osoitteesta, ellet täytä valinnaista Sallitut lähde-IP-osoitteet -kenttää. Täytä se vain, jos operaattorisi ilmoittaa kiinteät signalointi-IP-osoitteet: virheellinen tai puutteellinen luettelo saa ThunderPhonen hylkäämään operaattorisi saapuvat puhelut. Kaksi painiketta hoitaa päätyön:

• Luo tekoälyasetusten opas — luo palveluntarjoajakohtaiset ohjeet tarvitsemastasi runkoyhteyden määrityksestä.
• Testaa ja tallenna yhteys — tarkistaa, että SIP-päätepiste selvitetään julkiseksi osoitteeksi ja että se TCP/TLS-yhteyksissä hyväksyy yhteyden valitussa portissa (UDP-isännille tehdään vain DNS-tarkistus), ja tallentaa sitten asetukset. Se ei voi vielä soittaa puhelua, koska yhteydellä ei ole numeroita; varsinainen varmistus tehdään tuontivaiheessa (alla).

Yhteyden myöhempi muokkaaminen suorittaa saman tarkistuksen uudelleen muuttamillesi asetuksille ennen kuin mitään tallennetaan, luo sitten rungon uudelleen ja varmentaa jokaisen yhteyden numeron uudelleen lyhyellä taustalla tehtävällä testipuhelulla — numerot näkyvät tilassa Valmistellaan, kunnes niiden testipuhelu onnistuu. Vain Sallitut lähde-IP-osoitteet -asetuksen muuttaminen Yhdistetty-tilassa olevassa yhteydessä on erilaista: se ei koskaan vaikuta lähteviin puheluihin, joten ThunderPhone päivittää luettelon saapuvan liikenteen runkoon heti ja numerot pysyvät tilassa Aktiivinen. Niiden saapuvan puhelun testi palautuu tilaan ei testattu; suorita se uudelleen tai soita oikea puhelu operaattorisi kautta varmistaaksesi, että uusi luettelo päästää puhelut läpi. Testi epäonnistuu, jos sen puhelu hylättäisiin luettelon perusteella. Tallennettuja salasanoja ei koskaan näytetä uudelleen; jätä salasana tyhjäksi säilyttääksesi sen tai valitse "Poista tallennettu salasana" IP-todennettua runkoa varten.

IP-osoitteiden salliminen ja runkoyhteyden todennus#

Jotkin operaattorit (DIDWW, Telnyxin IP-todennusyhteydet, useimmat palomuurin takana olevat PBX-järjestelmät) hyväksyvät SIP-liikennettä vain sallimiltasi osoitteilta tai todentavat lähtevät puhelut lähde-IP-osoitteen perusteella. ThunderPhone käyttää kahta osoitejoukkoa.

SIP-reuna. Saapuvat puhelut, jotka lähetät osoitteeseen sip.thunderphone.com, kulkevat ThunderPhonen SIP-reunan kautta, joka välittää vain SIP-signalointia. Ensimmäinen INVITE menee osoitteeseen sip.thunderphone.com; puhelun muu signalointi (ACK, katkaisu, siirrot) kulkee operaattorisi ja puhelun vastaanottaneen reunapalvelimen, sip-1 tai sip-2, välillä. Jos palomuurisi suodattaa SIP-signalointia, salli kaikki kolme UDP- ja TCP-portissa 5060 sekä TLS-portissa 5061:

LiveKit Cloud. Jokaisen puhelun ääni (RTP) ja lähtevien puhelujen SIP-signalointi kulkevat operaattorisi ja LiveKit Cloudin välillä, eivät koskaan SIP-reunan kautta. Salli kaikki alla olevat alueet sekä SIP-signaloinnille että medialle:

LiveKit käyttää näitä alueita Realtimeen, SIP-signalointiin, mediaan ja webhookeihin, ja ne kattavat sen Kanadan, EU:n, Intian, Japanin ja Yhdysvaltojen alueilla käsitellyt puhelut. Kiinnitetyn päätepisteen alueiden nimet: canada, eu, india, japan, us.

Muutama käytännön sääntö itse runkoyhteydelle:

• ThunderPhone ei rekisteröidy. Se ei koskaan lähetä SIP REGISTER -pyyntöä operaattorillesi, joten määritä SIP-runko käyttämään IP-pohjaista ja/tai tunnistetietojen (käyttäjätunnus + salasana) todentamista, ei rekisteröintiä.
• Lähtevien puhelujen tulisi käyttää tunnistetietoja. Ota käyttäjätunnus-/salasanatodennus käyttöön operaattorin päässä ja syötä samat arvot manuaaliseen SIP-lomakkeeseen. Käytä IP-sallittujen luetteloa toisena suojakerroksena, ei ainoana — kattavien alueiden ulkopuolisiin kohteisiin lähtevät puhelut voivat olla peräisin muista osoitteista.
• Saapuvat puhelut kulkevat vastakkaiseen suuntaan. Lomakkeen valinnaiseen Sallitut lähde-IP-osoitteet -kenttään syötät operaattorisi signalointiosoitteet, jotta ThunderPhone hyväksyy puhelut vain niistä. Syötä IP-osoitteita tai CIDR-alueita; isäntänimet eivät koskaan täsmää. Jätä kenttä tyhjäksi, ellei operaattorisi julkaise kiinteää luetteloa. ThunderPhone tarkistaa luettelon jokaisessa saapuvassa puhelussa SIP-reunan näkemää osoitetta vasten, joten kun luettelo on määritetty, lähetä puhelusi osoitteeseen sip.thunderphone.com. Puhelu osoitteesta, jota ei ole luettelossa, tai suoraan osoitteeseen <your-project>.sip.livekit.cloud lähetetty puhelu hylätään: se epäonnistuu tai yhdistyy ja päättyy heti.

LiveKit julkaisee alueet sivulla Alueet, alueelliset päätepisteet ja staattiset IP-osoitteet; ThunderPhone tarkistaa sivun viikoittain ja päivittää tämän oppaan, kun se muuttuu.

Yhdistämisen jälkeen#

Tuo numeroita kohdasta Puhelinnumerot → Lisää numero → Yhdistä VoIP- palveluntarjoaja (tai suoraan yhteydestä). Jokainen tuotu numero vahvistetaan ennen käyttöönottoa. Manuaalisessa SIP-yhteydessä vahvistus soittaa lyhyen, muutaman sekunnin testipuhelun numerostasi SIP-runkosi kautta ThunderPhone-numeroon — näin käyttäjänimi, salasana, siirtotapa ja operaattorisi lähtevien puhelujen reititys testataan käytännössä. Operaattorisi veloittaa puhelusta kuten mistä tahansa muustakin puhelusta. Jos operaattori hylkää sen, numero jää tilaan Valmistellaan, ja puhelinnumerosivulla näkyy operaattorin vastaus (esimerkiksi "ThunderPhone-tunnistetiedot hylätty (SIP 401)"); korjaa yhteys ja vahvista uudelleen. Jos operaattorisi hyväksyy rungon, mutta sen reitityssuunnitelma ei kata ThunderPhone-testinumeroa (DIDWW vastaa "Kohdenumero estetty reitityssuunnitelmassa"), numero näkyy tilassa Vahvistettu · operaattori hyväksyi: numeroa voi käyttää, mutta puheluja muihin kohteisiin ei testattu. Puhelu osoittaa, että runkosi voi soittaa puheluita numerona; se ei osoita, että omistat numeron, eikä se testaa puheluita numeroon; alla oleva valinnainen saapuvan puhelun testi tekee sen. Vahvistetut numerot tukevat saapuvia ja lähteviä puheluja — mikä mahdollistaa lähtevät kampanjat ja ohjelmalliset lähtevät puhelut.

Saapuvan puhelun testi#

Vahvista numero avaa valintaikkunan, jolla voit myös testata saapuvia puheluita. Testi soittaa numeroosi, tarkistaa, että puhelu saapuu ThunderPhoneen, ja katkaisee sitten puhelun käynnistämättä agenttiasi:

• Numerot, joilla on oma lähtevän liikenteen SIP-runko (manuaaliset SIP-numerot sekä Twilio-numerot, kun ThunderPhone on määrittänyt lähtevät puhelut Twilio-tilillesi) soittavat ensin itseensä: ThunderPhone soittaa numerosta samaan numeroon tämän rungon kautta. Valintaikkuna kertoo tästä ennen puhelun soittamista. Puhelu lähtee operaattorisi kautta ja, jos saapuvan liikenteen reitityksesi on oikein, palaa suoraan ThunderPhoneen. Kun se palaa numeron omalla soittajan tunnuksella, yksi puhelu todistaa sekä sen, että operaattorisi hyväksyy ThunderPhonen puhelut numeron nimissä, että sen, että numeroon tulevat puhelut saapuvat ThunderPhoneen, missä tahansa maassa. Jotkin operaattorit estävät tai eivät yhdistä puhelua numerosta siihen itseensä; tämä ei kerro mitään reitityksestäsi, joten ThunderPhone soittaa tällöin sen sijaan yhdestä omasta numerostaan. Jos numerosi ohjaa puhelut muualle, kyseinen puhelin saattaa soida kahdesti: ensin numeron omalla soittajan tunnuksella ja sitten ThunderPhonen testinumerolla.
• Muut numerot (sekä yllä oleva varavaihtoehto) saavat puhelun yhdestä ThunderPhonen omista numeroista. ThunderPhone voi toistaiseksi soittaa näitä puheluita vain yhdysvaltalaisiin ja kanadalaisiin numeroihin; muiden numeroiden kohdalla testi ilmoittaa, ettei sitä voitu suorittaa, sekä operaattorisi vastauksen, jos itseensä soitettu puhelu estettiin.

Jos operaattorisi muuttaa soittajan tunnusta matkalla, ThunderPhone ei voi tunnistaa puhelua, joten agenttisi saattaa vastata siihen hetkeksi. Saapuvan puhelun testi on valinnainen. Voit ohittaa sen, ja numero toimii silti; puhelinnumerosivulla näkyy silloin Saapuvia puheluita ei testattu, ja voit suorittaa testin myöhemmin painikkeella Testaa tai numeron valikkokohdalla Testaa saapuvat puhelut. Heti tuonnin jälkeen puhelinnumerosivu pyytää sinua myös testaamaan uusien numeroiden saapuvat puhelut. Mitään ei soiteta, ennen kuin vahvistat toiminnon valintaikkunassa.

Jos palveluntarjoajasi ohjaa numeron muualle, kohde saattaa soida enintään 8 sekuntia puhelua kohden ennen kuin ThunderPhone katkaisee puhelun. Jos jokin vastaa ensin (Twilio-sovellus, joka vastaa ja sitten ohjaa puhelun eteenpäin, tai puhelinvalikko), testi odottaa, että edelleen ohjattu puhelu saapuu ThunderPhoneen: enintään 8 sekuntia itseensä soitetussa puhelussa ja 15 sekuntia ThunderPhone-numerosta soitetussa puhelussa. Tulos säilyy numerossa (Saapuva onnistui tai epäonnistui), kunnes muutat yhteyttä tai tuot numeron uudelleen, mikä palauttaa tilaksi ei testattu. Yhteyden muuttaminen vahvistaa lähtevät puhelut uudelleen taustalla, mutta ei koskaan soita numeroosi pyytämättä.

Saapuvien puheluiden vianmääritys#

Yhteyden Testaa-painike tarkistaa tunnistetiedot, ja vahvistus tarkistaa lähtevän soittamisen. Tarkista saapuvat puhelut suorittamalla yllä oleva saapuvan puhelun testi tai soittamalla numeroon puhelimesta ja etsimällä puhelu kohdasta Puheluhistoria. Selaimen Puhu-testit ja bottien väliset simulaatiot eivät kulje operaattorisi kautta, joten ne eivät osoita, toimivatko saapuvat puhelut. Puhelinnumeroon kohdistuva simulaatio (SIP-takaisinkytkentä) soittaa siihen operaattorisi kautta, joten vastattu puhelu testaa saapuvien puheluiden reitityksen.

• Kuulet oman matkapuhelinoperaattorisi viestin (esimerkiksi "Tervetuloa Verizoniin" tai "valitsemasi numero ei ole käytössä"): puhelu epäonnistui ennen kuin se saavutti ThunderPhonen. Tarkista, että numero on aktiivinen palveluntarjoajatililläsi ja liitetty ThunderPhone-yhteyteen tai -trunkiin.
• Varattu-ääni tai puhelu soi loppuun asti: palveluntarjoaja hyväksyi puhelun, mutta ei voinut toimittaa sitä. Jos käytät Telnyxiä, tarkista numeron Yhteys Telnyx-portaalissa: sen pitäisi olla yllä kuvattu thunderphone-…-FQDN-yhteys tai oma FQDN-yhteytesi, joka osoittaa ThunderPhone SIP -päätepisteeseen. Jos käytät Twiliota, numeron pitäisi olla liitetty ThunderPhone SIP -trunkiin eikä Voice-webhookiin tai TwiML-sovellukseen.
• Operaattorisi lokeissa näkyy 404 No trunk found (manuaalinen SIP): puhelu saavutti ThunderPhonen, mutta ei vastannut mitään trunkia. Tarkista, että numero on tuotu tähän yhteyteen ja että trunk osoittaa osoitteeseen sip.thunderphone.com. Jos se osoittaa osoitteeseen <your-project>.sip.livekit.cloud, Sallitut lähde-IP-osoitteet -kentän on oltava tyhjä: kun luettelo on määritetty, hyväksytään vain osoitteeseen sip.thunderphone.com lähetetyt puhelut.
• 404 Not Found osoitteesta sip.thunderphone.com (manuaalinen SIP): puhelua ei osoitettu puhelinnumeroon tai pyyntörivi ja To-otsake nimeävät eri numerot. Lähetä valittu numero molemmissa, kuten yllä.
• 403 Forbidden osoitteesta sip.thunderphone.com: pyyntörivi nimeää toisen isännän. Osoita puhelu osoitteeseen sip.thunderphone.com, esimerkiksi sip:+14155550142@sip.thunderphone.com.
• Puhelu saavuttaa ThunderPhonen, mutta väärä agentti vastaa tai kukaan ei vastaa: tarkista numeron saapuvien puheluiden agentti kohdasta Puhelinnumerot.

Sovelluksen sisäinen copilot voi tarkistaa numeron puolestasi: kysy siltä, miksi numeroon soitetut puhelut epäonnistuvat. Telnyx-yhteyksissä se myös selvittää vain luku -tilassa ja organisaation ylläpitäjille, mihin yhteyteen Telnyx liittää numeron.

Seuraavat vaiheet#