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

• Table of contents
• Интеграция с 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.
На текущий момент Smartswitch может отправлять следующие уведомления:

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

Принимать команды от пользователей и выводить отчет интерактивно.¶

На текущий момент Smartswitch понимает следующие команды:

• /balance
  Отображает текущий баланс выбранной Компании или Пользователя.
• /profit
  Отображает прибыль по выбранной Компании или Пользователя за выбранный интервал времени.
  По вводу данной команды в Telegram чате, бот предложит выбрать пир.
  После выбора пира, бот предложит выбрать интервал времени, за которой генерировать отчет.
  После выбора интервала времени, бот отобразит прибыль и маржу, сгруппированную по E.164 кодам.
  Для активации данной функции требуется указать для Telegram чата список доступных пиров.
• /status
  Отображает прибыль по выбранной Компании или Пользователя за выбранный интервал времени.
• /start
  Уведомляет бота, что ему разрешено отправлять уведомления (см. выше) в этот чат.
• /stop
  Уведомляет бота, что ему запрещено отправлять уведомления (см. выше) в этот чат.

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

English translation