Плагин «Telegram»

1. Общая информация

Плагин «Telegram» (message_telegram) реализует в системе одноименный способ доставки сообщений (Рис. 1.1) и обеспечивает отправку уведомлений из СЭО 3КL в мессенджер «Телеграм».

Подключение этого канала обеспечит мгновенную доставку уведомлений пользователям среды электронного обучения без дополнительных финансовых затрат и программных средств*.
<sup>______________________________
* — подразумевается, что пользователи СЭО 3КL на своих мобильных устройствах уже имеют установленное приложение Telegram; все они обладают аккаунтами в мессенджере «Телеграм»; активно пользуются ими и оплачивают трафик мобильного интернета самостоятельно.</sup>

-Вернуться к содержанию-

1.1. Возможности

В курсе настроено индивидуальное занятие с согласованием даты проведения (Рис. 1.1.1).

Учащийся предлагает удобную ему дату проведения занятия (Рис. 1.1.2).

Преподаватель сразу же получает в чате мессенджера «Телеграм» уведомление об этом и может оперативно принять или отклонить предложенную дату (Рис. 1.1.3).

-Вернуться к содержанию-

2. Настройка

Для успешного функционирования канала доставки уведомлений Telegram необходимо, чтобы в системе были последовательно выполнены:

• глобальная настройка — в мессенджере «Телеграм» создан отдельный чат-бот для системы и данные о нем прописаны в настройках системы;
• пользовательская настройка — в личном аккаунте мессенджера «Телеграм» пользователя, которому необходимо получать уведомления, создан чат с ботом СЭО 3КL.

Для выполнения нижеописанных действий необходимо, чтобы пользователь, который выполняет настройку, имел активный аккаунт в мессенджере «Телеграм» и устройство (мобильный телефон, планшет, компьютер и т. п.) с установленным приложением Telegram, в котором этот пользователь авторизован. Возможны следующие варианты:

1) Браузер с доступом к вашей СЭО 3КL и приложение Telegram установлены (запущены) на одном устройстве. Самый удобный для настройки вариант. Все переходы к приложению будут выполняться автоматически, для ввода сгенерированного токена достаточно будет скопировать код из окна приложения и вставить его на странице настроек системы.

2) СЭО 3КL доступна на одном устройстве (например, стационарном компьютере), а приложение Telegram — на другом (например, мобильном телефоне). В этом случае, чат с ботом может быть создан и запущен в приложении вручную (по имени бота), токен — введен вручную или переслан по какому-то коммуникационному каналу со второго устройства на первое (например, по электронной почте).

-Вернуться к содержанию-

2.1. Глобальная настройка плагина

Страница глобальных настроек для еще ненастроенного плагина будет иметь следующий вид (Рис. 2.1.1):

Для создания бота для уведомлений СЭО 3КL необходимо:

1) Перейти по ссылке https://telegram.me/botfather (Рис. 2.1.2). Если приложение Telegram у вас  установлено на другом устройстве (например. на мобильном телефоне) — просто найти бота @BotFather (Рис. 2.1.3),  открыть/запустить чат с ним и перейти к пункту 3).

2) Нажать «SEND MESSAGE». Запустить открывшийся в приложении чат с ботом Telegram «Botfather» (Рис. 2.1.4).

3) В стартовом меню бота выбрать команду создания нового бота «/newbot» (Рис. 2.1.5).

4) После предложения выбрать имя для нового бота (поз. 1 Рис. 2.1.6) ввести имя для бота вашей системы. Введенное название впоследствии будет отображаться в поле «Название бота для сайта» глобальных настроек плагина (см. Рис. 2.1.1) и в заголовке чата бота в приложении (Рис. 2.2.6).

5) Ввести ник бота (см. поз. 2. Рис. 2.1.6). Ник бота обязательно должен заканчиваться на bot.

Если такой ник уже зарегистрирован в Телеграм, будет отображено сообщение:
Sorry, this username is already taken. Please try something different.

В этом случае необходимо указать другой ник бота для вашего сайта.

6) После успешного создания имени и ника, в чате отобразится сообщение с идентификатором бота (токеном) (см. поз. 3 Рис. 2.1.6). Строку идентификатора необходимо скопировать и вставить в поле «Токен бота для сайта» (Рис. 2.1.7).

Поля «Название бота для сайта» и «Ник бота для сайта» автоматически заполнятся корректными значениями после сохранения изменений настроек (Рис. 2.1.8).

-Вернуться к содержанию-

2.2. Настройка пользовательских уведомлений

Если глобальная настройка плагина была выполнена корректно, в настройках уведомлений личного кабинета пользователя появится канал доставки уведомлений Telegram (Рис. 2.2.1).

Пиктограмма в шапке колонки сигнализирует о том, что необходимо выполнить его пользовательскую настройку:

1) Кликнуть по пиктограмме . Раскроется модальное окно  с инструкцией (Рис. 2.2.2).

2) Нажать на ссылку «Подключить мой аккаунт к Telegram». Раскроется вкладка браузера  для перехода на страницу чата с настроенным в системе ботом (Рис. 2.2.3).

Если приложение Telegram у вас установлено на другом устройстве (например, на мобильном телефоне) — скопировать (ввести вручную или переслать доступным способом) адрес раскрывшейся страницы (см. Рис. 2.2.3) в браузер устройства с Телеграмом. Действия, описанные в следующем пункте (3) необходимо выполнять уже в этом браузере, а страницу на устройстве с СЭО 3КL можно закрыть.

3) Нажать «SEND MESSAGE». Запустить открывшийся в приложении чат с ботом СЭО 3КL (Рис. 2.2.4).

4) Нажать кнопку «Сохранить» в модальном окне (см. Рис. 2.2.2). Настройка канала доставки уведомлений«Telegram» пользователя будет завершена (Рис. 2.2.5).

Уведомления о событиях, для которых включен этот способ доставки, теперь будут приходить этому пользователю в чат бота СЭО 3КL (Рис. 2.2.6).

-Вернуться к содержанию-

2.2.1. Сброс пользовательских настроек

Для того, чтобы отключить канал доставки «Telegram», пользователю необходимо:

1) Кликнуть по заголовку столбца «Telegram» на странице настройки уведомлений (см. Рис. 2.2.7).

2) В открывшемся модальном окне нажать на ссылку «Удалить подключение к Telegram» (Рис. 2.2.1.а).

3) Закрыть окно, нажав «Сохранить».

 Пользовательские настройки будут сброшены, канал доставки уведомлений «Telegram» вернется к исходному состоянию (см. Рис. 2.2.1).

-Вернуться к содержанию-

Теги: уведомления