Настройка шлюза

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

Picture

Выберите режим

Picture

Нажмите войти

Для работы в режиме шлюза выберите SIP-шлюз в главном меню бота. Сервис попросит предоставить номер телефона, чтобы авторизоваться.

В целях безопасности мы не запрашиваем пароль двухэтапной аутентификации. При активной двухэтапной аутентификации сессия Telegram для SIP.tg может быть создана только если был указан резервный email: на него придёт код подтверждения. В противном случае на время создания сессии двухэтапную аутентификацию необходимо отключить, а после создания сессии её можно будет включить снова.

После этого вы попадёте в главное меню режима SIP-шлюз. Вы сможете настроить входящий и исходящий шлюз, а также активировать и деактивировать DTMF.

Сервис может быть настроен и на входящий, и на исходящий режим одновременно.

Входящий шлюз

Нажмите Новый вх., чтобы создать входящий шлюз. Сервис пришлет в сообщении логин, пароль и адрес сервера, которые нужно указать в настройках транка вашей ВАТС. В транке должна быть включена опция регистрации на сервере — обычно это соответствует типу транка, разрешающему входящие и исходящие звонки.

Мы боремся с перебором паролей и атаками

Пожалуйста, будьте внимательны при редактировании настроек.

IP-адрес, с которого производится подключение, может быть заблокирован на произвольный период времени, если вы подключитесь к серверу sip. tg с неправильными настройками: без включенной опции регистрации, с неправильным логином или паролем, с недоверенного IP и тому подобное.

Отобразить текущие данные авторизации аккаунта

Сгенерировать новый пароль для аккаунта

Изменение состава и приоритета используемых аудио кодеков

Аудио кодеки

Изменение состава и приоритета используемых методов DTMF

DTMF методы

IP-адреса, с которых разрешено подключение к аккаунту; если список пуст, то данная возможность не используется

Правила преобразования номера телефона перед передачей его в ВАТС

Преобразование номера

Отображаемое имя оператора

Отключение аккаунта и удаление связанных с ним данных

Выберите клавиши ниже,
чтобы увидеть описание

Аудио кодеки

DTMF методы

О правилах преобразования номеров

Исходящий шлюз

В режиме исходящего шлюза один из наших серверов работает как клиент. Он подключается к ВАТС, которая играет роль сервера.

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

Изменение текущего логина аккаунта

Изменение текущего пароля аккаунта

Изменение текущего сервера регистрации аккаунта

Значение домена в поле From в исходящих к серверу виртуальной АТС запросах

Используемый на виртуальной АТС номер для обработки входящих звонков из Telegram

Правила преобразования номера телефона перед передачей его виртуальной АТС

Преобразование номера

Изменение состава и приоритета используемых аудио кодеков

Аудио кодеки

Изменение состава и приоритета используемых методов DTMF

DTMF методы

Отображаемое имя аккаунта шлюза

Отключение аккаунта и удаление связанных с ним данных

Выберите клавиши ниже,
чтобы увидеть описание

После изменения настроек шлюза, нажмите Применить. Если при подключении к шлюзу произойдет сбой, сервис пришлет код ошибки и её описание. Если вы не нажали кнопку, настройки будут применены автоматически через 5 минут.

Аудио кодеки

DTMF методы

Коды ошибок

О правилах преобразования номеров

Состояние аккаунтов шлюза

Созданные шлюзы будут сохранены в меню SIP-шлюз. Вы можете видеть два статуса:

Шлюз отключен.

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

Для входящего шлюза — если ВАТС не зарегистрировалась на нашем сервере.

Шлюз подключен.

Как звонить и принимать звонки

Входящие и исходящие звонки происходят одинаково, независимо от способа подключения к АТС. При входящем звонке виртуальной АТС передается номер и имя звонящего пользователя Телеграм, а для исходящего звонка достаточно набрать номер пользователя Телеграм. В качестве номера пользователя можно использовать одно из трех значений:

  • реальный номер телефона пользователя, привязанный к аккаунту;
  • username пользователя;
  • ID пользователя.

Если о пользователе известна только часть данных, при входящем в качестве номера указываются первое из доступных значений: номер телефона, username или ID. Если номер телефона пользователя неизвестен, то в качестве номера будет использован username. Если у пользователя не известен ни номер телефона, ни username, то в качестве номера будет указан ID.

Позвонить пользователю по ID можно, если до этого было прямое или косвенное взаимодействие: обмен сообщениями, предыдущие звонки.

Перезвонить

При исходящем звонке после разговора DTMF-клавиатура удаляется, и сервис присылает кнопку Перезвонить. Также в сообщении может содержаться код статуса завершения звонка.

Чтобы отключить функцию, просто отключите DTMF-клавиатуру.

Коды ошибок

Особенности работы шлюза

Особенности работы шлюза

Задержка при звонках

Только при звонках из ВАТС в Telegram

Вы можете испытывать задержку, когда звоните оффлайн-пользователю. Это обусловлено одной особенностью Telegram.

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

Технология Push помогает принудительно вызвать пользователя в сеть. Он получает уведомление о входящем звонке в Телеграм и в этот момент появляется в онлайне, даже если не заходит в приложение. Такой подход помогает приложению значительно экономить заряд батареи.

Время между звонком и получением Push-уведомления не регламентировано. Если телефон не в сети, пользователь может вовсе не получить уведомление. Поэтому определение времени ожидания появления пользователя в сети зависит от задач использования шлюза и подлежит настройке на стороне вашей виртуальной АТС.

Текущее значение таймаута — 15 секунд.

Ограничения Telegram: защита от флуда

При большой нагрузке на сервера Telegram может срабатывать защита от флуда. Для этого вводится искусственное ограничение на использование всех или некоторых вызовов Telegram API. Если задержка ограничения — до 5 секунд, данный запрос к API повторяется автоматически. Иначе запрос завершается ошибкой, которая передается в SIP в виде кода 503 Service Unavailable. В соответствии с RFC 3261, также будет передаваться заголовок Retry-After, содержащий значение в секундах, через которое запрос может быть отправлен заново.