Asana
Задачи, проекты и комментарии Asana в процессах Pailot
Asana — сервис учёта задач и проектов. Блок читает и меняет задачи через API (Application Programming Interface — программный интерфейс) по GID (globally unique identifier — глобальный уникальный идентификатор).
С Asana в Pailot вы можете:
- Получать одну задачу по GID или список с фильтром по рабочему пространству и проекту
- Создавать и обновлять задачи: название, описание, исполнитель, срок, статус
- Искать задачи по тексту, исполнителю, проектам и завершённости
- Смотреть проекты пространства и добавлять комментарий (story) к задаче
Подключение — через OAuth (вход по разрешению сервиса) или токен. Блок ставят на холст как отдельный шаг или прикрепляют к агенту. Секреты — в переменных окружения рабочего пространства.
Одна задача по GID или несколько задач с фильтрами.
| Параметр | Тип | Обязательный | Описание |
|---|
taskGid | string | Нет | GID задачи. Если пусто — вернётся список задач |
workspace | string | Нет | GID рабочего пространства (нужен, если нет taskGid) |
project | string | Нет | GID проекта для фильтра |
limit | number | Нет | Максимум задач (по умолчанию 50) |
| Параметр | Тип | Описание |
|---|
success | boolean | Удалась ли операция |
ts | string | Время ответа |
gid | string | GID задачи |
resource_type | string | Тип ресурса (task) |
resource_subtype | string | Подтип ресурса |
name | string | Название задачи |
notes | string | Описание задачи |
completed | boolean | Задача завершена |
assignee | object | Исполнитель |
↳ gid | string | GID исполнителя |
↳ name | string | Имя исполнителя |
created_by | object | Автор |
↳ gid | string | GID автора |
↳ name | string | Имя автора |
due_on | string | Срок (YYYY-MM-DD) |
created_at | string | Когда задачу создали |
modified_at | string | Когда задачу меняли в последний раз |
tasks | array | Массив задач (при списке) |
↳ gid | string | GID задачи |
↳ name | string | Название задачи |
↳ completed | boolean | Завершена ли задача |
Создать задачу в Asana.
| Параметр | Тип | Обязательный | Описание |
|---|
workspace | string | Да | GID рабочего пространства |
name | string | Да | Название задачи |
notes | string | Нет | Описание задачи |
assignee | string | Нет | GID пользователя-исполнителя |
due_on | string | Нет | Срок в формате YYYY-MM-DD |
| Параметр | Тип | Описание |
|---|
success | boolean | Удалась ли операция |
ts | string | Время ответа |
gid | string | GID задачи |
name | string | Название задачи |
notes | string | Описание задачи |
completed | boolean | Задача завершена |
created_at | string | Когда задачу создали |
permalink_url | string | Ссылка на задачу в Asana |
Обновить существующую задачу.
| Параметр | Тип | Обязательный | Описание |
|---|
taskGid | string | Да | GID задачи |
name | string | Нет | Новое название |
notes | string | Нет | Новое описание |
assignee | string | Нет | Новый GID исполнителя |
completed | boolean | Нет | Отметить завершённой или снять отметку |
due_on | string | Нет | Новый срок в формате YYYY-MM-DD |
| Параметр | Тип | Описание |
|---|
success | boolean | Удалась ли операция |
ts | string | Время ответа |
gid | string | GID задачи |
name | string | Название задачи |
notes | string | Описание задачи |
completed | boolean | Задача завершена |
modified_at | string | Когда задачу меняли в последний раз |
Список проектов рабочего пространства.
| Параметр | Тип | Обязательный | Описание |
|---|
workspace | string | Да | GID рабочего пространства |
| Параметр | Тип | Описание |
|---|
success | boolean | Удалась ли операция |
ts | string | Время ответа |
projects | array | Массив проектов |
↳ gid | string | GID проекта |
↳ name | string | Название проекта |
↳ resource_type | string | Тип ресурса (project) |
Поиск задач в рабочем пространстве.
| Параметр | Тип | Обязательный | Описание |
|---|
workspace | string | Да | GID рабочего пространства |
text | string | Нет | Текст для поиска в названиях |
assignee | string | Нет | Фильтр по GID исполнителя |
projects | array | Нет | Массив GID проектов |
completed | boolean | Нет | Фильтр по завершённости |
| Параметр | Тип | Описание |
|---|
success | boolean | Удалась ли операция |
ts | string | Время ответа |
tasks | array | Подходящие задачи |
↳ gid | string | GID задачи |
↳ resource_type | string | Тип ресурса |
↳ resource_subtype | string | Подтип ресурса |
↳ name | string | Название задачи |
↳ notes | string | Описание задачи |
↳ completed | boolean | Завершена ли задача |
↳ assignee | object | Исполнитель |
↳ gid | string | GID исполнителя |
↳ name | string | Имя исполнителя |
↳ due_on | string | Срок |
↳ created_at | string | Когда создали |
↳ modified_at | string | Когда меняли |
next_page | object | Данные следующей страницы |
↳ offset | string | Токен смещения |
↳ path | string | Путь API |
↳ uri | string | Полный URI |
Добавить комментарий (story) к задаче.
| Параметр | Тип | Обязательный | Описание |
|---|
taskGid | string | Да | GID задачи |
text | string | Да | Текст комментария |
| Параметр | Тип | Описание |
|---|
success | boolean | Удалась ли операция |
ts | string | Время ответа |
gid | string | GID комментария |
text | string | Текст комментария |
created_at | string | Когда комментарий создали |
created_by | object | Автор комментария |
↳ gid | string | GID автора |
↳ name | string | Имя автора |
