ThunderPhone v3 вече е тук.Започнете самостоятелно — от 2 цента/мин.Прочетете съобщението

Connect tools & data

Свързване на VoIP доставчик

Свържете доставчик, който вече използвате (Twilio или Telnyx чрез API ключ; SignalWire, Vonage, Plivo или който и да е SIP trunk чрез SIP), или открийте нов акаунт в Telnyx с водена настройка.

Продукционният трафик трябва да се осъществява през номера, които притежавате, чрез вашия собствен VoIP доставчик. Страницата Връзки → VoIP в таблото (/dashboard/voip-connections) свързва акаунта ви при доставчика; след като бъде свързан, импортирате номера, които поддържат както входящи, така и изходящи обаждания.

Щракнете върху Нова връзка и изберете един от два начина: Свържете доставчик, който вече използвате, или Настройте нов акаунт в Telnyx.

Свържете доставчик, който вече използвате

Изберете доставчика, при който са вашите номера:

ДоставчикНачин на свързване
TwilioAPI ключ: поставете вашите Account SID и Auth Token
TelnyxAPI ключ: поставете своя v2 API ключ
SignalWireSIP настройка
VonageSIP настройка
PlivoSIP настройка
Друг доставчикSIP настройка с помощника за настройка на ThunderPhone за всеки друг оператор или PBX, който управлявате

За 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 скрипт, който свързва входящите обаждания към SIP крайната точка на ThunderPhone.
  • Vonage: в таблото за SIP Trunking създайте trunk с данни за достъп за изходящи обаждания, въведете неговия домейн (например your-trunk.sip-us.vonage.com) и данните за достъп, добавете SIP крайната точка на ThunderPhone като входящ SIP URI на trunk-а и свържете вашите номера с trunk-а.
  • Plivo: създайте изходящ trunk с данни за достъп и въведете неговия Termination SIP Domain (<trunk-id>.zt.plivo.com), потребителско име и парола; създайте входящ trunk, чийто Primary URI е SIP крайната точка на ThunderPhone, последвана от ;transport=tcp; след това задайте Application Type на всеки номер към този trunk.

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

Настройте нов акаунт в Telnyx

Все още нямате доставчик? Воденият процес ще ви преведе през създаването на акаунт в Telnyx и свързването му:

  1. Създайте акаунт

    Щракнете върху Отваряне на регистрацията за Telnyx, създайте своя акаунт и отметнете „Създадох своя акаунт.“

  2. Вземете API ключ

    Щракнете върху Отваряне на страницата с API ключове, генерирайте ключ и го поставете в API ключ (v2). По желание дайте име на връзката.

  3. Свързване и тестване

    Щракнете върху Свързване и тестване — ThunderPhone проверява идентификационните данни и настройва необходимото от страна на Telnyx, преди да запази връзката.

Какво настройва ThunderPhone в Telnyx

Освен ако не въведете собствен ID на връзка, и двата начина за Telnyx (водена настройка и поставяне на API ключ) оставят едно и също нещо във Вашия Telnyx акаунт: една SIP връзка с име thunderphone-<your organization id>. Тя е FQDN връзка, чийто FQDN запис сочи към SIP крайна точка на ThunderPhone, и всеки номер, който импортирате, се присвоява към нея. Telnyx изпраща обажданията за тези номера директно към ThunderPhone през SIP.

  • Полетата за webhook са умишлено празни. Не се използват webhook, приложение Call Control, приложение TeXML или регистриран SIP телефон.
  • Не премествайте импортирани номера към друга връзка или приложение и не регистрирайте устройство към нея.
  • Ако сте въвели собствен ID на връзка при свързването, ThunderPhone използва тази връзка вместо това и никога не я променя; тя трябва да е FQDN връзка, сочеща към SIP крайната точка на ThunderPhone.

Преди 30 август 2026 г. връзката thunderphone-…, създавана от ThunderPhone, беше връзка с идентификационни данни, която не може да получава обаждания. Ако Вашата все още се показва като връзка с идентификационни данни, свържете се с поддръжката и ще я преобразуваме.

Ръчна SIP конфигурация

Плочките SignalWire, Vonage и Plivo отварят този формуляр, както и Ще въведа всяка настройка самостоятелно под Друг доставчик. Всеки SIP trunk работи, включително DIDWW или PBX, който управлявате сами. Въведете името на връзката, SIP домейн / URI, незадължителни потребителско име и парола, порт и транспорт; Разширени настройки добавя криптиране на медиите (SRTP). Формулярът показва и SIP адреса, към който вашият trunk трябва да изпраща входящите обаждания: 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 адреси). Trunk връзките, настроени по-рано с адрес <your-project>.sip.livekit.cloud, продължават да работят, докато Разрешени IP адреси на източника е празно; не е необходимо да ги променяте. ThunderPhone превръща тези настройки в специална двойка SIP trunk връзки в LiveKit Cloud: изходящите обаждания от номерата на връзката се осъществяват към вашия SIP домейн с вашите идентификационни данни, а входящите обаждания към тези номера се приемат от всеки адрес, освен ако не попълните незадължителното поле Разрешени IP адреси на източника. Попълвайте го само ако вашият доставчик публикува фиксирани IP адреси за сигнализация: грешен или непълен списък кара ThunderPhone да отхвърля входящите обаждания на вашия доставчик. Два бутона извършват основната работа:

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

