VoIP-szolgáltató csatlakoztatása

Csatlakoztasson egy már használt szolgáltatót (Twilio vagy Telnyx API-kulccsal; SignalWire, Vonage, Plivo vagy bármely SIP-trönk SIP-en keresztül), vagy nyisson új Telnyx-fiókot irányított beállítással.

Éles forgalmat a saját VoIP-szolgáltatóján keresztül, az Ön tulajdonában lévő számokon futtasson. A vezérlőpult Kapcsolatok → VoIP oldala (/dashboard/voip-connections) csatlakoztatja a szolgáltatói fiókját; a csatlakozás után importálhat olyan számokat, amelyek támogatják a bejövő és kimenő hívásokat.

Kattintson az Új kapcsolat lehetőségre, majd válasszon a két út közül: Már használt szolgáltató csatlakoztatása vagy Új Telnyx-fiók beállítása.

Csatlakoztasson egy már használt szolgáltatót#

Válassza ki azt a szolgáltatót, amelynél a számai vannak:

Twilio és Telnyx esetén illessze be a hitelesítő adatokat, majd kattintson a Csatlakozás és tesztelés gombra. A ThunderPhone ellenőrzi azokat, és elvégzi Ön helyett a szolgáltatói oldali konfigurációt. Telnyx esetén a ThunderPhone saját SIP-kapcsolatot ad hozzá az Ön Telnyx-fiókjához (thunderphone-production-<org>-outbound-<id> néven), és ezen keresztül indít kimenő hívásokat, így a Telnyx ezeket a hívásokat Önnek számlázza. A számokhoz tartozó Telnyx-kapcsolat kimenő hangprofilját használja, ezért az adott profil engedélyezett országai és költési korlátai érvényesek. Ha ez a kapcsolat nem rendelkezik kimenő hangprofillal, és a fiókjában pontosan egy engedélyezett profil van, a ThunderPhone azt használja. Másik profil használatához rendelje azt a kapcsolathoz a Telnyx portálon, majd mentse újra a ThunderPhone-kapcsolatot. Ha a fiókban nincs engedélyezett profil, vagy több is van, rendeljen hozzá egyet a kapcsolathoz a Telnyx portálon, majd mentse újra a ThunderPhone-kapcsolatot. Addig a kimenő hívások outbound_trunk_unavailable hibával sikertelenek lesznek; a bejövő hívások továbbra is működnek.

Amikor a Telnyx elutasít egy kimenő hívást (például SIP 403 Forbidden esetén), az elutasítás az Ön saját Telnyx-fiókjából érkezik. Ennek általában az az oka, hogy nincs rendelkezésre álló egyenleg, a hívó száma nem ehhez a Telnyx-fiókhoz tartozik, vagy a kimenő hangprofil nem engedélyezi a célországot.

SIP-beállítás SignalWire, Vonage és Plivo esetén#

Ez a három szolgáltató megnyitja a kézi SIP-űrlapot, amelynek tetején az adott szolgáltatóhoz tartozó lépések, a szolgáltató saját beállítási útmutatójára mutató hivatkozás és egy példa SIP-domain található:

• SignalWire: hozzon létre SIP-hitelesítő adatokat kimenő hívásokhoz, adja meg a SIP-domaint, a felhasználónevet és a jelszót, majd rendeljen minden számhoz egy SWML-szkriptet, amely a bejövő hívásokat a ThunderPhone SIP-végponthoz kapcsolja.
• Vonage: a SIP Trunking irányítópulton hozzon létre egy trunkot kimenő hitelesítő adatokkal, adja meg annak domainjét (például your-trunk.sip-us.vonage.com) és a hitelesítő adatokat, adja hozzá a ThunderPhone SIP-végpontot a trunk bejövő SIP URI-jaként, majd kapcsolja a számait a trunkhoz.
• Plivo: hozzon létre egy kimenő trunkot hitelesítő adattal, és adja meg annak Termination SIP Domain értékét (<trunk-id>.zt.plivo.com), felhasználónevét és jelszavát; hozzon létre egy bejövő trunkot, amelynek Primary URI értéke a ThunderPhone SIP-végpont, amelyet ;transport=tcp követ; ezután állítsa minden szám Application Type értékét erre a trunkra.

