Запуск таймера из задач Битрикс24

Какие страницы распознаются

Откройте задачу в Битрикс24, и расширение Keepr покажет над таймером карточку «На этой странице». Распознаются и задачи из вашего списка, и задачи рабочей группы — в облачном Битрикс24 и на коробочном портале по адресу вашей компании, по HTTPS.

Keepr узнаёт Битрикс24 по виду адреса задачи, …/tasks/task/view/1287/, поэтому для вашего портала ничего настраивать не нужно. Списки задач, канбан, календарь, чаты и другие страницы не распознаются.

Что заполняет карточка

Нажмите в карточке «Взять». В описание таймера попадают номер и название задачи, например «#1287 Подготовить квартальный отчёт», поэтому записи читаются так же, как задача.

В заголовке вкладки Битрикс24 нет названия задачи, поэтому Keepr читает заголовок на странице одним коротким скриптом в этой вкладке. Задачу, открытую в слайдере поверх списка, так прочитать нельзя — под слайдером по-прежнему заголовок списка, — и тогда в описании будет только номер. Откройте задачу на отдельной странице или допишите название сами.

Если задача Keepr для этой задачи Битрикс24 уже есть, карточка так и скажет, и «Взять» заполнит также её проект и задачу. Иначе карточка назовёт проект, в который попадёт новая задача; его можно сменить до нажатия «Запустить таймер».

Как задача находится или создаётся

Keepr хранит в задаче номер вместе с адресом задачи на вашем портале — в том же виде, что и интеграция с Битрикс24, со страницы какого бы сотрудника или какой бы группы вы её ни открыли. Поэтому задача, которую интеграция уже завела, находится, и таймер запускается на ней. Чтобы связать задачу вручную, укажите номер без решётки, 1287, как её внешний ID.

Если подходящей задачи нет, Keepr берёт проект, где уже больше всего задач с этого портала, затем проект, в котором вы последний раз запускали таймер по задаче этой группы или этого портала в этом браузере. Адреса Битрикс24 не называют проект, поэтому по названию проект не подбирается.

Сама задача создаётся только по нажатию «Запустить таймер» и получает название задачи Битрикс24, поэтому открытая и брошенная карточка ничего после себя не оставляет. Повторный запуск по той же задаче через неделю переиспользует её.

Что понадобится

Расширение подключается персональным API-токеном, а он входит в тариф Ultimate. Выдайте токену области timers и projects; чтобы создавать задачи со страницы, нужны ещё запись в projects и право управлять выбранным проектом. Без них таймер всё равно запустится — только с описанием.

В закреплённой боковой панели Keepr следит за открытой задачей, если разрешить ему читать адреса вкладок. Если не хотите, разрешите только свой портал, когда панель это предложит, или добавьте его адрес в настройках расширения.