По-късното редактиране на връзка стартира отново същата проверка за променените настройки, преди да бъде запазено каквото и да е, след което изгражда trunk връзката наново и потвърждава отново всеки номер във връзката с кратко тестово обаждане във фонов режим — номерата се показват като Подготвяне, докато тестовото им обаждане не завърши успешно. Промяната само на Разрешени IP адреси на източника за Свързана връзка е различна: тя никога не засяга изходящите обаждания, затова ThunderPhone актуализира списъка на входящата trunk връзка веднага и номерата остават Активни. Тестът за входящо обаждане се нулира на нетествано; стартирайте го отново или осъществете реално обаждане през вашия доставчик, за да потвърдите, че новият списък допуска обажданията. Тестът е неуспешен, когато неговото обаждане би било отхвърлено според списъка. Запазените пароли никога не се показват отново; оставете полето за парола празно, за да я запазите, или отметнете „Премахване на запазената парола“ за trunk връзка с IP удостоверяване.

Разрешаване по IP адреси и удостоверяване на trunk връзка

Някои оператори (DIDWW, Telnyx връзки с IP удостоверяване, повечето PBX системи зад защитна стена) приемат SIP трафик само от адреси, които сте добавили в списък с разрешени, или удостоверяват изходящите обаждания по IP адрес на източника. ThunderPhone използва два набора от адреси.

SIP граничен сървър. Входящите обаждания, които изпращате към sip.thunderphone.com, преминават през SIP граничния сървър на ThunderPhone, който пренася само SIP сигнализация. Първият INVITE отива към sip.thunderphone.com; останалата част от сигнализацията на обаждането (ACK, прекратяване, прехвърляния) се осъществява между Вашия оператор и граничния сървър, приел обаждането — sip-1 или sip-2. Ако защитната Ви стена филтрира SIP сигнализацията, разрешете и трите адреса на UDP и TCP порт 5060 и TLS порт 5061:

ХостIP адрес
sip.thunderphone.com172.170.39.202
sip-1.thunderphone.com13.86.104.121
sip-2.thunderphone.com20.80.98.90

LiveKit Cloud. Аудиото (RTP) на всяко обаждане и SIP сигнализацията на изходящите обаждания се осъществяват между Вашия оператор и LiveKit Cloud, никога през SIP граничния сървър. Разрешете всеки диапазон по-долу както за SIP сигнализация, така и за медия:

IP диапазон
143.223.88.0/21
161.115.160.0/19
153.57.128.0/18

LiveKit прилага тези диапазони към Realtime, SIP сигнализацията и мултимедията, както и към уебхуковете, и те обхващат обажданията, обработвани в регионите му в Канада, ЕС, Индия, Япония и САЩ. Имена на региони за фиксирана крайна точка: canada, eu, india, japan, us.

Няколко основни правила за самата trunk връзка:

  • 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 отговаря „Номерът на местоназначението е в черния списък на плана за маршрутизиране“), номерът се показва като Потвърден · доставчикът приема: той е използваем, но обажданията до други местоназначения не са тествани. Това обаждане доказва, че вашият транк може да извършва обаждания като номера; не е доказателство, че притежавате номера, и не тества обаждания до номера; това прави незадължителният входящ тест по-долу.

Ръчните SIP номера извън САЩ и Канада се потвърждават различно: номерът се обажда сам на себе си през вашия SIP транк. Това е вътрешно обаждане, така че транк, блокиран за международни обаждания, все пак може да бъде потвърден. Ако вашето входящо маршрутизиране сочи към ThunderPhone, обаждането се връща директно и ThunderPhone го прекратява, преди някой да отговори; това едно обаждане доказва, че обажданията работят и в двете посоки, а входящият тест на номера също се записва като успешен. Ако обажданията на номера отиват другаде, този телефон може да звъни до 25 секунди; ако нещо отговори, изходящите обаждания все пак се считат за потвърдени. Ако вашият доставчик откаже самообаждането по начин, който не казва нищо за вашия акаунт (заето, няма маршрут до номера, няма отговор), ThunderPhone вместо това се обажда на собствения си тестов номер. Отказ след дълга пауза обикновено означава, че вашият доставчик първо е пуснал записано съобщение, например за липса на кредит или блокирано местоназначение; причината го посочва. Потвърдените номера поддържат входящи и изходящи обаждания — което отключва изходящи кампании и програмни изходящи обаждания.

