# YouGile — двусторонняя интеграция с MMW

> Подключение YouGile к MMW, управление задачами и комментариями и поиск сохранённых данных.

**YouGile ↔ MMW** позволяет управлять выбранными проектами YouGile из MMW и находить сохранённые задачи и комментарии через ИИ-ассистента.

## Как получить API-ключ YouGile

В обычных настройках профиля кнопки «Создать API-ключ» нет. Для облачной версии YouGile используется **официальная интерактивная консоль REST API v2**. Вам понадобится логин (электронная почта), пароль и идентификатор компании (`companyId`).

1. **Скопируйте идентификатор компании.** Откройте в YouGile любую страницу нужной компании и нажмите **Ctrl + Alt + Q** (Windows) или **Ctrl + Option + Q** (macOS). YouGile скопирует `companyId` в буфер обмена. Если сочетание не сработало, откройте [официальный метод «Получить список компаний»](https://ru.yougile.com/api-v2#/operations/getCompanies), укажите свои данные для входа на сайте YouGile и отправьте запрос, чтобы увидеть идентификаторы доступных компаний.
2. **Откройте [официальный метод «Создать ключ»](https://ru.yougile.com/api-v2#/operations/AuthKeyController_create).** В интерактивной консоли заполните данные запроса: `login` — адрес электронной почты аккаунта YouGile, `password` — пароль этого аккаунта, `companyId` — скопированный ID компании. Вводите пароль **только на официальной странице YouGile**, не в кабинете MMW.
3. Нажмите **Send API Request**. В ответе найдите поле `key`. Например, если сервер вернул `{"key":"ВАШ_СЕКРЕТНЫЙ_КЛЮЧ"}`, скопировать нужно **только значение поля `key`**, без кавычек, фигурных скобок и названия поля.
4. **Сохраните ключ** в защищённом менеджере паролей. Не отправляйте его в переписке и не добавляйте в комментарии к задачам.
5. Откройте **[Интеграции MMW](https://app.mmwhub.ru/dashboard?tab=integrations) → YouGile**, вставьте полученный ключ, нажмите **Проверить ключ**, выберите компании/проекты из доступного списка и нажмите **Подключить проекты**.

Если вы отключили YouGile в MMW, сохранённый в MMW ключ удаляется. **Но сам ключ YouGile при этом не аннулируется**. Если он у вас сохранён и по-прежнему действителен, используйте его для повторного подключения — создавать новый необязательно.

### Если не удаётся получить ключ

- **Не получается узнать `companyId`?** Используйте метод [получения списка компаний](https://ru.yougile.com/api-v2#/operations/getCompanies) вместо сочетания клавиш и убедитесь, что выбрана нужная компания.
- **Ответ с ошибкой авторизации?** Проверьте логин и пароль YouGile на официальном сайте и правильность `companyId`.
- **Не отображаются проекты?** Ключ получает те же права, что и пользователь YouGile, создавший его. Нужны права на соответствующие проекты.
- **Не создаётся новый ключ?** У одного аккаунта может быть до **30 активных API-ключей**. Ранее выданными ключами можно управлять через методы [YouGile REST API v2](https://ru.yougile.com/api-v2#/).
- **Нужна инструкция от разработчика сервиса?** См. [официальное руководство YouGile по API-ключам](https://help.yougile.com/books/baza-znanii-yougile/page/rest-api-v20-v-yougile).

## Как подключить

1. Войдите в [личный кабинет MMW](https://app.mmwhub.ru/dashboard?tab=integrations) под своим аккаунтом с подтверждённой электронной почтой. Откройте раздел **Интеграции**.
2. В блоке **YouGile** укажите действующий ключ доступа **YouGile REST API v2**. Получите его в YouGile или у администратора вашего рабочего пространства. Не отправляйте ключ в чаты и комментарии.
3. Нажмите **Проверить ключ**, выберите проекты YouGile, к которым хотите предоставить доступ MMW, и нажмите **Подключить проекты**.
4. Выберите проект и колонку. После подключения можно создавать и редактировать задачи, назначать сроки, отмечать выполнение и добавлять комментарии.

Если блок YouGile не появился сразу после обновления MMW, перезагрузите страницу кабинета.

## Что можно делать

**Из MMW в YouGile:** создавать задачи, менять название и описание, устанавливать и снимать срок, отмечать выполнение и возвращать задачу в работу, просматривать и добавлять комментарии. Изменения передаются в YouGile после вашего действия, а результат проверяется через API.

**Из YouGile в MMW:** MMW автоматически собирает доступные проекты, задачи, статусы и комментарии из выбранных проектов. Данные хранятся в отдельном зашифрованном архиве. Обычно новые записи появляются **после очередного сбора — примерно раз в 10 минут**. При задержках API это может занять больше времени.

В подключённом ИИ-клиенте MMW попросите выполнить поиск с префиксом **yougile:**, например:

\`\`\`text
yougile:согласование договора
\`\`\`

Поиск вернёт совпадающие задачи или комментарии и контекст исходной задачи. Он работает с сохранённым личным архивом, а не со всеми событиями YouGile в реальном времени.

## Права доступа и безопасность

- MMW работает **только с выбранными вами проектами** и в пределах прав вашего аккаунта YouGile.
- Ключ подключения хранится **в зашифрованном виде** и не отображается после сохранения.
- Архив доступен владельцу личного пространства MMW. Записи не становятся общей памятью организации автоматически.
- Для изменения задачи, особенно срока или статуса, требуется явное действие. MMW не публикует автоматически произвольные записи вашей памяти в YouGile.
- Если задачу одновременно изменили в YouGile и MMW, устаревшее изменение отклоняется — обновите данные перед повторением.

## Отключение

В разделе **Интеграции → YouGile** нажмите **Отключить** и подтвердите действие. Сохранённый ключ будет отозван из MMW, дальнейшая работа с YouGile и поиск в связанном архиве будут заблокированы. **Ранее собранный зашифрованный архив не удаляется автоматически.** Для запроса на удаление данных обратитесь в [поддержку MMW](mailto:support@mmwhub.tech).

## Если что-то не работает

1. Убедитесь, что вход выполнен в **личное пространство** MMW и электронная почта подтверждена.
2. Проверьте действительность ключа YouGile, доступ к проекту и выбранную колонку.
3. Для поиска нового комментария дождитесь следующего цикла сбора и используйте префикс **yougile:** с точными словами из записи.
4. При конфликте изменений обновите список задач; не отправляйте повторно операцию, результат которой ещё не удалось подтвердить.
5. Если проблема сохраняется, обратитесь в [поддержку](mailto:support@mmwhub.tech), указав время, название проекта и сообщение об ошибке — **без API-ключей и личных данных**.

Это подключение передаёт действия и архивирует наблюдаемые состояния. Оно не гарантирует мгновенную доставку сообщений, восстановление всех промежуточных редакций между опросами или автоматическое преобразование всех записей памяти в задачи.
