Основные команды

---

У бота курсов есть несколько основных команд. Подробнее о каждой из них ниже. 

Список всех доступных команд 

Отправляем боту команду /help, в ответ бот отправляет список всех доступных на данный момент команд. 

Авторизоваться

Команда /auth позволяет авторизоваться в боте с привязкой к порталу Битрикс24. Это необходимо для начала работы с ботом. 
Более подробная инструкция по ссылке

Отменить текущий тип авторизации 

Если текущая авторизация перестала быть актуальной, например, вам нужно авторизоваться для работы с ботом на другом портале или авторизоваться от лица студента, то можно отправить боту команду /logout.
После этого можно будет снова авторизоваться с помощью /auth 

Вывести список всех курсов 

Отправляем боту команду /get_all_courses. Бот в ответ отправляет в виде кнопок список всех курсов на портале, на котором вы авторизованы.  

Если курсов много, то с помощью кнопок "Далее" и "Назад" можно листать список курсов. 

Нажимаем на название нужного нам курса. 

Нам откроются две возможности: вывести список студентов и добавить студента. Подробнее о них ниже. 

Выбрать определенный курс 

Отправляем боту команду /exact_course [ID курса]. 

Добавить студента 

Отправляем боту команду /get_all_courses. Выбираем какой-то определенный курс из списка. 

Выберем "Добавить студента" и ниже бот отправит нам кнопки для выбора типа создаваемого студента: добавить существующего студента на курс, создать без привязки к Битрикс24 или Создать с привязкой к пользователю Битрикс 24. Рассмотрим все три варианта по очереди. 

Добавить существующего студента на курс

Нажимаем на кнопку "Добавить существующего студента на курс". Бот просит нас передать ID студента. Вводим ID в поле для отправки сообщения и нажимаем "Отправить". 

Где взять ID студента? Идем в приложение "База знаний и тестирование", переходим в Курсы, переходим к списку студентов и берем ID напротив нужного нам студента из столбца ID.

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

Создать студента без привязки к Битрикс24

Нажимаем на кнопку "Создать без привязки к Битрикс24". Бот просит нас передать имя будущего студента. Вводим Имя в поле для отправки сообщения и нажимаем "Отправить". 

Вот такой должен получиться итог создания студента без привязки к Битрикс24 и записи его на курс. 
Удобно, что секретную ссылку можно сразу же отправить студенту для прохождения курса. 

Создать студента с привязкой к пользователю Битрикс24

Нажимаем на кнопку "Создать с привязкой к пользователю Битрикс24". Бот просит нас передать ID пользователя на портале Битрикс24. Вводим ID в поле для отправки сообщения и нажимаем "Отправить".

 

Где взять ID пользователя на портале Битрикс24?  Переходим в профиль нужного нам пользователя на портале Битрикс24 и из адресной строки копируем последние цифры. В примере на скрине ниже это цифры 2537. 

Вот такой должен получиться итог создания студента с привязкой к пользователю Битрикс24 и записи его на курс.
Удобно, что секретную ссылку можно сразу же отправить студенту для прохождения курса. 

Управлять студентом 

Выполняем команду /get_all_courses, выбираем определенный курс и нажимаем на кнопку "Список студентов"

Бот отправляет список всех студентов, записанных на данный курс. 

Нажимаем на имя нужного нам студента, бот отправляет статистику студента по выбранному раннее курсу, ссылку на прохождение курсов для данного студента, а также несколько возможных действий над студентом:
1. Удалить студента: позволяет удалить студентов из курсов;
2. Отписать студента от курса
3. Заархивировать студента 

Если выбрали студента, рядом с которым указано "В архиве", то бот также отправит статистику студента по выбранному раннее курсу,
ссылку на прохождение курсов для данного студента, а также кнопки для выполнения действий:

1. Удалить студента
2. Отписать студента от курса
3. Разархивировать студента