Настройка Шлюза на стороне @siptg_bot

Через Telegram-шлюз в АТС возможно принимать и совершать одновременные параллельные звонки через единый Telegram-аккаунт компании (до 100 одновременных линий).

Подключение происходит в виде стандартного SIP-транка (VoIP) в любую офисную или облачную SIP-АТС, откуда по нужной логике звонки распределяются между сотрудниками или пользователями АТС.

Идеальное решение для отделов продаж и поддержки компаний ведущих коммуникацию с клиентами через Telegram.

Шаг 1: Выбор Telegram-аккаунта для подключения

Настройка Telegram-аккаунта для подключения шлюза для звонков в SIP-АТС
  • Определитесь с Telegram-аккаунтом, который необходимо настроить для переадресации входящих звонков с него в вашу SIP-АТС и/или осуществления исходящих звонков в Telegram (подключать Шлюз можно как непосредственно с аккаунта, на котором он должен работать, так и с аккаунта администратора)
  • Обратитесь с аккаунта администратора к боту @siptg_bot. Если бот еще не активирован, запустите его командой /start
  • Для настройки функции Шлюза наберите команду /gateway или выберите ее из меню бота.

Шаг 2: Подключение виртуального устройства

Настройка хранилища сессий Telegram-аккаунтов для подключения шлюза для звонков в SIP-АТС
Позвольте @siptg_bot создать и подключить виртуальное устройство привязанное к нужному Telegram-аккаунту для переадресации звонков с него. Данная процедура запускается нажатием на кнопку «Подключить» и происходит в 3 шага:

  • Укажите телефонный номер Телеграм-аккаунта для звонков (к которому подключается Шлюз)
  • Выберите используемое Хранилище сессий для подключаемого устройства (по умолчанию используется защищенное облачное Хранилище SIP.TG, самый быстрый и простой вариант)
  • Укажите боту код с официального аккаунта Telegram для привязки устройства (код придёт на аккаунт, к которому подключается Шлюз)
Варианты использования Хранилища сессий
В случае использования облачного Хранилища сессий от SIP.TG от вас не потребуется никаких действий, этот вариант выбран по умолчанию на соответствующем шаге подключения виртуального устройства.

Подключаемое устройство используется исключительно для перенаправления звонков (если только явно не включается соответствующий режим обработки сообщений ботом, например, для функции текстового Автоответа).

После подключения все сессии виртуальных устройств для аккаунтов клиентов хранятся на наших защищенных серверах.

В случае наличия особых требований по конфиденциальности хранимых сессий аккаунтов можно установить собственное Хранилище сессий, произвести настройку соответствующего модуля, после чего выбирать его при создании сессии виртуального устройства. Протестировать подключение своего Хранилища сессий можно как на платных, так и на бесплатных тарифах.

Подробнее об установке собственного Хранилища Сессий
Примечание относительно 2FA (двухфакторной аутентификации)
При подключенной двухэтапной аутентификации новая сессия Telegram для виртуального устройства SIP.TG может быть создана только если в качестве второго способа подтверждения был указан резервный email, тогда на него придёт код подтверждения.

В целях безопасности мы не запрашиваем пароль к 2FA от Telegram-аккаунта к которому подключается Шлюз, но вынуждены его сменить после подключения устройства, новый пароль для 2FA будет сгенерирован для аккаунта шлюза автоматически и показан ботом, а также выслан на указанный email.

При использовании других методов 2FA на время создания сессии двухэтапную аутентификацию необходимо отключить, а после создания сессии её можно будет включить снова.

Шаг 3: Настройка регистрации с SIP-АТС (создание VoIP SIP-Trunk)

Настройка VoIP Trunk между Telegram и SIP-АТС
SIP-узлом для установления связи с вашей АТС является один из наших Worker-серверов, именно с ними создается VoIP SIP-Trunk.

Worker-сервера производят конвертацию и передачу голосового потока между Telegram и вашей SIP-АТС.

Возможны 3 способа регистрации между Worker-серверами SIP.TG и вашей SIP-АТС:
PBX->SIP.TG (АТС регистрируется на Worker, самый частый метод)

