Задачи Битрикс24 в Keepr и затраченное время обратно в задачу
Что делает интеграция
Одна интеграция связывает портал Битрикс24 — или одну его группу — с одним проектом Keepr. Входящее направление: Битрикс24 сообщает Keepr о задачах. Новая задача становится задачей в проекте Keepr, завершение (статус «Завершена») архивирует её, а возобновление восс танавливает. Задача, ждущая контроля постановщика, ещё не считается выполненной, а удаление задачи архивирует её.
Исходящее направление: Keepr добавляет учтённое время в задачу как затраченное — с точными секундами и началом каждой записи. Правка записи обновляет его, удаление записи удаляет. Отправляется только время из проекта Keepr этой интеграции, без округления.
Что понадобится
В Keepr нужно быть владельцем или администратором организации либо менеджером пространства, в котором лежит проект. Интеграции есть на всех тарифах: на Free работает одна одновременно, на Team — три, на Ultimate, включая пробный период, — сколько нужно.
В Битрикс24 нужно право создавать вебхуки (обычно у администратора портала). Коробочная версия работает так же, если она видит по HTTPS, а Keepr видит её из интернета.
Битрикс24 отправляет каждое событие один раз и не повторяет его, поэтому изменение, сделанное, пока Keepr недоступен, потом не подхватится.
1. Создайте интеграцию в Keepr
Откройте «Настройки организации» → «Интеграции» и нажмите «Новая интеграция». Выберите Битрикс24, проект Keepr, куда будут попадать задачи, и имя, от которого интеграция действует: Keepr показывает её действия, например, как «Архивировано: Битрикс24 · Website».
Чтобы подключить одну группу, укажите её номер — число в адресе . Оставьте поле пустым, чтобы охватить весь портал; задача вне группы записывается и пропускается.
2. Создайте входящий вебхук для Keepr
Keepr читает задачи и добавляет затраченное время через входящий вебхук Битрикс24, и Битрикс24 показывает каждую запись от имени пользователя вебхука. Создайте его от отдельного пользователя, который видит задачи и может учитывать в них время, чтобы записи не числились за вами. Подробнее — в руководстве Битрикс24 по вебхукам.
В разделе Приложения → Разработчикам → Другое () → Входящий вебхук дайте ему право «Задачи» (task) и сохраните. Скопируйте его адрес вида : это секрет, обращайтесь с ним как с паролем.
3. Добавьте исходящий вебхук в Битрикс24
В разделе Приложения → Разработчикам → Другое () → Исходящий вебхук вставьте адрес из раздела интеграции «Входящие вебхуки» в URL обработчика и выберите события «Создание задачи» (ONTASKADD), «Обновление задачи» (ONTASKUPDATE) и «Удаление задачи» (ONTASKDELETE).
Сохраните его и только потом скопируйте показанный токен приложения: при сохранении прежний токен заменяется. Битрикс24 присылает этот токен с каждым событием вместо подписи — так Keepr понимает, что событие пришло с вашего портала.
4. Передайте Keepr адрес вебхука и токен
На странице интеграции откройте «Ключи доступа» и нажмите «Задать…» у ключа Битрикс24. Вставьте адрес входящего вебхука и токен приложения исходящего вебхука и сохраните. Адрес портала вводить не нужно: Keepr берёт его из адреса вебхука.
Keepr хранит оба значения в зашифрованном виде и потом показывает только их первые символы. Пока токен не задан, Keepr отклоняет события Битрикс24. Чтобы сменить токен позже, вставьте вместе с ним и адрес вебхука.
Что отправляет Keepr
Запись отправляется, когда она завершена — идущий таймер ничего не отправляет, пока не остановится, — и только если её задача лежит в проекте интеграции и связана с задачей этого портала. Так связаны задачи, созданные интеграцией, и задачи, начатые из браузерного расширения на странице задачи Битрикс24.
На каждую запись — одна запись затраченного времени с секундами, началом и комментарием с именем участника. Правка обновляет её, перенос начала переносит, удаление записи удаляет, а запись, удалённая вручную, появится снова при следующем изменении.
Импортированное время — это история, оно не отправляется. В списке «Недавно отправлено» видны последние записи: задача, участник, время, которое числится за ней в Битрикс24, и удалась ли последняя отправка; у неудачной указаны причина и что делать.
Пауза и отзыв
Переключатель на странице интеграции выключает её, ничего не теряя. Пока она выключена, события записываются, но не обрабатываются, и время не отправляется: запись, сохранённая во время паузы, уйдёт при следующем изменении. Повторное включение снова занимает место в лимите тарифа.
«Удалить» у ключа Битрикс24 выключает учёт времени и не трогает входящее направление. Отзыв окончателен: Keepr уничтожает сохранённые адрес и токен и больше ничего не делает. Удалите оба вебхука и в Битрикс24.
Если что-то не так
Каждое событие видно в последних доставках интеграции вместе с результатом. Ответ 401 в журнале Битрикс24 значит, что токен приложения не совпадает с тем, что в Keepr, — обычно его скопировали до сохранения. «Не удалось прочитать задачу» — адреса входящего вебхука нет, вебхук удалён, у него нет права «Задачи» или его пользователь не видит задачу. «Задача другой группы» — задача вне группы интеграции.
В «Недавно отправлено» «Ключ доступа отклонён» значит, что входящий вебхук удалён или лишился права, а «Задача не найдена» — что задачу удалили или её не видит пользователь вебхука. «Сервис недоступен, повторим» пройдёт сам, когда портал ответит. Отправка, не прошедшая окончательно, повторится при следующем изменении записи.