Трекер задач — это место, где задачи команды уже живут: Asana, ClickUp, HubSpot, Jira или Trello. Здесь имеется в виду один из них, к которому вы обращаетесь через подключение, созданное вашей организацией, — токен, который участник вставил один раз, — а не копия вашей работы, хранящаяся где-то ещё.
Одно подключение, два пути
- Проектная комната синхронизирует собственные задачи с одним проектом, списком или воронкой: задача, созданная в комнате, появляется в инструменте, а изменение, сделанное в инструменте, возвращается.
- API обращается к тому же подключению напрямую: Asana по адресу /asana/v1, ClickUp — /clickup/v1, HubSpot — /hubspot/v1 и Jira — /jira/v1, по семь операций в каждом, с тем же ключом, что и у LinkedIn API.
Эти четыре — один и тот же API, повторённый четыре раза. Различается лишь собственное слово каждого инструмента для места, где лежат задачи: в Asana и Jira это проект, в ClickUp — список, в HubSpot — воронка, а в API все четыре называются project_id. Задача — это одни и те же пять полей, из какого бы инструмента она ни пришла: title, notes, status (open, doing или done), assignee и due.
Trello можно только привязать к комнате, собственного API для него здесь нет. Всё, что комната делает с Trello, она делает через тот же движок синхронизации; отсутствует именно вход, а не сам инструмент.
Частые вопросы
Куда вводится токен?
На странице проектных комнат, после входа в систему, в разделе задач комнаты. Через API он не передаётся никогда: POST /asana/v1/connections/link и три остальных запроса отвечают 403 с адресом этой страницы, потому что секрету не место в вызове API, который держит в руках ассистент.
Можно ли обратиться к чужому подключению?
Нет. Подключение принадлежит одной организации, а чужое получает тот же ответ, что и несуществующее, — 404, а не 403, и теми же словами, поэтому подобрать идентификатор нельзя. Идентификатор проекта при каждом вызове проверяется в самом инструменте, а не принимается на веру.
Под чьим именем появляется работа?
Под именем участника, чей токен лежит в подключении. Задача, созданная через API, создаётся им самим в инструменте — так, как если бы он набрал её там вручную.