Скилл YouGile в Aizor: как получить ключ API и ставить задачи агенту

Содержание
Коротко. Скилл YouGile даёт агенту Aizor создавать и обновлять задачи в российском таск-трекере: ставить их в нужную колонку, назначать исполнителей, задавать дедлайны и метки. Нужен ключ API. По документации его получают запросом с логином и паролем от аккаунта YouGile и ID компании. Ключ не истекает по времени, а в документации API нет упоминания платы за него.
Вы руководите небольшой командой, и после каждой планёрки у вас на руках список решений. Каждое надо завести в YouGile: найти доску, выбрать колонку, назначить человека, поставить срок. Пока вы вводите третье поручение, первое уже вылетело из головы.
Скилл YouGile отдаёт эту рутину агенту: вы диктуете задачи обычными словами, он заводит их на доске. Ниже разберём подключение на примере такой планёрки.
Что агент делает на доске?
Официальное описание скилла от команды Aizor: создание и обновление задач в YouGile, постановка в нужную колонку, назначение исполнителей, дедлайны и метки.
Вы диктуете задачу, а агент заводит её на доске. В API YouGile дополнительные метки и поля задачи называются стикерами. Это удобно руководителю, который ставит десятки мелких поручений в день. О самом приложении есть отдельная страница.
Что нужно подготовить?
Кроме аккаунта понадобится ID компании. А что сможет агент, зависит от прав вашего аккаунта.
- Аккаунт в YouGile и логин с паролем от него.
- ID компании, которой будет управлять агент. Его показывает метод
POST /auth/companies, а в интерфейсе, по документации, ID открывается сочетанием клавиш Ctrl+Alt+Q (Ctrl+Option+Q на Mac). - Права в YouGile. API использует права владельца ключа: чего сотрудник не может сделать в интерфейсе, не сделает и агент.
- Приложение Aizor для macOS или Windows и скилл «Задачи в YouGile» из каталога.
Нужен аккаунт Aizor? Скачивание бесплатное, промокод kalsin5 даёт −5% на каждое пополнение.
Открыть Aizor ↗Где взять ключ API?
Кнопки в кабинете для ключа нет: по документации YouGile API v2 он создаётся запросом к API. Если вы не пишете код, попросите это сделать знакомого разработчика, потому что запросов нужно всего пара.
- Отправьте запрос
POST /auth/companiesс логином и паролем от аккаунта YouGile. В ответе будет список ваших компаний с ID. - Отправьте запрос
POST /auth/keysи передайте в телеlogin,passwordиcompanyId. Ответом вернётся ключ API. - Сохраните ключ. Он нужен для всех следующих запросов в заголовке
Authorization: Bearer <ключ API>.
Запросы идут на адрес вида https://yougile.com/api-v2/{resource}. По документации, у ключа нет ограничений по времени и по количеству запросов, зато есть ограничение по частоте: не более 50 запросов в минуту на компанию. У одного аккаунта может быть не более 30 ключей. Затем установите скилл из каталога Aizor и вставьте ключ в его настройки.
Как проверить, что всё работает?
Сначала агент только читает доску, и лишь потом вы разрешаете ему записывать.
- «Покажи список досок и колонок в моей компании» (только чтение).
- «Какие задачи сейчас стоят в колонке “В работе”?»
- «Создай задачу “Подготовить договор” в колонке “Нужно сделать” и назначь юриста» (запись, лучше под подтверждением).
- «Поставь дедлайн на пятницу задаче “Подготовить договор”».
Попробовать на своём кабинете. Aizor скачивается бесплатно, есть тариф со своими API-ключами. Промокод kalsin5 даёт скидку 5% на пополнение баланса.
Как это выглядит после планёрки?
Как поставить поручение одной фразой?
Вы пишете в чат Aizor или в Telegram-бот: «Бухгалтеру: подготовить отчёт до среды». Агент создаёт задачу, назначает исполнителя и ставит срок.
Как разобрать итоги встречи?
Вы присылаете список решений после встречи. Агент заводит по задаче на каждое, раскладывает по колонкам и сообщает, что создал.
Как получить утренний срез по доске?
Агент выбирает задачи по колонке или исполнителю и присылает список. В планировщике Aizor задачу можно запускать каждое утро.
Как перенести задачу, когда работа закончена?
Вы просите перенести задачу в колонку «Готово» или отметить её выполненной. Другие трекеры, например Trello, описаны в отдельной инструкции.
Что делать, если задача не создалась?
Обычно дело в ключе, правах или колонке, и таблица подскажет, в чём именно.
| Что видите | Причина | Что делать |
|---|---|---|
| 401 | Ключ неверный или удалён. | Проверьте, что ключ вставлен целиком, или создайте новый. |
| 403 | У владельца ключа не хватает прав на действие. | Проверьте права аккаунта в YouGile: API наследует их. |
| 429 | Превышено 50 запросов в минуту на компанию. | Подождите минуту и повторите. |
| Не удаётся создать ключ | Неверный логин, пароль или ID компании, либо у аккаунта уже 30 ключей. | Проверьте данные и удалите ненужные ключи методом DELETE /auth/keys/{key}. |
| Задача не появилась | Не указана колонка или указан неверный ID колонки. | Попросите агента сначала показать колонки доски и выбрать из списка. |
Как не дать агенту лишнего?
Ключ без срока и с правами владельца стоит беречь, особенно если в компании есть закрытые проекты.
- Ключ действует с правами его владельца и без срока. Создайте под агента отдельный аккаунт с ограниченными правами, если в компании есть закрытые проекты.
- Логин и пароль нужны только для получения ключа. В Aizor вставляйте ключ, а не пароль.
- Создание и изменение задач пускайте через ручное подтверждение в Aizor.
- Отзыв ключа: метод
DELETE /auth/keys/{key}, список ключей даётPOST /auth/keys/get. - Не пересылайте ключ в чатах и письмах.
Когда всё настроено, после планёрки вы пересылаете агенту список решений и получаете задачи на доске, а не вечер ручного ввода.
Инструкция написана по официальной документации YouGile REST API v2 (ru.yougile.com/api-v2), состояние на октябрь 2026 года. Интерфейс кабинета и условия могут измениться. Автор Aizorlab участвует в партнёрской программе Aizor.