Az eredmény egy kézi SIP-kapcsolat (provider: "manual" az API-ban), amelyet pontosan ugyanúgy tesztel és ellenőriz a rendszer, mint egy kézzel megadott kapcsolatot. A kapcsolatkártya a szolgáltató nevét jeleníti meg, például SignalWire · SIP.

Új Telnyx-fiók beállítása#

Még nincs szolgáltatója? Az irányított folyamat végigvezeti Önt a Telnyx-fiók megnyitásán és csatlakoztatásán:

1. Fiók létrehozása

   Kattintson a Telnyx regisztráció megnyitása elemre, hozza létre a fiókját, majd jelölje be a „Létrehoztam a fiókomat.” lehetőséget.

2. API-kulcs beszerzése

   Kattintson az API-kulcsok oldalának megnyitása elemre, hozzon létre egy kulcsot, majd illessze be az API-kulcs (v2) mezőbe. Opcionálisan el is nevezheti a kapcsolatot.

3. Csatlakozás és tesztelés

   Kattintson a Csatlakozás és tesztelés elemre — a ThunderPhone ellenőrzi a hitelesítő adatokat, és mentés előtt létrehozza a Telnyx oldalán szükséges erőforrásokat.

Amit a ThunderPhone beállít a Telnyxben#

Ha nem adja meg a saját Connection ID-ját, mindkét Telnyx-útvonal (az irányított beállítás és egy API-kulcs beillesztése) ugyanazt hagyja a Telnyx-fiókjában: egy thunderphone-<your organization id> nevű SIP-kapcsolatot. Ez egy FQDN-kapcsolat, amelynek FQDN-rekordja a ThunderPhone SIP-végpontjára mutat, és minden importált szám hozzá van rendelve. A Telnyx az ezekre a számokra érkező hívásokat közvetlenül a ThunderPhone-nak küldi SIP-en keresztül.

• A webhookmezők szándékosan üresek. Nincs webhook, Call Control alkalmazás, TeXML-alkalmazás vagy regisztrált SIP-telefon használatban.
• Ne helyezze át az importált számokat másik kapcsolathoz vagy alkalmazáshoz, és ne regisztráljon hozzá eszközt.
• Ha a csatlakoztatáskor megadta a saját Connection ID-ját, a ThunderPhone azt a kapcsolatot használja helyette, és soha nem módosítja; ennek a ThunderPhone SIP-végpontjára mutató FQDN-kapcsolatnak kell lennie.

2026. augusztus 30. előtt a ThunderPhone által létrehozott thunderphone-… kapcsolat hitelesítő adatokkal működő kapcsolat volt, amely nem képes hívásokat fogadni. Ha az Ön kapcsolata továbbra is hitelesítő adatokkal működő kapcsolatként jelenik meg, forduljon az ügyfélszolgálathoz, és átalakítjuk.

Kézi SIP-konfiguráció#

