Emdesell

Настройка уведомлений в MAX и управление доступами в чатах/каналах


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


Видео инструкция

Текстовая версия видео

Как подключить мессенджер MAX к Emdesell: создать бота на портале MAX для партнеров, включить интеграцию, настроить уведомления и автоматически управлять доступом учеников к чатам и каналам. В результате ученики будут получать уведомления в MAX, а бот будет добавлять их в чаты и каналы при получении доступа и удалять из них при его окончании.

Создание бота в MAX

  1. 0:00 Зарегистрируйтесь на портале MAX для партнеров и пройдите верификацию. Получить доступ можно не только как ИП, но и как самозанятый.
  2. 0:26 Перейдите в раздел Чат-боты и нажмите Добавить бота. Оформите бота: загрузите картинку и заполните описание.
  3. 0:40 Отправьте бота на проверку. Проверка заявлена на 24 часа, но обычно завершается в течение часа.
  4. 0:57 После проверки откройте Расширенные настройки бота и включите параметр Добавление в групповые чаты. Без него бот не сможет добавлять учеников в группы и каналы и управлять ими.
  5. 1:06 Скопируйте Токен доступа в Расширенных настройках бота.

Подключение в Emdesell

  1. 1:21 В Настройках откройте раздел MAX. Включите Интеграция с ботом MAX и вставьте токен в поле Токен.
  2. 1:34 Включите Отображение кнопки MAX для ученика. Благодаря этой кнопке ученики смогут привязать свой аккаунт MAX, и им будут приходить уведомления, например о проверенных домашних заданиях и сертификатах.
  3. 1:52 Нажмите Установить Webhook. После установки появятся Username бота и Ссылка на бота, по ссылке можно перейти к боту. Нажмите Сохранить изменения.
  4. 2:10 Подробная инструкция доступна по кнопке Инструкция по подключению на этой же странице.

Привязка аккаунта ученика

  1. 2:23 Иконка MAX отображается в личном кабинете ученика. Если аккаунт уже привязан, иконки нет.
  2. 2:34 Чтобы проверить привязку, откройте раздел Аккаунты и найдите нужный аккаунт. Если MAX привязан, это будет видно.
  3. 2:40 Нажмите иконку MAX в кабинете. Она открывает бота в браузере. После успешной привязки появится сообщение «Макс успешно привязан». Если появилось сообщение, что ссылка на привязку устарела, откройте MAX в личном кабинете и попробуйте снова.
  4. 3:05 Обновите страницу аккаунта: привязка отобразится.
  5. 3:14 Ученик может отвязать MAX в своем личном кабинете. Администратор тоже может отвязать аккаунт. Это требование закона о персональных данных.

