Повежите VoIP провајдера

Повежите провајдера који већ користите (Twilio или Telnyx путем API кључа; SignalWire, Vonage, Plivo или било који SIP trunk путем SIP-а) или отворите нови Telnyx налог уз вођено подешавање.

Продукциони саобраћај треба да користи бројеве које поседујете преко сопственог VoIP провајдера. Страница Везе → VoIP на контролној табли (/dashboard/voip-connections) повезује налог вашег провајдера; када га повежете, увозите бројеве који подржавају долазне и одлазне позиве.

Кликните на Нова веза и изаберите једну од две опције: Повежите добављача којег већ користите или Подесите нови Telnyx налог.

Повежите провајдера којег већ користите#

Изаберите провајдера код којег се налазе ваши бројеви:

За Twilio и Telnyx, налепите приступне податке и кликните на Повежите и тестирајте. ThunderPhone их проверава и конфигурише страну провајдера уместо вас. За Telnyx, ThunderPhone додаје једну сопствену SIP везу на ваш Telnyx налог (под називом thunderphone-production-<org>-outbound-<id>) и преко ње упућује одлазне позиве, па вам Telnyx наплаћује те позиве. Користи профил за одлазне позиве Telnyx везе на којој су ваши бројеви, па се примењују дозвољене земље и ограничења потрошње тог профила. Ако та веза нема профил за одлазне позиве, а ваш налог има тачно један омогућени профил, ThunderPhone користи тај профил. Да бисте користили други, доделите га вези на Telnyx порталу и поново сачувајте ThunderPhone везу. Ако налог нема омогућени профил или их има више, доделите један вези на Telnyx порталу и поново сачувајте ThunderPhone везу. До тада, одлазни позиви не успевају са грешком outbound_trunk_unavailable; долазни позиви настављају да раде.

Када Telnyx одбије одлазни позив (на пример SIP 403 Forbidden), одбијање долази са вашег Telnyx налога. Уобичајени узроци су недостатак доступног кредита, број позиваоца који није на том Telnyx налогу или профил за одлазне позиве који не дозвољава одредишну земљу.

SIP подешавање за SignalWire, Vonage и Plivo#

Ова три провајдера отварају образац за ручни SIP са корацима за тог провајдера на врху, везом до сопственог водича за подешавање провајдера и примером SIP домена:

• SignalWire: направите SIP приступне податке за одлазне позиве, унесите SIP домен, корисничко име и лозинку и доделите сваком броју SWML скрипту која повезује долазне позиве са ThunderPhone SIP крајњом тачком.
• Vonage: на контролној табли SIP Trunking-а направите транк са приступним подацима за одлазне позиве, унесите његов домен (на пример your-trunk.sip-us.vonage.com) и приступне податке, додајте ThunderPhone SIP крајњу тачку као улазни SIP URI транка и повежите своје бројеве са транком.
• Plivo: направите одлазни транк са приступним податком и унесите његов SIP домен за терминацију (<trunk-id>.zt.plivo.com), корисничко име и лозинку; направите улазни транк чији је примарни URI ThunderPhone SIP крајња тачка иза које следи ;transport=tcp; затим подесите тип апликације сваког броја на тај транк.

Резултат је ручна SIP веза (provider: "manual" у API-ју), тестирана и проверена потпуно исто као веза унета ручно. На картици везе приказује се назив провајдера, на пример SignalWire · SIP.

Podesite novi Telnyx nalog#

Još nemate провајдера? Вођени поступак Вас води кроз отварање Telnyx налога и његово повезивање:

1. Креирајте налог

   Кликните на Отворите Telnyx регистрацију, креирајте налог и означите „Креирао/ла сам свој налог.“

2. Преузмите API кључ

   Кликните на Отворите страницу API кључева, генеришите кључ и налепите га у API кључ (v2). По жељи именујте везу.

3. Повежите и тестирајте

   Кликните на Повежите и тестирајте — ThunderPhone проверава акредитиве и обезбеђује оно што му је потребно на Telnyx страни пре чувања.

Шта ThunderPhone подешава у Telnyx-у#

Осим ако не унесете сопствени ID везе, обе Telnyx путање (вођено подешавање и уношење API кључа) остављају исту поставку на вашем Telnyx налогу: једну SIP везу под називом thunderphone-<your organization id>. То је FQDN веза чији FQDN запис показује на ThunderPhone SIP крајњу тачку, а сваки број који увезете додељује се тој вези. Telnyx шаље позиве за те бројеве директно у ThunderPhone преко SIP-а.

