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