Уведомления

  1. 3:24 Откройте Настройки, раздел Уведомления.
  2. 3:34 В полях Логин(Email) аккаунта для резервных уведомлений авторов в MAX и Логины(Email'ы) аккаунтов для обязательных уведомлений авторов в MAX укажите e-mail администратора. Указывайте именно e-mail, а не ID.
  3. 4:00 В блоке Уведомления авторов в колонке MAX включите нужные события. Это могут быть Новое ДЗ, Новый ответ на домашнее задание, Новый вопрос от ученика, Ненулевая стоимость и Нулевая стоимость заказа, Регистрация аккаунта. Администраторы получают эти уведомления тоже.
  4. 4:15 В блоке Уведомления учеников в колонке MAX включите уведомления, которые нужны ученикам: Изменение статуса домашнего задания (например, на «проверено» или «отменено»), Новый ответ на домашнее задание и на вопрос. Информация о выданном сертификате тоже будет доступна в MAX.

Чаты и каналы

  1. 4:44 Откройте раздел Доступы, выберите нужный доступ и перейдите на вкладку Интеграции. Здесь указываются ID чатов/каналов MAX.
  2. 5:01 В MAX создайте группу или приватный канал и добавьте в него бота как участника. Бот обязательно должен быть администратором, иначе он не сможет добавлять и удалять учеников.
  3. 5:28 После добавления бота в чат MAX показывает его ID. Скопируйте ID вместе со знаком минус и вставьте его в поле ID чата или канала MAX. Появится новое поле, поэтому можно добавить несколько чатов и каналов.
  4. 5:55 Чтобы проверить работу, откройте аккаунт ученика, найдите доступ в разделе Доступы и заберите его, подтвердив действие. Бот удалит ученика из чата или канала.
  5. 6:27 Выдайте доступ снова. Бот добавит ученика в чат или канал, и он сможет в нем работать.
  6. 6:41 Так доступ к чатам и каналам MAX управляется через бота автоматически, в том числе после оплаты, без ручного участия администратора.

Текстовая инструкция


Настройка интеграции с MAX

Сначала выполним настройку интеграции с MAX.

Для этого нужно будет выполнить следующие шаги:

  • Пройти регистрацию в MAX для бизнеса;
  • Далее в разделе Главная в кабинете MAX нажать на кнопку --> Перейти в блоке Чат-боты

  • Далее создаете нового бота в этом разделе настройки

  • Далее бот будет отправлен на проверку. Проверка может занимать до 24 часов.
  • После проверки бота переходим в раширенные настройки по кнопке --> Настроить

  • Копируем Токен доступа и обязательно включаем опцию --> Добавление в групповые чаты и сохраняем изменения

  • Далее переходим в кабинет школы в раздел --> Настройки

  • Далее открываем подраздел --> MAX

  • Включаем обязательно параметры --> Интеграция с ботом MAX и Отображение кнопки MAX для ученика

  • Далее нужно будет вставить скопированный токен доступа в параметр --> Токен

  • И нажать кнопку --> Установить Webhook

  • Далее автоматически должны будут прописаться параметры --> Username бота и Ссылка на бота

  • Если что-то не получилось можно будет еще раз пройтись по шагам в инструкции в этом же разделе настроек и проверить себя

  • Обязательно сохраняем изменения в этом разделе настроек школы


Проверка привязки аккаунта в MAX к школе

Далее нужно будет проверить привязку аккаунта MAX к кабинету школы.

Для этого выполняем следующие шаги:

  • Переходим в кабинет ученика по кнопке в правом верхнем углу

  • Далее нажимаем по иконке MAX

  • Далее нажимаем кнопку --> Открыть приложение MAX

  • В диалоге с ботом MAX нажимаем кнопку --> Начать

  • И получаем сообщение о том, что аккаунт успешно привязан

  • Далее обновляем страницу в кабинете школы --> иконка MAX должна будет пропасть

  • А также проверяем отображение привязки в разделе редактирования аккаунта во вкладке --> Главное

  • Соответственно, отвязать аккаунт можно по кнопке --> Отвязать.

Таким образом выполнили привязку аккаунта MAX к кабинету школы.


Настройка уведомлений в MAX

Далее выполнить настройку уведомлений в MAX.

Для этого нужно будет выполнить следующие шаги:

  • Перейти в раздел кабинета школы --> Настройки

  • Далее перейти в подраздел --> Уведомления

  • Включить необходимые уведомления в MAX для Авторов/Администраторов школы

  • Включить необходимые уведомления в MAX для учеников школы

  • Обязательно сохранить изменения


Таким образом выполнили настройку уведомлений для Авторов/Администраторов и учеников школы.


Управление Доступами в чате/канале MAX

Управление доступами дает возможность добавлять учеников в групповой чат/канал MAX, если будет выдан Доступ в школе, или исключать учеников из чата MAX по окончании Доступа в школе.

Выполняем следующие шаги для этой настройки:

  • Создаем группу в MAX

  • Добавляем созданного бота в MAX администатором в группу

  • Далее придет ID группы в сообщении с ботом в MAX

  • Копируем полностью номер ID.

  • Далее переходим в кабинет школы в раздел редактирования необходимого Доступа

  • Открываем вкладку Интеграции и вставляем скопированные ID в параметр --> ID чатов/каналов MAX. Сохраняем изменения

При выдачи этого Доступа ученику в школе, ученику нужно будет обязательно привязать аккаунт MAX в кабинете школы и после привязки ему придет приглашение в группу MAX.

После истечения срока Доступа у ученика, бот исключит ученика из чата MAX. При возобновлении Доступа (новой оплаты или продления), ученик снова сможет добавиться в чат MAX.

Это можно использовать для формата клубных подписок в кабинете школы.