В этом случае у бота надо получить реквизиты SIP-аккаунта, которые затем необходимо указать на АТС для регистрации при подключении транка.
Настройка VoIP Trunk между Telegram и SIP-АТС
SIP.TG->PBX (Worker регистрируется на АТС)

  • В этом случае боту необходимо указать реквизиты SIP-аккаунта на стороне АТС.
  • Актуальный список IP-адресов наших серверов расположен по данной ссылке, их необходимо добавить в white-лист firewall для АТС.
  • После сохранения реквизитов АТС для активации регистрации надо нажать кнопку включения.
Настройка VoIP Trunk между Telegram и SIP-АТС с регистрацией
IP<->IP (связь Worker и АТС без регистрации)

  • В этом случае с АТС необходимо инициировать звонок по IP адресу и порту полученному от бота для подтверждения IP адреса АТС.
  • После сохранения реквизитов АТС для активации регистрации надо нажать кнопку включения.
  • Для идентификации нескольких SIP-аккаунтов данного типа, размещенных на одном IP адресе, предусмотрена дополнительная идентификация на основе произвольного поля и его значения в SIP-сообщении.
  • Обязательно указывайте поле Номер на АТС для получения входящих звонков на стороне АТС.
Настройка VoIP Trunk между Telegram и SIP-АТС без регистрации
Важное примечание про выбор Worker-сервера
  • В случае использования облачных серверов SIP.TG выбирать Worker сервер стоит в своей стране.
  • Если в вашей стране нет Worker-сервера, а регистрация с выбранным вами сервером не проходит, попробуйте сменить его и повторить попытку регистрации.
  • Вы можете использовать свой Worker-сервер, после установки и настройки администратор аккаунта сможет его выбирать (подробнее об установке своих модулей).
Установка своего набора кодеков и способа передачи DTMF
По умолчанию для связи с серверами SIP.TG установлен следующий набор кодеков – opus,g722/16000,alaw,mulaw,g729.

В качестве метода передачи DTMF сигналов по умолчанию используется RFC2833, но поддерживаются также методы inband и INFO.

Оба значения могут быть изменены при необходимости.

Подробнее о настройке кодеков
Подробнее о способах передачи DTMF
Настройки Firewall на стороне АТС
Если Вы используете Firewall для защиты своей АТС, убедитесь, что актуальные адреса наших Worker-серверов, с которых происходит подключение к АТС, присутствуют в white-листе.

Все IP-адреса наших серверов перечислены в файле:
https://www.sip.tg/fw.txt

Иногда сеть Worker-серверов обновляется, об этом мы сообщаем в новостном канале @siptg_news (рекомендуем администраторам на него подписаться).
Об инфраструктуре Worker-серверов
Инфраструктура Worker-серверов SIP.TG надежно защищена, сервера при необходимости быстро масштабируются, расположены в разных географических зонах.

В случае необходимости, для всех привязанных SIP-аккаунтов можно указать конкретный Worker-сервер, в том числе расположенный на собственных серверах.

Для использования собственного Worker-сервера (или нескольких) установите и произведите настройку соответствующего модуля, после чего укажите его в настройках подключения (на бесплатных тарифных планах данная возможность НЕ предоставляется).

Подробнее об установке собственных Worker-серверов
Проверка состояния аккаунтов Шлюза
Созданные SIP-аккаунты для Шлюза будут сохранены в разделе /gateway, где для каждого аккаунта показывается его статус:

SIP-аккаунт шлюза отключен
  • Для PBX -> SIP.TG регистраций такой статус появляется, если АТС не зарегистрировалась на нашем сервере, был введен неверный логин или пароль, не корректно заполнены параметры подключения, нет доступа до Worker-серверов (заблокирован IP или есть проблемы сети)
  • Для SIP.TG -> PBX регистраций такой статус появляется, если введен неверный логин или пароль, не корректно заполнены параметры подключения, нет доступа до АТС (заблокирован IP или есть проблемы сети), либо он был отключен вручную.
  • Для IP <-> IP подключений это означает что SIP-аккаунт на АТС не активен (в этом режиме используется UDP, постоянного соединения нет)

SIP-аккаунт шлюза подключен
  • Шлюз корректно настроен и готов к работе.
