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

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

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

# Создать бота средствами Telegram (см. "Как создать Telegram бота":https://tlgrm.ru/docs/bots#kak-sozdat-bota).
  Записать его *токен*.
# Создать групповой чат средствами Telegram.
  Добавить в этот групповой чат бот *Get My Id*.
  Получить от этого бота *ID чата*.
  Записать *ID чата*.
  Удалить бот *Get My Id* из группового чата.
# В веб-интерфейсе Smartswitch добавить Telegram бот и указать его *токен*, полученный в п.1.
# В веб-интерфейсе Smartswitch добавить Telegram чат и указать его *ID*, полученный в п.2.
# В Telegram в групповой чат добавить бот, созданный в п.1.

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

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

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

[[Integration with telegram|English translation]]