Настройка Шлюза на стороне @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://files.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

Проверка работы VoIP Trunk между Telegram и SIP-АТС
Укажите в каком виде на АТС должен передаваться номер звонящего абонента. Можно задать приоритет значений, а также префикс или суффикс перед значением, чтобы отличать звонки пришедшие через Телеграм от обычных звонков.

Для Caller-ID доступно 3 значения:
  • userid (рекомендуем использовать как основной, внутренний Telegram-id пользователя, есть всегда)
  • username (латиница и цифры, может быть не установлен у пользователя)
  • phone (телефонный номер, привязанный к аккаунту, может быть скрыт настройками приватности)
Также можно указать что передавать на АТС в качестве поля Caller-Name.

На этапе первичной настройки этот шаг можно пропустить.

Важно! Если указывается префикс или суффикс для Caller-ID, то при совершении исходящих звонков с АТС в Телеграм их необходимо сохранить.

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

Проверка работы VoIP Trunk между Telegram и SIP-АТС
Укажите должна ли пользователю показываться DTMF клавиатура при исходящих и входящих звонках с аккаунтом Шлюза, кнопки Перезвонить и выбора Линий, а также должна ли происходить обработка текстовых сообщений (для функции Автоответ и звонков методом Callback).

На этапе первичной настройки этот шаг можно пропустить.

Подробнее о настройке пользовательских функций

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

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

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

Тариф Gateway-Start с двумя линиями для параллельных звонков можно подключить самостоятельно. При необходимости, максимальное число линий для параллельных звонков может быть увеличено по запросу.

Для подключения тарифа Gateway-Business (от 10 линий) и расчета его стоимости обратитесь в службу поддержки. В рамках тарифа Gateway-Business предоставляется приоритетная техническая поддержка и консультации на этапе внедрения.
Порядок оплаты тарифа
Для оплаты необходимо:

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

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

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

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


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

Что видят пользователи при звонках на единый Telegram-аккаунт через SIP.TG, набор доступных для них функций (DTMF, Автоответ, выбор Линии, кнопка Перезвонить, указание внутреннего номера и звонок через Callback)

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

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

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

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

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