• Њена webhook поља су намерно празна. Не користе се webhook, Call Control апликација, TeXML апликација нити регистровани SIP телефон.
• Не премештајте увезене бројеве на другу везу или апликацију, нити региструјте уређај на њој.
• Ако сте при повезивању унели сопствени ID везе, ThunderPhone уместо тога користи ту везу и никада је не мења; она мора бити FQDN веза која показује на ThunderPhone SIP крајњу тачку.

Пре 30. августа 2026. године, веза thunderphone-… коју је ThunderPhone креирао била је веза са акредитивима, која не може да прима позиве. Ако се ваша веза и даље приказује као веза са акредитивима, контактирајте подршку и ми ћемо је конвертовати.

Ручна SIP конфигурација#

Плочице SignalWire, Vonage и Plivo отварају овај образац, као и Самостално ћу унети сва подешавања у одељку Други добављач. Подржан је било који SIP транк, укључујући DIDWW или PBX којим сами управљате. Унесите назив везе, SIP домен / URI, опционе корисничко име и лозинку, порт и транспорт; Напредна подешавања додају шифровање медија (SRTP). Образац приказује и SIP адресу на коју Ваш транк мора да шаље долазне позиве: sip.thunderphone.com, на порту 5060 за UDP или TCP, односно 5061 за TLS. Преко TLS-а, SIP сигнализација остаје шифрована све до LiveKit Cloud-а, где ThunderPhone обрађује позив; звук никада не пролази кроз sip.thunderphone.com, па SRTP ради као и раније. Усмерите сваки позив на позвани број у формату E.164, са истим бројем, укључујући знак +, и у линији захтева и у заглављу To: на пример sip:+14155550142@sip.thunderphone.com. Знак + омогућава ThunderPhone-у да обради позив у одговарајућем региону (погледајте напомену у одељку Дозвољавање IP адреса). Транкови који су раније подешени са адресом <your-project>.sip.livekit.cloud настављају да раде док је поље Дозвољене изворне IP адресе празно; не морате да их мењате. ThunderPhone претвара та подешавања у наменски пар SIP транкова на LiveKit Cloud-у: одлазни позиви са бројева везе упућују се на Ваш SIP домен помоћу Ваших акредитива, а долазни позиви на те бројеве прихватају се са било које адресе осим ако не попуните опционално поље Дозвољене изворне IP адресе. Попуните га само ако Ваш оператер објављује фиксне IP адресе за сигнализацију: нетачна или непотпуна листа доводи до тога да ThunderPhone одбије долазне позиве Вашег оператера. Два дугмета обављају главни посао:

• Генеришите водич за AI подешавање — креира упутства специфична за провајдера за конфигурацију на страни транка која Вам је потребна.
• Тестирајте и сачувајте везу — проверава да ли се SIP крајња тачка разрешава у јавну адресу и, за TCP/TLS, прихвата везу на изабраном порту (UDP хостови добијају само DNS проверу), а затим чува везу. Још не може да упути позив јер веза нема бројеве; стварна потврда долази приликом увоза (испод).

Касније уређивање везе поново покреће исту проверу измењених подешавања пре него што се било шта сачува, затим поново изграђује транк и поново верификује сваки број на вези кратким пробним позивом у позадини — бројеви се приказују као Додељивање док њихов пробни позив не успе. Промена само поља Дозвољене изворне IP адресе на Повезаној вези је другачија: никада не утиче на одлазне позиве, па ThunderPhone одмах ажурира листу на долазном транку, а бројеви остају Активни. Њихов тест долазног позива се враћа на није тестирано; покрените га поново или обавите стварни позив преко свог оператера да бисте потврдили да нова листа пропушта позиве. Тест не успева када би његов позив био одбијен према тој листи. Сачуване лозинке се никада поново не приказују; оставите поље за лозинку празно да бисте је задржали или означите „Уклони сачувану лозинку“ за транк са IP аутентификацијом.

Додавање IP адреса на листу дозвољених и аутентификација транка#

Неки оператери (DIDWW, Telnyx везе са IP аутентификацијом, већина PBX система иза заштитног зида) прихватају SIP саобраћај само са адреса које ставите на листу дозвољених или аутентификују одлазне позиве према изворној IP адреси. ThunderPhone користи два скупа адреса.

