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

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

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

Нажмите Новое подключение и выберите один из 2 вариантов: Подключить провайдера, которым вы уже пользуетесь или Настроить новый аккаунт 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#

Эти 3 варианта открывают форму ручной настройки 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; затем задайте для каждого номера тип приложения этого транка.

В результате создаётся ручное 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, большинство УАТС за межсетевым экраном) принимают 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-замыкание), выполняет набор через вашего оператора, поэтому отвеченный вызов проверяет маршрутизацию входящих вызовов.

• Вы слышите сообщение своего мобильного оператора (например, «Добро пожаловать в 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 назначил номер.

Следующие шаги#