Тест на входящо обаждане

Потвърдете номер отваря диалогов прозорец, който може също да тества входящи обаждания. Тестът извършва обаждане до Вашия номер, проверява дали обаждането достига до ThunderPhone, след което прекъсва, без да стартира Вашия агент:

  • Номера със собствен изходящ SIP trunk (ръчно добавени SIP номера и Twilio номера, след като ThunderPhone конфигурира изходящи обаждания във Вашия Twilio акаунт) първо се обаждат на себе си: ThunderPhone набира номера от самия номер чрез този trunk. Диалоговият прозорец Ви уведомява, преди да осъществи обаждането. Обаждането излиза през Вашия доставчик и, ако маршрутизирането на входящите обаждания е правилно, се връща директно към ThunderPhone. Когато се върне с идентификатора на обаждащия се на самия номер, това едно обаждане доказва както че Вашият доставчик приема обажданията на ThunderPhone като извършени от този номер, така и че обажданията към номера достигат до ThunderPhone във всяка държава. Някои доставчици отказват или не свързват обаждане от номер към самия него; това не казва нищо за Вашето маршрутизиране, затова ThunderPhone вместо това се обажда от един от собствените си номера. Ако Вашият номер препраща към друго място, този телефон може да звънне два пъти: първо с идентификатора на обаждащия се на самия номер, след това с тестовия номер на ThunderPhone. Извън САЩ и Канада не може да се извърши обаждане след самообаждането, така че телефонът звъни веднъж за до 25 секунди.
  • Други номера (и резервният вариант по-горе) получават обаждане от един от собствените номера на ThunderPhone. Засега ThunderPhone може да извършва тези обаждания само към номера в САЩ и Канада; за други номера тестът показва, че не може да бъде изпълнен, заедно с отговора на Вашия доставчик, ако самообаждането е било отказано.

Ако Вашият оператор промени идентификатора на обаждащия се по пътя, ThunderPhone не може да разпознае обаждането, така че Вашият агент може да му отговори за кратко. Входящият тест не е задължителен. Пропуснете го и номерът ще продължи да работи; страницата с телефонни номера тогава показва Входящите не са тествани, а можете да го изпълните по-късно с Тест или чрез елемента от менюто на номера Тест на входящи обаждания. Веднага след импортиране страницата с телефонни номера също Ви подканва да тествате входящите обаждания за новите номера. Не се набира нищо, докато не потвърдите в диалоговия прозорец.

Ако Вашият доставчик изпраща номера другаде, това, към което сочи, може да звъни до 8 секунди за всяко обаждане, преди ThunderPhone да прекъсне. Ако нещо отговори първо (приложение Twilio, което отговаря и след това пренасочва, телефонно меню), тестът изчаква пренасоченото обаждане да достигне ThunderPhone: до 8 секунди при обаждане към самия номер и 15 секунди при обаждане от номер на ThunderPhone. Резултатът остава за номера (Входящите успешно или неуспешно) докато не промените връзката или не импортирате номера отново, което го връща на не е тествано. Промяната на връзка проверява отново изходящите обаждания във фонов режим, но никога не се обажда на Вашия номер без да Ви пита.

Отстраняване на проблеми с входящи обаждания

Бутонът Тест на връзката проверява идентификационните данни, а потвърждаването проверява изходящото набиране. За да проверите входящите обаждания, изпълнете теста за входящо обаждане по-горе или се обадете на номера от телефон и потърсете обаждането в История на обажданията. Тестовете Разговор в браузъра и симулациите между ботове не преминават през вашия оператор, затова не показват дали входящите обаждания работят. Симулация, насочена към телефонния номер (SIP loopback), набира номера през вашия оператор, така че при отговор се проверява маршрутизирането на входящите обаждания.

  • Чувате съобщение от собствения си мобилен оператор (например „Добре дошли във Verizon“ или „номерът, който сте набрали, не е в услуга“): обаждането е неуспешно, преди да достигне ThunderPhone. Проверете дали номерът е активен във вашия акаунт при доставчика и е присвоен към връзката или транка на ThunderPhone.
  • Сигнал „заето“ или обаждането звъни без отговор: доставчикът е приел обаждането, но не е успял да го достави. При Telnyx проверете Връзката на номера в портала на Telnyx: тя трябва да е FQDN връзката thunderphone-…, описана по-горе, или ваша собствена FQDN връзка, насочена към SIP крайна точка на ThunderPhone. При Twilio номерът трябва да е свързан към SIP транка на ThunderPhone, а не към Voice webhook или 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 е присвоил номера.


Следващи стъпки