Підключіть VoIP-провайдера

Підключіть провайдера, яким ви вже користуєтеся (Twilio або Telnyx за ключем API; SignalWire, Vonage, Plivo або будь-який SIP-транк через SIP), або відкрийте новий обліковий запис Telnyx із покроковим налаштуванням.

Продакшн-трафік має працювати на номерах, які належать вам і використовуються через вашого VoIP-провайдера. На сторінці панелі керування Підключення → VoIP (/dashboard/voip-connections) можна підключити обліковий запис провайдера; після підключення імпортуйте номери, що підтримують як вхідні, так і вихідні дзвінки.

Натисніть Нове підключення і виберіть один із двох варіантів: Підключити постачальника, яким ви вже користуєтеся або Налаштувати новий обліковий запис Telnyx.

Підключіть провайдера, яким ви вже користуєтеся#

Виберіть провайдера, у якого розміщені ваші номери:

Для Twilio і Telnyx вставте облікові дані та натисніть Підключити й протестувати. ThunderPhone перевірить їх і налаштує сторону провайдера за вас. Для Telnyx ThunderPhone додає до вашого облікового запису Telnyx власне SIP-підключення (з назвою 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 створіть транк із обліковими даними для вихідних дзвінків, введіть його домен (наприклад, your-trunk.sip-us.vonage.com) і облікові дані, додайте SIP-ендпойнт ThunderPhone як вхідний SIP URI транка та прив’яжіть свої номери до транка.
• Plivo: створіть вихідний транк з обліковими даними та введіть його Termination SIP Domain (<trunk-id>.zt.plivo.com), ім’я користувача та пароль; створіть вхідний транк, у якому Primary URI — це SIP-ендпойнт ThunderPhone із доданим ;transport=tcp; потім установіть для кожного номера Application Type цього транка.

Результатом буде ручне SIP-підключення (provider: "manual" в API), протестоване та перевірене так само, як підключення, введене вручну. На картці підключення відображається назва провайдера, наприклад SignalWire · SIP.

Налаштування нового облікового запису Telnyx#

Ще немає провайдера? Покроковий процес допоможе вам відкрити обліковий запис Telnyx і підключити його:

1. Створіть обліковий запис

   Натисніть Відкрити реєстрацію Telnyx, створіть обліковий запис і позначте «Я створив(-ла) обліковий запис».

2. Отримайте ключ API

   Натисніть Відкрити сторінку ключів API, згенеруйте ключ і вставте його в Ключ API (v2). За потреби вкажіть назву підключення.

3. Підключіть і протестуйте

   Натисніть Підключити й протестувати — ThunderPhone перевірить облікові дані та налаштує на стороні Telnyx усе необхідне перед збереженням.

Що ThunderPhone налаштовує в Telnyx#

Якщо ви не введете власний ідентифікатор з’єднання, обидва способи Telnyx (покрокове налаштування та вставлення ключа API) створюють у вашому обліковому записі Telnyx однакову конфігурацію: одне SIP-з’єднання з назвою thunderphone-<your organization id>. Це FQDN-з’єднання, FQDN-запис якого вказує на SIP-ендпойнт ThunderPhone, і кожен імпортований номер призначається йому. Telnyx надсилає виклики на ці номери безпосередньо до ThunderPhone через SIP.

• Його поля вебхуків навмисно залишено порожніми. Не використовуються вебхук, застосунок Call Control, застосунок TeXML або зареєстрований SIP-телефон.
• Не переносіть імпортовані номери до іншого з’єднання чи застосунку та не реєструйте пристрій для цього з’єднання.
• Якщо під час підключення ви ввели власний ідентифікатор з’єднання, ThunderPhone використовує це з’єднання й ніколи його не змінює; це має бути FQDN- з’єднання, що вказує на SIP-ендпойнт ThunderPhone.

До 30 серпня 2026 року з’єднання thunderphone-…, створене ThunderPhone, було з’єднанням облікових даних, яке не може приймати виклики. Якщо ваше з’єднання досі відображається як з’єднання облікових даних, зверніться до служби підтримки, і ми його перетворимо.

Ручне налаштування SIP#

Плитки SignalWire, Vonage і Plivo відкривають цю форму, як і пункт Я введу всі налаштування самостійно в розділі Інший постачальник. Підійде будь-який SIP-транк, зокрема DIDWW або АТС, якою ви керуєте самостійно. Введіть назву підключення, домен 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 відхилятиме вхідні виклики від вашого оператора. Дві кнопки виконують основну роботу:

• Створити посібник із налаштування ШІ — створює інструкції для конкретного провайдера щодо потрібного налаштування на стороні транка.
• Перевірити та зберегти підключення — перевіряє, що SIP-кінцева точка розв’язується в публічну адресу та, для TCP/TLS, приймає підключення на вибраному порту (для UDP-хостів виконується лише перевірка DNS), а потім зберігає підключення. Поки що вона не може здійснити дзвінок, оскільки підключення не має номерів; фактичне підтвердження відбувається під час імпорту (нижче).

Подальше редагування підключення повторно запускає ту саму перевірку для змінених налаштувань перед збереженням, а потім перебудовує транк і повторно перевіряє кожен номер підключення коротким тестовим викликом у фоновому режимі — номери відображаються зі статусом Налаштування, доки їхній тестовий виклик не завершиться успішно. Зміна лише Дозволених IP-адрес джерел у підключенні зі статусом Підключено відрізняється: вона ніколи не впливає на вихідні виклики, тому ThunderPhone одразу оновлює список на вхідному транку, а номери залишаються Активними. Перевірка їхніх вхідних викликів скидається до статусу не перевірено; запустіть її знову або здійсніть реальний виклик через свого оператора, щоб підтвердити, що новий список пропускає виклики. Перевірка завершується помилкою, якщо її виклик було б відхилено відповідно до списку. Збережені паролі ніколи не відображаються; залиште поле пароля порожнім, щоб зберегти його, або позначте «Видалити збережений пароль» для транка з автентифікацією за IP-адресою.

Додавання IP-адрес до списку дозволених і автентифікація транка#

Деякі оператори (DIDWW, IP-автентифіковані підключення Telnyx, більшість 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:

LiveKit Cloud. Аудіо (RTP) кожного виклику та SIP-сигналізація вихідних викликів передаються між вашим оператором і LiveKit Cloud, ніколи не через периферійний вузол SIP. Дозвольте кожен діапазон нижче для SIP-сигналізації та медіа:

LiveKit застосовує ці діапазони до Realtime, SIP-сигналізації та медіа, а також вебхуків; вони охоплюють дзвінки, що обробляються в його регіонах Канади, ЄС, Індії, Японії та США. Назви регіонів для закріпленої кінцевої точки: 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 loopback), здійснює дзвінок через вашого оператора, тому відповідь на такий дзвінок перевіряє маршрутизацію вхідних дзвінків.

• Ви чуєте повідомлення свого мобільного оператора (наприклад, «Ласкаво просимо до Verizon» або «номер, на який ви телефонуєте, не обслуговується»): дзвінок не дійшов до ThunderPhone. Переконайтеся, що номер активний у вашому обліковому записі провайдера та призначений підключенню або транку ThunderPhone.
• Сигнал зайнято або дзвінок не отримує відповіді: провайдер прийняв дзвінок, але не зміг доставити його. Для Telnyx перевірте Підключення номера на порталі Telnyx: це має бути описане вище FQDN-підключення thunderphone-… або ваше власне FQDN-підключення, що вказує на SIP-ендпойнт ThunderPhone. Для Twilio номер має бути приєднаний до SIP-транку ThunderPhone, а не до вебхука 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 призначає номер.

Наступні кроки#