Перейти к основному содержимому

Плагин Outlook

📄PDF

Outlook add-in​

Описание​

YuChat предоставляет надстройку (add-in) для Microsoft Outlook, позволяющую создавать комнаты для звонков прямо из интерфейса почтового клиента.

С его помощью можно легко создавать комнаты для звонков в YuChat (call rooms) прямо из Outlook клиента.

Установка поддерживается для Outlook в браузере (OWA), Outlook для Windows и Outlook для Mac (как Legacy/Classic, так и New).

Установка плагина​

Получение манифеста​

Манифест — это XML-файл, по которому Outlook находит и загружает надстройку. Запросите дистрибутив с манифестом у команды YuChat или в YuChat Поддержка и сохраните файл на вашем ПК, например в каталог yuchat-outlook-add-in.

примечание

Домен, на который указывает манифест, должен отдавать собранные ассеты (taskpane, JS, иконки) по HTTPS с доверенным сертификатом. Самоподписанные сертификаты Outlook отвергает.

Outlook в браузере (OWA)​

Работает для любого аккаунта, использующего outlook.office.com.

  1. Откройте https://outlook.live.com/mail/inclientstore (альтернативная ссылка: https://aka.ms/olksideload).
  2. Войдите с учётной записью Microsoft 365, для которой нужно установить надстройку.
  3. Выберите My add-ins → Custom add-ins → + Add a custom add-in → Add from file…
  4. Выберите XML-файл манифеста и подтвердите запрос на доверие.
  5. Надстройка появится при создании новой встречи или события календаря.
подсказка

Надстройки, установленные через OWA, автоматически синхронизируются с desktop-версией Outlook на том же аккаунте — как правило, после полного перезапуска клиента (Cmd+Q / Quit). Это часто самый простой путь и для Windows, и для Mac.

Outlook для Windows​

Через ленту​

Чтобы установить плагин, выполните следующие действия:

  1. Откройте приложение Outlook.

  2. Пройдите аутентификацию пользователем, для которого необходимо установить плагин.

  3. На ленте выберите вкладку Главная → Все приложения.
    Если в клиенте Outlook настроена упрощённая лента, нажмите кнопку с многоточием ( ... ) на ленте, а затем выберите «Все приложения».

примечание
  • Начиная с Outlook для Windows версии 2303 (сборка 16215.10000), кнопка All Apps (Все приложения) заменяет кнопку Получить надстройки на ленте для просмотра установленных надстроек и доступа к Магазину Office.
    Если вы используете более раннюю версию Outlook, вместо неё вы увидите кнопку Get Add-ins (Получить надстройки).
  • Если вы не видите кнопку All Apps (Все приложения) на ленте, возможно, ваш администратор отключил надстройки для вашей организации.
  1. В зависимости от вашей классической версии Outlook или типа учетной записи выберите Добавить приложения или Получить надстройки.
подсказка

Если по каким-либо причинам у вас нет кнопки Добавить приложения или Получить надстройки, перейдите по этой ссылке и проверьте, откроется ли у вас веб-страница надстроек для Outlook: https://outlook.live.com/mail/inclientstore (официальная ссылка, взятая из документации learn.microsoft.com)

  1. В открывшемся окне Надстройки для Outlook выберите вкладку Мои надстройки.

  2. В нижней части вкладки Мои надстройки выберите Добавление пользовательской настройки → Добавить из файла

  3. Выберите XML-файл манифеста.

  4. Нажмите Установить, чтобы установить надстройку.

  5. Перезапустите Outlook.

Через Microsoft 365 Admin Center (для администраторов)​

Централизованное развёртывание надстройки на пользователей организации:

  1. Зайдите в Microsoft 365 Admin Center → Settings → Integrated apps → Upload custom apps.
  2. Выберите тип Office Add-in и загрузите XML-файл манифеста.
  3. Назначьте надстройку нужным пользователям или группам.
  4. Пользователям необходимо выйти из учётной записи и войти снова, чтобы надстройка появилась.

Outlook для Mac​

A. Через OWA (рекомендуемый путь)​

