Управление задачей /task

---

Вывести список команд управления задачей 

---

Получить панель управления задачей 

Команда /task_get. Быстрый переход к управлению задачей и получение информации по ней. 

❗Команда работает в топике по задаче и в том случае, если отправить ее ответом на сообщение, в котором содержится ссылка на задачу из Битрикс24 

---

Получить информацию о задаче 

Команда /task_info, отправленная боту, позволяет узнать, название задачи и в какой группе на портале Битрикс24 она находится, как распределены роли в задаче (кто постановщик, ответственный и др.), каков крайний срок и статус задачи, а также последний комментарий к задаче. 

❗Команда работает в топике по задаче и в том случае, если отправить ее ответом на сообщение, в котором содержится ссылка на задачу из Битрикс24 

---

Создать задачу по топику 

Команда /task_new. Позволяет cоздать задачу в привязанной к порталу Битрикс24 группе. Данную команду используем, если привязка Телеграм-чата к группе на портале Битрикс24 была выполнена с помощью /group_bind 

Способ 1. Создать задачу, в которой тот, кто отправил команду, будет назначен ответственным. Отправляем боту /task_new <название задачи>

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

Способ 2. Сразу поставить задачу на определенного сотрудника. Отправляем боту /task_new <название задачи @юзернейм_сотрудника_в_Телеграм>. При этом важно, чтобы сотрудник на портале в своем профиле сохранил свой юзернейм в поле Xing. 

Бот отправляет уведомление о том, что задача создана и предлагает перейти к управлению задачей. 

Способ 3. Создание задачи одним кликом

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

---

Вывести описание задачи и комментарии к ней 

Команда /task_repeat. Выдает название и описание текущей или уже завершенной задачи, а также все комментарии к задаче, кроме системных. Дело в том, что в панели управления задачей через кнопку "Подробнее" отображается ограниченное количество комментариев, а через эту команду  дублируются вообще все текстовые комментарии к задаче. 

❗Команда работает в топике по задаче и в том случае, если отправить ее ответом на сообщение, в котором содержится ссылка на задачу из Битрикс24 

---

Изменить название задачи 

Команда /task_rename меняет название задачи на портале Битрикс24. Так как название задачи на портале изменено, то через какое-то время в Телеграм меняется и название топика, который связан с задачей 

❗Команда работает в топике по задаче  

---

Возобновить задачу 

Команда /task_renew. Бот возобновит задачу, в случае если: 

1) задача завершена и пользователь, который отправил команду, постановщик задачи или администратор портала Битрикс24;
2) задача отправлена на проверку и пользователь, который отправил команду,  ответственный;
3) задача отправлена на проверку и пользователь, который отправил команду,  постановщик.

❗Команда работает в топике по задаче и в том случае, если отправить ее ответом на сообщение, в котором содержится ссылка на задачу из Битрикс24 

---

Привязать задачу  

Команда /task_bind. Если у задачи нет треда и тред не привязан к задаче, то тред можно привязать к задаче через команду /task_bind <ID задачи>. После привязки будут прилетать все комментарии к задаче из Битрикс24, а также уведомления, связанные с задачей. 

---

Отвязать задачу  

Команда /task_unbind отвязывает задачу от топика  

❗Команда работает в топике по задаче 

---

Делегировать задачу

Команда /task_delegate позволяет установить нового ответственного за выполнение задачи.

❗Команда работает в топике по задаче и в том случае, если отправить ее ответом на сообщение, в котором содержится ссылка на задачу из Битрикс24 

После введенной команды через пробел можно передать

•  ID пользователя на портале Битрикс24:  

• Фамилию и/или Имя пользователя 

При этом если найдено несколько пользователей с такой фамилией или имением, то бот предложит выбрать одного из сотрудников 

• Телеграм ник пользователя, который указан в профиле Битрикс24

---

Сдвинуть крайний срок задачи 

Команда /task_deadline_move помогает сдвинуть крайний срок задачи.
Обратите внимание, что количество дней для сдвига дедлайна считается от сегодняшнего дня. 

❗Команда работает в топике по задаче и в том случае, если отправить ее ответом на сообщение, в котором содержится ссылка на задачу из Битрикс24 

---

Сдвинуть дату финиша задачи 

Команда /task_finishdate_move помогает сдвинуть дату финиша задачи.
Обратите внимание, что количество дней для сдвига финиша считается от сегодняшнего дня.

❗Команда работает в топике по задаче и в том случае, если отправить ее ответом на сообщение, в котором содержится ссылка на задачу из Битрикс24  

---

Завершить задачу 

Команда /task_finish помогает завершить задачу в случае, если пользователь, который отправил задачу,  постановщик и/или ответственный за выполнение задачи. 

❗Команда работает в топике по задаче и в том случае, если отправить ее ответом на сообщение, в котором содержится ссылка на задачу из Битрикс24 

