Aizor ↗

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

Обновлено 5 мин чтенияСкилл Aizor
Скилл YouGile в Aizor: как получить ключ API и ставить задачи агенту
Содержание
  1. Что агент делает на доске?
  2. Что нужно подготовить?
  3. Где взять ключ API?
  4. Как проверить, что всё работает?
  5. Как это выглядит после планёрки?
  6. Что делать, если задача не создалась?
  7. Как не дать агенту лишнего?

Коротко. Скилл 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. Если вы не пишете код, попросите это сделать знакомого разработчика, потому что запросов нужно всего пара.

  1. Отправьте запрос POST /auth/companies с логином и паролем от аккаунта YouGile. В ответе будет список ваших компаний с ID.
  2. Отправьте запрос POST /auth/keys и передайте в теле login, password и companyId. Ответом вернётся ключ API.
  3. Сохраните ключ. Он нужен для всех следующих запросов в заголовке Authorization: Bearer <ключ API>.

Запросы идут на адрес вида https://yougile.com/api-v2/{resource}. По документации, у ключа нет ограничений по времени и по количеству запросов, зато есть ограничение по частоте: не более 50 запросов в минуту на компанию. У одного аккаунта может быть не более 30 ключей. Затем установите скилл из каталога Aizor и вставьте ключ в его настройки.

Как проверить, что всё работает?

Сначала агент только читает доску, и лишь потом вы разрешаете ему записывать.

  • «Покажи список досок и колонок в моей компании» (только чтение).
  • «Какие задачи сейчас стоят в колонке “В работе”?»
  • «Создай задачу “Подготовить договор” в колонке “Нужно сделать” и назначь юриста» (запись, лучше под подтверждением).
  • «Поставь дедлайн на пятницу задаче “Подготовить договор”».

Попробовать на своём кабинете. Aizor скачивается бесплатно, есть тариф со своими API-ключами. Промокод kalsin5 даёт скидку 5% на пополнение баланса.

Перейти на сайт Aizor

Как это выглядит после планёрки?

Как поставить поручение одной фразой?

Вы пишете в чат 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.

Читайте также