Подходит как для Legacy/Classic, так и для New Outlook for Mac.

  1. Выполните шаги из раздела Outlook в браузере (OWA).
  2. Полностью закройте Outlook for Mac через Cmd+Q (не просто закройте окно).
  3. Откройте Outlook снова. Подождите 30–60 секунд — клиент синхронизирует список надстроек с сервера.
  4. Создайте новое событие в календаре. Кнопка YuChat появится на ленте.
B. Legacy/Classic Outlook for Mac — папка WEF​

Работает только в Legacy/Classic Outlook for Mac, не в New Outlook for Mac.

  1. В Finder откройте Go → Go to Folder… (или нажмите Shift+Cmd+G).
  2. Вставьте путь: 
    ~/Library/Containers/com.microsoft.Outlook/Data/Documents/
  3. Если внутри нет папки wef, создайте её (правый клик → New Folder → wef).
  4. Перетащите XML-файл манифеста в папку wef/. При желании переименуйте его во что-то узнаваемое, например yuchat-schedule-call.xml. Если macOS запросит пароль, введите его.
  5. Закройте Outlook (Cmd+Q) и откройте снова.
C. New Outlook for Mac​

New Outlook не содержит встроенного менеджера надстроек и использует только путь через OWA. Воспользуйтесь разделом A. Через OWA.

Какой режим используется сейчас — видно по переключателю в левом верхнем углу окна Outlook (New Outlook vs Legacy Outlook).

Использование​

  1. В Outlook во вкладке Главная нажмите Создать → Событие
  2. В открывшемся окне нового события, в верхней панели управления нажмите на YuChat для Outlook и пройдите авторизацию в открывшемся окне YuChat плагина
  3. Выберите рабочее пространство из списка, в котором нужно создать комнату для события, введите название события/комнаты и выберите область видимости комнаты, то есть тип - Публичная или Приватная
  4. Заполните поле Название звонка
  5. Выберите в списке Видимость звонка тип звонка: Публичный или Приватный
  6. Выберите в списке Ссылка на звонок действует срок действия ссылки на звонок: Неограниченно, 1 день, 7 дней, 30 дней
  7. Выберите из списка Кому доступен звонок уровень доступа, определяющий, кто сможет подключаться к звонку
  8. Нажмите Создать

Готово - комната для звонка для вашего события, в выбранном вами рабочем пространстве, создана в YuChat!

Проверка установки​

  1. Создайте новую встречу или событие календаря. Надстройка появляется на ленте окна создания встречи.
  2. Нажмите кнопку YuChat Schedule Call.
  3. Таскпейн надстройки откроется в правой части окна.

Обновление до новой версии​

Outlook агрессивно кеширует манифесты и ассеты надстроек. Чтобы получить обновлённую версию плагина:

  1. Запросите у команды YuChat или в YuChat Поддержка актуальный дистрибутив манифеста.
  2. Заново загрузите манифест одним из способов выше (OWA, ленту Outlook или Admin Center).
  3. Полностью закройте Outlook (Cmd+Q / Quit) и откройте снова.

Устранение неполадок​

  • Кнопки YuChat нет на ленте. Проверьте, что лента развёрнута (значок ^ в правом верхнем углу окна события); убедитесь, что вы находитесь в окне создания новой встречи, а не в уже существующей.
  • Манифест отклонён при загрузке. Манифест должен быть доступен по HTTPS с доверенным сертификатом. Если сертификат самоподписанный или просроченный, Outlook отклонит установку.
  • Ошибка «Operation not permitted» при копировании в ~/Library/Containers/... на Mac. Используйте установку через Finder (раздел «Legacy/Classic Outlook for Mac — папка WEF») либо выдайте приложению Terminal Full Disk Access в System Settings → Privacy & Security → Full Disk Access.
  • Устаревший UI в Outlook. Полностью закройте Outlook (Cmd+Q) и откройте снова. В OWA можно также удалить запись из My add-ins и добавить манифест заново.
  • Ошибки парсинга манифеста на Mac. Откройте приложение Console.app и отфильтруйте логи по слову Outlook — при старте клиент логирует ошибки валидации манифеста.
  • Надстройка пропала после выхода Mac из сна. Outlook for Mac иногда теряет регистрацию в папке WEF. Скопируйте файл манифеста в wef/ заново и перезапустите Outlook.
Последнее обновление