A SignalWire, Vonage és Plivo csempék ezt az űrlapot nyitják meg, ahogyan a Minden beállítást magam adok meg lehetőség is a Más szolgáltató alatt. Bármely SIP-trönk használható, beleértve a DIDWW-t vagy egy Ön által üzemeltetett PBX-et is. Adja meg a kapcsolat nevét, a SIP-domain / URI értékét, az opcionális felhasználónevet és jelszót, a portot és a transzportot; a Speciális beállítások média­titkosítást (SRTP) is hozzáadnak. Az űrlap azt a SIP-címet is megjeleníti, amelyre a trönknek a bejövő hívásokat küldenie kell: sip.thunderphone.com, UDP vagy TCP esetén az 5060-as, TLS esetén pedig az 5061-es porton. TLS használatakor a SIP- jelzés végig titkosított marad a LiveKit Cloudig, ahol a ThunderPhone kezeli a hívást; a hang soha nem halad át a sip.thunderphone.com címen, így az SRTP változatlanul működik. Minden hívást a tárcsázott számra címezzen E.164 formátumban, ugyanazzal a számmal, beleértve a + jelet is, mind a kéréssorban, mind a To fejlécben: például sip:+14155550142@sip.thunderphone.com. A + jel teszi lehetővé, hogy a ThunderPhone a megfelelő régióban kezelje a hívást (lásd az IP-címek engedélyezési listája alatti megjegyzést). A korábban <your-project>.sip.livekit.cloud címmel beállított trönkök továbbra is működnek, amíg az Engedélyezett forrás IP-címek mező üres; nem kell módosítania őket. A ThunderPhone ezeket a beállításokat dedikált SIP-trönkpárrá alakítja a LiveKit Cloudban: a kapcsolat számairól indított kimenő hívásokat az Ön hitelesítő adataival az Ön SIP-domainjére irányítja, a számokra érkező bejövő hívásokat pedig bármely címről fogadja, kivéve ha kitölti az opcionális Engedélyezett forrás IP-címek mezőt. Csak akkor töltse ki, ha a szolgáltatója közzétesz rögzített jelzésátviteli IP-címeket: a hibás vagy hiányos lista miatt a ThunderPhone elutasítja a szolgáltatója bejövő hívásait. A két gomb elvégzi a lényegi műveleteket:

• AI-beállítási útmutató létrehozása — szolgáltatóspecifikus utasításokat ír a szükséges trönkoldali konfigurációhoz.
• Kapcsolat tesztelése és mentése — ellenőrzi, hogy a SIP-végpont nyilvános címre oldódik-e fel, valamint TCP/TLS esetén fogad-e kapcsolatot a kiválasztott porton (az UDP-gazdagépeknél csak a DNS-ellenőrzést végzi el), majd menti a kapcsolatot. Hívást még nem tud indítani, mert a kapcsolatnak nincsenek számai; a tényleges bizonyíték az importáláskor érkezik (lentebb).

Egy kapcsolat későbbi szerkesztése ismét lefuttatja ugyanezt az ellenőrzést a módosított beállításokon, mielőtt bármi mentésre kerülne, majd újra létrehozza a trönköt, és a háttérben rövid teszthívással ismét ellenőrzi a kapcsolat minden számát — a számok Üzembe helyezés alatt állapotban jelennek meg, amíg a teszthívásuk sikeresen le nem zárul. Egy Csatlakoztatva kapcsolaton csak az Engedélyezett forrás IP-címek módosítása eltérő: ez soha nem érinti a kimenő hívásokat, ezért a ThunderPhone azonnal frissíti a listát a bejövő trönkön, a számok pedig Aktív állapotban maradnak. A bejövő hívások tesztje nincs tesztelve állapotba áll vissza; futtassa le újra, vagy kezdeményezzen valódi hívást a szolgáltatóján keresztül annak megerősítéséhez, hogy az új lista engedi a hívásokat. A teszt sikertelen, ha a hívását a lista alapján elutasítanák. A tárolt jelszavak soha nem jelennek meg újra; hagyja üresen a jelszómezőt a jelszó megtartásához, vagy jelölje be a „Tárolt jelszó eltávolítása” lehetőséget egy IP-hitelesítéses trönkhöz.

IP-címek engedélyezési listája és trönkhitelesítés#

Egyes szolgáltatók (DIDWW, Telnyx IP-alapú hitelesítésű kapcsolatok, a tűzfal mögötti PBX-ek többsége) csak az engedélyezési listára felvett címekről fogadnak SIP-forgalmat, illetve a kimenő hívásokat forrás-IP-cím alapján hitelesítik. A ThunderPhone két címkészletet használ.

