Пользовательские функции при звонках на аккаунт Шлюза

Звонки между Telegram-пользователями и аккаунтом Шлюза отображаются в чатах в виде специальных виджетов.

По каждому звонку показывается направление, статус завершения, длительность, а также кнопки «Перезвонить» и «Линии», если они активированы в настройках Шлюза.

Есть возможность ввода пользователем номера вызываемого абонента на стороне АТС и мгновенного получения звонка через Callback, а также использования при звонке DTMF клавиатуры для взаимодействия с голосовым меню АТС или для ввода добавочного номера сотрудника.

Все описанные выше функции подключаются и настраиваются с основного интерфейса /gateway бота @siptg_bot обозначенным выше набором кнопок.

Кнопка «Перезвонить» активирована по умолчанию. По нажатию на нее пользователем исходящий звонок в АТС будет идти через тот же SIP-аккаунт, что и был в истории вызова.

Кнопка «Линии» позволяет выбрать SIP-аккаунт (по его имени) на который будет совершен исходящий звонок пользователем. Функция также подключается в настройках Шлюза (по умолчанию выключена).

Иногда удобно настроить несколько SIP-аккаунтов для Шлюза и представить каждый из них пользователям как доступные Линии для звонка (вместо использования нескольких аккаунтов шлюзов или переадресации звонков на уровне АТС, например, через DTMF).

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

Например, чтобы совсем запретить исходящие вызовы через шлюз с определенного SIP-аккаунта можно добавить ему в правила преобразования выражение: ^$ (требуется чтобы номер был пустым).

Подробнее об использовании правил преобразования номеров

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

Отображение DTMF клавиатуры при входящих и исходящих вызовах настраивается двумя соответствующими кнопками в настройках Шлюза.

Подробнее о настройке DTMF клавиатуры

Если активировать обработку текстовых сообщений проходящих через аккаунт шлюза (по умолчанию шлюзом производится только обработка звонков), то становится доступен режим звонков по принципу Callback.

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

По умолчанию обработка текстовых сообщений отключена. Она включается нажатием на кнопку «Обр. сообщ.» в настройках шлюза. Затем появится кнопка «Callback» на которой надо поставить галочку.

Подробнее об использовании правил преобразования номеров

Еще одна функция, доступная после активации режима обработки сообщений, это Автоответ.

Суть функции в том, что если какой либо пользователь напишет текстовое сообщение аккаунту шлюза, то он сразу же получит в ответ заданное текстовое сообщение.

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

По умолчанию обработка текстовых сообщений ботом отключена. Она включается нажатием на кнопку «Обр. сообщ.» в настройках шлюза. Затем появляется кнопка «Автоответ» по нажатию на которую надо задать сообщение для автоответа.

Функция Автоответчика работает только если корректно настроена одна линия (SIP-аккаунт) для приема звонков через Шлюз.

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

Допустимые в сообщении переменные:

Telegram-username аккаунта шлюза;

Запрашиваемый на стороне АТС номер после преобразования через правила;

Имя доступной Линии для звонка (имя SIP-аккаунта, показывается только если возможен единственный выбор).

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

Чтобы отключить функцию, отправьте в качестве сообщения автоответчика один любой символ.

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