Интеграция с Telegram¶

Smartswitch позволяет выполнить интеграцию с Telegram для рассылки уведомлений и интерактивной генерации отчетов.
Для этого используется система групповых чатов и ботов Telegram.

Последовательность действий:

1. Создать бота средствами Telegram (см. Как создать Telegram бота).
   Записать его токен.
2. В веб-интерфейсе Smartswitch добавить Telegram бот и указать его токен, полученный в п.1.
3. Создать групповой чат средствами Telegram.
4. В Telegram в групповой чат добавить бот, созданный в п.1.
5. Получить ID чата отправив команду /start в групповой чат.
   Бот добавленный в п.1 ответит
   

     ChatID: -1002388910615
     

6. В веб-интерфейсе Smartswitch добавить Telegram чат и указать его ID, полученный в п.5.

• Отправлять уведомления от имени данного бота в указанный чат.
  На текущий момент Smartswitch может отправлять уведомления про убыток (см. Контроль убытка).
  Это может быть полезно, если Вы не используете Контроль прибыльности, для маршрутизации только прибыльных звонков.
  Соответственно, через Smartswitch могут проходить убыточные звонки.
  Контроль убытка может ограничивать максимальный убыток за период, блокируя трафик, который превышает лимиты по убытку.
  В такие моменты в Telegram чат могут отправляться уведомления, чтоб администратор мог среагировать на возникшую ситуацию.
  Для активации данной функции требуется указать для Контролёра убытка Telegram чат, в который отправлять уведомления,
  и Telegram бота, от имени которого отправлять данные уведомления.

• Принимать команды от пользователей и выводить отчет интерактивно.
  На текущий момент Smartswitch понимает команду "/profit".
  По вводу данной команды в Telegram чате, бот предложит выбрать пир.
  После выбора пира, бот предложит выбрать интервал времени, за которой генерировать отчет.
  После выбора интервала времени, бот отобразит прибыль и маржу, сгруппированную по E.164 кодам.
  Для активации данной функции требуется указать для Telegram чата список доступных пиров.

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

English translation