SIP-perem. A sip.thunderphone.com címre küldött bejövő hívások a ThunderPhone SIP-peremén keresztül haladnak, amely csak SIP-jelzést kezel. Az első INVITE a sip.thunderphone.com címre érkezik; a hívás további jelzései (ACK, bontás, átirányítások) az Ön szolgáltatója és a hívást fogadó peremkiszolgáló, a sip-1 vagy a sip-2 között zajlanak. Ha a tűzfala szűri a SIP-jelzést, engedélyezze mindhárom címet UDP- és TCP-5060-as, valamint TLS-5061-es porton:

LiveKit Cloud. Minden hívás hangja (RTP), valamint a kimenő hívások SIP-jelzése az Ön szolgáltatója és a LiveKit Cloud között halad, soha nem a SIP-peremen keresztül. Engedélyezze az alábbi összes tartományt mind a SIP-jelzéshez, mind a médiához:

A LiveKit ezeket a tartományokat alkalmazza a Realtime-ra, a SIP-jelzésre és médiára, valamint a webhookokra; ezek lefedik a Kanada, EU, India, Japán és USA régióiban kezelt hívásokat. Rögzített végpont régiónevei: canada, eu, india, japan, us.

Néhány gyakorlati szabály magára a trönkre vonatkozóan:

• A ThunderPhone nem regisztrál. Soha nem küld SIP REGISTER kérést az Ön szolgáltatójának, ezért a trönköt IP-alapú és/vagy hitelesítő adatokon alapuló (felhasználónév + jelszó) hitelesítésre konfigurálja, ne regisztrációra.
• A kimenő hívásokhoz hitelesítő adatokat használjon. Engedélyezze a felhasználónév/jelszó alapú hitelesítést a szolgáltató oldalán, és adja meg ugyanazokat az értékeket a manuális SIP-űrlapon. Az IP-engedélyezési listát második védelmi rétegként kezelje, ne egyetlenként — a lefedett régiókon kívüli célállomásokra indított kimenő hívások más címekről is indulhatnak.
• A bejövő irány ennek fordítottja. Az űrlap opcionális Engedélyezett forrás-IP-címek mezőjében adhatja meg az Ön szolgáltatójának jelzési címeit, hogy a ThunderPhone csak az ezekről érkező hívásokat fogadja. Adjon meg IP-címeket vagy CIDR-tartományokat; a gazdagépnevek soha nem egyeznek. Hagyja üresen, kivéve, ha a szolgáltatója közzétesz egy rögzített listát. A ThunderPhone minden bejövő hívásnál a SIP-pereme által látott címmel veti össze a listát, ezért a lista beállítása után a hívásokat a sip.thunderphone.com címre küldje. A listán nem szereplő címről érkező, illetve közvetlenül egy <your-project>.sip.livekit.cloud címre küldött hívást a rendszer elutasítja: sikertelen lesz, vagy csatlakozik, majd azonnal megszakad.

A tartományokat a LiveKit itt teszi közzé: Régiók, regionális végpontok és statikus IP-címek; a ThunderPhone hetente ellenőrzi ezt az oldalt, és módosítás esetén frissíti ezt az útmutatót.

Csatlakoztatás után#

Importáljon számokat a Telefonszámok → Szám hozzáadása → VoIP-szolgáltató csatlakoztatása menüpontból (vagy közvetlenül a kapcsolaton keresztül). Minden importált szám ellenőrzésen esik át, mielőtt aktiválódik. Manuális SIP-kapcsolat esetén az ellenőrzés egy rövid (néhány másodperces) teszthívást indít az Ön számáról, az Ön SIP-trönkjén keresztül, egy ThunderPhone-számra — így a felhasználónév, a jelszó, az átvitel és a szolgáltatója kimenő útválasztása is ténylegesen ellenőrzésre kerül. A szolgáltatója ezt a hívást ugyanúgy számlázza, mint bármely másikat.