SIP рубна тачка. Долазни позиви које шаљете на sip.thunderphone.com пролазе кроз ThunderPhone SIP рубну тачку, која преноси само SIP сигнализацију. Први INVITE иде на sip.thunderphone.com; остатак сигнализације позива (ACK, прекид везе, преусмеравања) одвија се између вашег оператера и рубног сервера који је примио позив, sip-1 или sip-2. Ако ваш заштитни зид филтрира SIP сигнализацију, дозволите сва три сервера на UDP и TCP порту 5060 и TLS порту 5061:

LiveKit Cloud. Аудио (RTP) сваког позива и SIP сигнализација одлазних позива одвијају се између вашег оператера и LiveKit Cloud, никада преко SIP рубне тачке. Дозволите сваки опсег у наставку, и за SIP сигнализацију и за медије:

LiveKit примењује ове опсеге на Realtime, SIP сигнализацију и медије и Webhooks, а они покривају позиве обрађене у његовим регионима у Канади, ЕУ, Индији, Јапану и САД. Називи региона за фиксирану крајњу тачку: canada, eu, india, japan, us.

Неколико практичних правила за сам транк:

• ThunderPhone се не региструје. Никада не шаље SIP REGISTER вашем оператеру, зато конфигуришите транк за аутентификацију засновану на IP адреси и/или акредитивима (корисничко име + лозинка), а не за регистрацију.
• Одлазни позиви треба да користе акредитиве. Омогућите аутентификацију корисничким именом и лозинком на страни оператера и унесите исте вредности у ручни SIP образац. Третирајте листу дозвољених IP адреса као други слој, а не као једини — одлазни позиви ка одредиштима изван покривених региона могу потицати са других адреса.
• Долазни позиви су супротан смер. Опционално поље Дозвољене изворне IP адресе у обрасцу је место где уносите сигнализационе адресе вашег оператера како би ThunderPhone прихватао позиве само са њих. Унесите IP адресе или CIDR опсеге; имена хостова се никада не подударају. Оставите поље празним осим ако ваш оператер не објављује фиксну листу. ThunderPhone проверава листу при сваком долазном позиву у односу на адресу коју види његова SIP рубна тачка, па када подесите листу, шаљите позиве на sip.thunderphone.com. Позив са адресе која није на листи или позив послат директно на адресу <your-project>.sip.livekit.cloud се одбија: не успева или се повеже и одмах прекида.

Опсеге објављује LiveKit на страници Региони, регионалне крајње тачке и статичке IP адресе; ThunderPhone проверава ту страницу недељно и ажурира овај водич када се промени.

Након повезивања#

Увезите бројеве из Бројеви телефона → Додајте број → Повежите VoIP провајдера (или директно из везе). Сваки увезени број се верификује пре него што постане активан. За ручну SIP везу, та верификација упућује кратак (неколико секунди) пробни позив са вашег броја, преко ваше SIP магистрале, до ThunderPhone броја — тако да се корисничко име, лозинка, транспорт и одлазно рутирање вашег провајдера заиста испробавају. Ваш провајдер тај позив наплаћује као и сваки други. Ако га провајдер одбије, број остаје у стању Припрема, а страница бројева телефона приказује одговор провајдера (на пример „ThunderPhone подаци за пријаву су одбијени (SIP 401)“); исправите везу и поново верификујте број. Ако ваш провајдер прихвати магистралу, али његов план рутирања не обухвата ThunderPhone пробни број (DIDWW одговара „Одредишни број је на црној листи плана рутирања“), број се приказује као Верификован · провајдер је прихватио: употребљив је, али позиви ка другим одредиштима нису тестирани. Тај позив доказује да ваша магистрала може да упућује позиве користећи тај број; не доказује да сте власник броја и не тестира позиве ка броју; то ради опционални тест долазних позива у наставку. Верификовани бројеви подржавају долазне и одлазне позиве — што откључава одлазне кампање и програмске одлазне позиве.

Тест долазног позива#

Потврдите број отвара дијалог који такође може да тестира долазне позиве. Тест упућује позив на ваш број, проверава да ли позив стиже до ThunderPhone-а, а затим га прекида без покретања вашег агента:

• Бројеви са сопственом одлазном SIP магистралом (ручни SIP бројеви и Twilio бројеви након што ThunderPhone подеси одлазне позиве на вашем Twilio налогу) најпре позивају сами себе: ThunderPhone бира број са тог броја, преко те магистрале. Дијалог вас обавештава пре него што упути позив. Позив одлази преко вашег провајдера и, ако је ваше долазно усмеравање исправно, враћа се директно у ThunderPhone. Када се врати са сопственом идентификацијом позиваоца броја, тај један позив доказује и да ваш провајдер прихвата ThunderPhone позиве као тај број и да позиви ка броју стижу до ThunderPhone-а, у било којој земљи. Неки провајдери одбијају или не повезују позив са броја на самог себе; то не говори ништа о вашем усмеравању, па ThunderPhone затим позива са једног од сопствених бројева. Ако ваш број прослеђује негде другде, тај телефон може звонити двапут: прво са приказаном сопственом идентификацијом позиваоца броја, а затим са ThunderPhone тест бројем.
• Остали бројеви (и горенаведена резервна опција) позивају се са једног од ThunderPhone сопствених бројева. ThunderPhone за сада може да упути ове позиве само на америчке и канадске бројеве; за остале бројеве тест пријављује да није могао да се покрене, уз одговор вашег провајдера ако је самопозив одбијен.

Ако ваш провајдер успут промени идентификацију позиваоца, ThunderPhone не може да препозна позив, па ваш агент може накратко да одговори на њега. Тест долазног позива је опционалан. Прескочите га и број ће и даље радити; страница са телефонским бројевима ће тада приказати Долазни позиви нису тестирани, а можете га покренути касније помоћу опције Тестирајте или ставке менија броја Тестирајте долазне позиве. Одмах након увоза, страница са телефонским бројевима такође тражи да тестирате долазне позиве на новим бројевима. Ништа се не бира док не потврдите у дијалогу.

Ако ваш провајдер шаље број негде другде, оно на шта показује може звонити до 8 секунди по позиву пре него што ThunderPhone прекине позив. Ако нешто прво одговори (Twilio апликација која одговори па проследи, телефонски мени), тест чека да прослеђени позив стигне до ThunderPhone-а: до 8 секунди за самопозив и 15 секунди за позив са ThunderPhone броја. Резултат остаје на броју (Долазни успешно или неуспешно) док не промените везу или поново увезете број, што га враћа на статус није тестирано. Промена везе поново потврђује одлазне позиве у позадини, али никада не позива ваш број без вашег захтева.

Решавање проблема са долазним позивима#

Дугме Тест за везу проверава акредитиве, а верификација проверава одлазно позивање. Да бисте проверили долазне позиве, покрените тест долазног позива изнад или позовите број са телефона и потражите позив у Историји позива. Тестови Разговор у прегледачу и симулације бот-са-ботом не пролазе кроз Вашег оператера, па не показују да ли долазни позиви функционишу. Симулација која циља број телефона (SIP повратна петља) заиста га позива преко Вашег оператера, па одговорена симулација проверава усмеравање долазних позива.

• Чујете поруку свог мобилног оператера (на пример „Добро дошли у Verizon“ или „број који сте позвали није у употреби“): позив није успео пре него што је стигао до ThunderPhone. Проверите да ли је број активан на налогу код Вашег добављача и додељен ThunderPhone вези или трунку.
• Сигнал заузећа или позив звони без одговора: добављач је прихватио позив, али није могао да га испоручи. Са Telnyx-ом проверите Везу броја у Telnyx порталу: требало би да то буде горе описана FQDN веза thunderphone-… или Ваша FQDN веза која показује на ThunderPhone SIP крајњу тачку. Са Twilio-ом, број би требало да буде повезан са ThunderPhone SIP трунком, а не са Voice веб-закачком или TwiML апликацијом.
• Евиденције Вашег оператера приказују 404 No trunk found (ручни SIP): позив је стигао до ThunderPhone, али се није подударао ни са једним трунком. Проверите да ли је број увезен у ову везу и да ли трунк показује на sip.thunderphone.com. Ако показује на адресу <your-project>.sip.livekit.cloud, Дозвољене IP адресе извора морају бити празне: када је листа постављена, прихватају се само позиви послати на sip.thunderphone.com.
• 404 Not Found од sip.thunderphone.com (ручни SIP): позив није био адресиран на број телефона или линија захтева и заглавље To наводе различите бројеве. Пошаљите позвани број у оба, као што је горе описано.
• 403 Forbidden од sip.thunderphone.com: линија захтева наводи други хост. Адресирајте позив на sip.thunderphone.com, на пример sip:+14155550142@sip.thunderphone.com.
• Позив стиже до ThunderPhone, али се јавља погрешан агент или се нико не јавља: проверите долазног агента броја у Бројевима телефона.

Копилот у апликацији може да провери број уместо Вас: питајте га зашто позиви на тај број не успевају. За Telnyx везе таксама проверава, само за читање и за администраторе организације, којој вези Telnyx додељује број.

Следећи кораци#