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

Агент ходит в YouGile через api-v2: читает проекты, доски и колонки, задачи со сроками и исполнителями, чаты задач, сотрудников и департаменты. Из этого собирается разбор по компании — что просрочено по дедлайну, у кого зависло, что создано, изменено и завершено за сутки по каждому проекту. Обход идёт сверху вниз, от проекта к колонке, поэтому задача не теряется на доске, о которой вы забыли.

Устроен YouGile вокруг чатов: обсуждение задачи живёт не в поле описания, а в её ленте сообщений, и настоящая причина переноса срока или смены исполнителя чаще всего написана именно там, а не в самой карточке. Поэтому агент читает чат задачи целиком и достаёт из него суть договорённостей, а не судит о ходе работы по одним лишь полям карточки и положению в колонке.

На запись агент создаёт задачу в выбранной колонке, расписывает постановку, назначает исполнителя и срок, переносит задачи между колонками и пишет сообщения в чат задачи. Перед созданием он проверяет, что проект, доска и колонка существуют и открыты ключу, а после изменения перечитывает задачу — чтобы показать её фактическое состояние. Сообщение в чат уходит от лица владельца ключа, и агент об этом предупреждает.

Ключ один на все запросы, и агент видит ровно те доски, что открыты этому ключу: закрытая доска для него просто не существует, а не отвечает ошибкой. Списки YouGile отдаёт страницами, поэтому разбор по компании — это обход проектов, досок и колонок, а не один запрос, и агент следит, что дошёл до конца. Уведомления о новой и изменённой задаче приходят без подписи, поэтому агент считает их сигналом и перечитывает данные через API; если чего-то не видно, он скажет прямо, а не покажет пустую таблицу.