Блокировки IP адресов АТС за неверные пароли
Указывайте реквизиты подключения к серверам SIP.TG аккуратно. У нас активирована защита от перебора паролей, поэтому IP-адрес АТС может быть заблокирован на произвольный период времени, если он подключается к серверам SIP.TG без включенной опции регистрации, с неправильным логином или паролем, с недоверенного IP и тому подобное.
Ограничение на число SIP-аккаунтов для одного Шлюза
У режима Шлюз по умолчанию есть ограничение на количество подключаемых SIP-аккаунтов в 10 штук. В редких случаях для распределения значительной нагрузки это число может понадобиться увеличить, для этого обращайтесь в службу поддержки.

Шаг 4: Проверка работы

Проверка работы VoIP Trunk между Telegram и SIP-АТС
Если все настройки внесены корректно, SIP-аккаунт отмечен зеленым индикатором, то Шлюз готов к работе.

После того, как на стороне АТС будет настроена соответствующая маршрутизация звонков, можете осуществить тестовые голосовые звонки на подключенный Telegram аккаунт и/или совершить звонок Telegram-пользователям с вашей АТС.

Подробнее про принцип настройки на стороне АТС

Шаг 5: Конфигурация Caller-ID и Caller-Name

**Раздел в подготовке, см бота*

Шаг 6: Конфигурация пользовательских функций

**Раздел в подготовке: Автоответ, DTMF, линии, кнопка Перезвонить, внутренние номера**

Шаг 7: Подключение платного тарифа

Тестирование на тарифах Бесплатный и Пробный
На тарифе Бесплатный (подключен по умолчанию) будут действовать следующие ограничения:
  • только 1 линия (параллельные звонки невозможны)
  • суммарно максимум 30 мин разговоров в месяц
  • максимальная продолжительность звонка 2 минуты

На тарифе Пробный предоставляется до 10 линий для одновременных звонков, все остальные ограничения снимаются, стоимость 100 руб/неделю. Данный тариф можно подключить только один раз, работает только 1 неделю.
Стоимость использования по тарифу Шлюз
Для оплаты используется тариф Шлюз, стоимость рассчитывается исходя из количества необходимых линий для параллельных звонков.

Стоимость одной линии составляет 600 руб/мес.

Линии продаются пакетами по 2, 5, 10,15, 20, 30 итд до 100 штук (при оплате за несколько месяцев предоставляются скидки, итоговая сумма показывается в интерфейсе).

При необходимости, максимальное число параллельных линий (100) может быть увеличено по запросу в службу поддержки.

Если вам нужна enterprise-лицензия пишите на info@sip.tg
Порядок оплаты тарифа Шлюз
Для оплаты необходимо:

  • Перейти в раздел /tariff бота @siptg_bot
  • Выбрать тариф Шлюз, перейти к настройке тарифа
  • Указать необходимые параметры:
Количество необходимых линий для параллельных звонков
Срок оплаты в месяцах (от 1 до 12)
Способ оплаты

  • Нажать на кнопку «Начать оплату», следовать указаниям виджета оплаты.

Подробнее о способах оплаты

Смотрите также


Позволяет принимать и совершать параллельные звонки через единый Telegram-аккаунт компании. Интеграция с офисной или облачной SIP-АТС.

Как через SIP.TG принимать звонки из Telegram на стороне АТС, а также совершать исходящие вызовы от имени единого Telegram-аккаунта компании

Что видят пользователи при звонках на единый Telegram-аккаунт через SIP.TG, набор доступных для них функций

Ограничения и специфика совершения голосовых звонков в Telegram через Шлюз SIP.TG

Как принимать голосовые звонки из Telegram, интеграция и подключение Шлюза

Особенности интеграции Шлюза SIP.TG для Telegram-звонков с CRM системами, прием входящих и совершение исходящих звонков Telegram-пользователям через АТС

Способы оплаты шлюза SIP.TG для переброски звонков между Telegram и SIP-телефонией

Частые проблемы и решения при настройке шлюза для звонков между Telegram и SIP-телефонией

Назначение, преимущества, порядок установки и настройки собственных Worker-серверов для SIP.TG

Назначение, преимущества, порядок установки и настройки собственного Хранилища сессий Telegram для SIP.TG