Ha a szolgáltató elutasítja, a szám Üzembe helyezés állapotban marad, és a telefonszámok oldalon megjelenik a szolgáltató válasza (például: „elutasította a ThunderPhone hitelesítő adatait (SIP 401)”); javítsa a kapcsolatot, majd ellenőrizze újra. Ha a szolgáltató elfogadja a trönköt, de az útválasztási csomagja nem fedi le a ThunderPhone tesztszámát (a DIDWW válasza: „A céltelefonszámot az útválasztási csomag feketelistára tette”), a szám Ellenőrizve · a szolgáltató elfogadta állapotban jelenik meg: használható, de a más célállomásokra irányuló hívások nem lettek tesztelve. Ez a hívás azt igazolja, hogy a trönkje képes a szám nevében hívásokat kezdeményezni; nem bizonyítja, hogy Ön a szám tulajdonosa, és nem teszteli a számra érkező hívásokat; ezt az alábbi opcionális bejövő teszt végzi el. Az ellenőrzött számok támogatják a bejövő és kimenő hívásokat — ezzel elérhetővé válnak a kimenő kampányok és a programozott kimenő hívások.

Bejövő hívás tesztelése#

A Szám ellenőrzése megnyit egy párbeszédablakot, amely a bejövő hívásokat is tesztelheti. A teszt felhívja a számát, ellenőrzi, hogy a hívás eléri-e a ThunderPhone-t, majd az ügynök elindítása nélkül bontja a hívást:

• Saját kimenő SIP-trönkkel rendelkező számok (manuális SIP-számok, valamint Twilio-számok, miután a ThunderPhone beállította a kimenő hívást az Ön Twilio-fiókjában) először saját magukat hívják: a ThunderPhone a számról hívja fel a számot azon a trönkön keresztül. A párbeszédablak a hívás indítása előtt tájékoztatja erről. A hívás az Ön szolgáltatóján keresztül indul, és ha a bejövő útválasztás megfelelő, közvetlenül visszaérkezik a ThunderPhone-hoz. Amikor a hívás a szám saját hívóazonosítójával érkezik vissza, ez az egy hívás egyszerre igazolja, hogy a szolgáltató elfogadja a ThunderPhone hívásait e szám hívóazonosítójával, valamint hogy a számra érkező hívások bármely országban elérik a ThunderPhone-t. Egyes szolgáltatók elutasítják vagy nem kapcsolják össze azokat a hívásokat, amelyeknél egy szám saját magát hívja; ez nem mond semmit az útválasztásról, ezért a ThunderPhone ilyenkor a saját számai egyikéről hív helyette. Ha a száma máshová van átirányítva, az a telefon kétszer is csöröghet: először a szám saját hívóazonosítóját, majd a ThunderPhone tesztszámát megjelenítve.
• Egyéb számokat (és a fenti tartalék megoldás esetén) a ThunderPhone saját számai egyikéről hívja. A ThunderPhone jelenleg csak amerikai és kanadai számokra tud ilyen hívásokat indítani; más számok esetén a teszt azt jelzi, hogy nem futtatható, és megjeleníti a szolgáltató válaszát, ha az önhívást elutasították.

Ha a szolgáltató útközben módosítja a hívóazonosítót, a ThunderPhone nem tudja felismerni a hívást, ezért az ügynök rövid időre fogadhatja azt. A bejövő teszt opcionális. Kihagyhatja, és a szám továbbra is működni fog; a telefonszámok oldalon ekkor az Bejövő hívás nincs tesztelve állapot jelenik meg, és később a Teszt gombbal vagy a szám Bejövő hívások tesztelése menüpontjával futtathatja. Közvetlenül importálás után a telefonszámok oldal arra is kéri, hogy tesztelje az új számok bejövő hívásait. A párbeszédablakban történő megerősítésig nem indul hívás.