Если в задаче нужно принять результат работы, в сообщении будут всплывать подсказки - завершить или возобновить работу.

---

Получить записи трудоемкости по задаче 

Отправляем боту команду /task_spent_time. Бот в ответ отправит записи трудоемкости по этой задаче, что позволит узнать, какие сотрудники сколько времени потратили на задачу и что именно было сделано. 

❗Команда работает в топике по задаче и в том случае, если отправить ее ответом на сообщение, в котором содержится ссылка на задачу из Битрикс24 

---

Добавить комментарий к задаче в качестве результата

Бывает, что задачу нельзя завершить без результата. В таком случае необходимо отправить боту команду /task_add_result <комментарий по результату выполнения команды> и только после этого команду /task_finish. 

❗Команда работает в топике по задаче и в том случае, если отправить ее ответом на сообщение, в котором содержится ссылка на задачу из Битрикс24 

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

---

Узнать статус задачи 

Отправляем боту команду /task_gpt_status. Будет отправлен запрос к ChatGPT и бот вернет ответ, в котором будет информация о том, какая была поставлена задача, какой по ней прогресс и есть ли уже какой-то результат. 

❗Команда работает в топике по задаче и в том случае, если отправить ее ответом на сообщение, в котором содержится ссылка на задачу из Битрикс24 

Обратите внимание, что для корректной работы данной команды может понадобиться привязка ключа от OpenAI. Если на вашем портале команда не сработала, обратитесь, пожалуйста, к вашему менеджеру или свяжитесь с нами одним из способов, указанных на официальном сайте 

---

Получить чек-лист 

На портале у задачи уже есть чек-лист. Отправляем боту команду /task_checklist.
Бот присылает "копию" чек-листа с портала Битрикс24. Учтено, какие пункты выполнены, а какие - еще нет. Корректно отображена структура (пункты, подпункты).

Если к задаче добавлено несколько чек-листов, то бот отправит в Телеграм-чат информацию по всем чек-листам 

❗Команда работает в топике по задаче и в том случае, если отправить ее ответом на сообщение, в котором содержится ссылка на задачу из Битрикс24 

---

Добавить элемент в чек-лист  

Если в задаче еще нет чек-листа, то после отправки команды /task_checklist_item_add <элемент чек-листа> бот создает в задаче на портале Битрикс24 чек-лист 1 и добавляет в него элемент.

❗Команда работает в топике по задаче и в том случае, если отправить ее ответом на сообщение, в котором содержится ссылка на задачу из Битрикс24 

Если в задаче уже есть чек-лист, то бот не будет создавать новый чек-лист, а добавит элемент в уже существующий чек-лист. Если в задаче есть несколько чек-листов, то бот добавит новый элемент в самый первый чек-лист, который был создан раньше всего. 

---

Добавить запись трудоемкости по задаче 

Отправляем боту команду /task_time_add <затраченное_время  что_было_сделано>

 ❗Команда работает в топике по задаче и в том случае, если отправить ее ответом на сообщение, в котором содержится ссылка на задачу из Битрикс24 

---

Посмотреть записи трудоемкости по задаче 

Посмотреть записи трудоемкости по определенной задаче можно с помощью команды /task_time_list 

❗Команда работает в топике по задаче и в том случае, если отправить ее ответом на сообщение, в котором содержится ссылка на задачу из Битрикс24 

---

Запустить учет времени по задаче

Чтобы запустить учет времени по задаче через Телеграм чат, отправляем боту команду /task_work_start 

❗Команда работает в топике по задаче и в том случае, если отправить ее ответом на сообщение, в котором содержится ссылка на задачу из Битрикс24 

На портале Битрикс24 начинается учет времени по задаче. 

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

---

Поставить выполнение задачи на паузу 

Чтобы приостановить выполнение текущей задачи, отправляем боту команду /task_work_pause.

❗Команда работает в топике по задаче и в том случае, если отправить ее ответом на сообщение, в котором содержится ссылка на задачу из Битрикс24 

---

Увеличить время выполнения

Чтобы увеличить время для выполнения задачи можно использовать команду /task_time_estimate_set.

❗Команда работает в топике по задаче и в том случае, если отправить ее ответом на сообщение, в котором содержится ссылка на задачу из Битрикс24 

---

Создать задачу из пересланных сообщений

Чтобы создать задачу из пересланных сообщений, то можно переслать сообщения в личные сообщения бота и использовать команду /task_new_from_forwarded_messages.

❗Команда работает только в личных сообщениях бота @its_bitrix24_bot.

---

Создать встречу по задаче

Команда /task_event_new позволяет создать встречу в вашем календаре по задаче. В параметры команды передаются дата и время начала встречи. Длительность встречи будет выставлено автоматически - 1 час. Всем участникам задачи будет отправлено приглашение на участие в Битрикс24.

❗Команда работает в топике по задаче.