Ha a szolgáltató máshová irányítja a számot, az a célállomás, amire a szám mutat, hívásonként legfeljebb 8 másodpercig csöröghet, mielőtt a ThunderPhone bontja a hívást. Ha valami előbb fogadja a hívást (egy hívást fogadó, majd továbbító Twilio-alkalmazás, egy telefonos menü), a teszt megvárja, amíg az átirányított hívás eléri a ThunderPhone-t: önhívás esetén legfeljebb 8 másodpercig, ThunderPhone-számról indított hívás esetén pedig 15 másodpercig. Az eredmény a számon marad (Bejövő hívás sikeres vagy sikertelen), amíg meg nem változtatja a kapcsolatot vagy újra nem importálja a számot, ami várakozó tesztelésre állítja vissza. Egy kapcsolat módosítása a háttérben újra ellenőrzi a kimenő hívásokat, de soha nem hívja fel a számát az Ön kérése nélkül.

Bejövő hívások hibaelhárítása#

A kapcsolat Teszt gombja a hitelesítő adatokat ellenőrzi, az ellenőrzés pedig a kimenő tárcsázást vizsgálja. A bejövő hívások ellenőrzéséhez futtassa a fenti bejövő hívástesztet, vagy hívja fel a számot telefonról, és keresse meg a hívást a Híváselőzmények között. A böngészős Beszélgetés tesztek és a botok közötti szimulációk nem az Ön szolgáltatóján keresztül mennek, ezért nem jelzik, hogy működnek-e a bejövő hívások. A telefonszámot célzó szimuláció (SIP-visszahurkolás) viszont az Ön szolgáltatóján keresztül tárcsázza a számot, így egy megválaszolt hívás a bejövő útválasztást is teszteli.

• A saját mobilszolgáltatójának üzenetét hallja (például „Üdvözli a Verizon” vagy „a hívott szám nem kapcsolható”): a hívás még azelőtt sikertelen volt, hogy elérte volna a ThunderPhone-t. Ellenőrizze, hogy a szám aktív-e a szolgáltatói fiókjában, és hozzá van-e rendelve a ThunderPhone-kapcsolathoz vagy -trönkhöz.
• Foglalt jelzést hall, vagy a hívás kicsöng: a szolgáltató fogadta a hívást, de nem tudta kézbesíteni. Telnyx esetén ellenőrizze a szám Kapcsolat beállítását a Telnyx portálon: ennek a fent leírt thunderphone-… FQDN-kapcsolatnak, vagy egy saját, a ThunderPhone SIP-végpontra mutató FQDN-kapcsolatnak kell lennie. Twilio esetén a számot a ThunderPhone SIP-trönkhöz kell csatolni, nem pedig Voice webhookhoz vagy TwiML-alkalmazáshoz.
• A szolgáltató naplói 404 No trunk found hibát mutatnak (manuális SIP): a hívás elérte a ThunderPhone-t, de nem egyezett egyetlen trönkkel sem. Ellenőrizze, hogy a szám importálva van-e ezen a kapcsolaton, és hogy a trönk a sip.thunderphone.com címre mutat-e. Ha egy <your-project>.sip.livekit.cloud címre mutat, az Engedélyezett forrás IP-címek mezőnek üresnek kell lennie: megadott lista esetén csak a sip.thunderphone.com címre küldött hívások fogadhatók.
• 404 Not Found a sip.thunderphone.com címről (manuális SIP): a hívás nem telefonszámra volt címezve, vagy a kérési sor és a To fejléc eltérő számokat nevez meg. A fentiek szerint mindkettőben szerepeltesse a tárcsázott számot.
• 403 Forbidden a sip.thunderphone.com címről: a kérési sor másik gazdagépet nevez meg. A hívást a sip.thunderphone.com címre címezze, például sip:+14155550142@sip.thunderphone.com.
• A hívás eléri a ThunderPhone-t, de nem a megfelelő ügynök válaszol, vagy senki sem: ellenőrizze a szám bejövő ügynökét a Telefonszámok oldalon.

Az alkalmazáson belüli copilot ellenőrizhet egy számot Ön helyett: kérdezze meg tőle, miért sikertelenek a számra érkező hívások. Telnyx-kapcsolatok esetén csak olvasási módban azt is megkeresi a szervezeti rendszergazdák számára, hogy a Telnyx melyik kapcsolathoz rendeli a számot.

Következő lépések#