Руководство по App Zoom
OOMOL позволяет один раз подключить ваш аккаунт Zoom, а затем использовать инструменты Zoom из поддерживаемых AI-агентов и workflows OOMOL. В этом руководстве описано, как добавить App Zoom, какие разрешения использует OOMOL, что можно делать с Zoom, как устранять распространённые проблемы и как удалить App.
Предварительные требования
- Аккаунт OOMOL.
- Аккаунт Zoom, который вам разрешено авторизовать для сторонних apps.
- Доступ к OOMOL Console по адресу https://console.oomol.com/.
- Если ваша организация Zoom ограничивает Marketplace apps, администратору Zoom может потребоваться разрешить App OOMOL до того, как вы сможете её авторизовать.
Добавление App
- Войдите в OOMOL Console.
- Откройте Connectables или перейдите напрямую в Connections.
- Найдите Zoom.
- Выберите Zoom, затем выберите Connect.
- OOMOL перенаправит вас в Zoom. Войдите в Zoom, если появится запрос.
- Проверьте экран авторизации Zoom, включая запрашиваемые разрешения.
- Выберите Allow, чтобы авторизовать OOMOL.
- После перенаправления из Zoom обратно в OOMOL убедитесь, что Zoom отображается как подключённый в ваших подключениях OOMOL.
Если какой-либо шаг завершился ошибкой, см. Устранение неполадок.
После авторизации OOMOL сохраняет подключение, необходимое для вызова инструментов Zoom от вашего имени. Затем вы можете использовать инструменты Zoom из поддерживаемых OOMOL агентов и workflows.
Использование
Инструменты Zoom доступны только после подключения аккаунта Zoom. Точный список инструментов, отображаемый в OOMOL, может меняться при обновлении коннектора, но текущий коннектор Zoom включает инструменты для чтения профиля пользователя Zoom, списка встреч, создания встреч и обновления встреч.
Используемые разрешения
OOMOL использует эти scopes Zoom, чтобы авторизованные администраторы аккаунтов Zoom могли подключить Zoom как App в OOMOL, а затем сделать одобренные инструменты встреч Zoom доступными своим AI-агентам и повторно используемым Skills.
Обязательные scopes:
| Scope Zoom | Используется | Почему OOMOL использует его |
|---|---|---|
user:read:user:admin | Get User | Идентифицировать подключённый аккаунт Zoom после OAuth-авторизации и показать авторизованного пользователя Zoom в OOMOL. OOMOL использует эту информацию, чтобы показать владельца аккаунта, управлять подключением App и записывать, какой аккаунт Zoom использовался при выполнении инструмента. |
meeting:write:meeting:admin | Create Meeting | Создавать встречи Zoom через OOMOL Tools. Пользователь или агент может запросить встречу, а OOMOL создаёт её с использованием авторизованного аккаунта Zoom. |
Необязательные scopes:
| Scope Zoom | Используется | Почему OOMOL использует его |
|---|---|---|
meeting:read:list_meetings:admin | List Meetings | Находить или перечислять существующие встречи авторизованного пользователя Zoom, когда пользователь просит агента сделать это. OOMOL использует это разрешение, чтобы Zoom Tools могли показать сведения о существующих встречах до выбора встречи для просмотра или follow-up. |
meeting:update:meeting:admin | Update Meeting | Обновлять существующую встречу Zoom, когда пользователь просит агента изменить тему, время начала, длительность или связанные настройки встречи. Если этот необязательный scope не предоставлен, действия обновления встреч недоступны. |
Если пользователь или администратор Zoom не предоставляет необязательный scope, подключение Zoom может существовать, но инструменты, зависящие от этого scope, могут быть недоступны или завершаться ошибкой до предоставления разрешения.
Поддерживаемые инструменты Zoom
| Инструмент | Поддерживаемая функция | Типичный сценарий | Предварительные требования |
|---|---|---|---|
| Get User | Читает базовую информацию профиля авторизованного пользователя Zoom. | Подтвердить, какой аккаунт Zoom подключён, перед использованием Zoom агентом или workflow. | Zoom подключён в OOMOL, и подключённый аккаунт Zoom активен. |
| List Meetings | Получает встречи, доступные авторизованному аккаунту Zoom. | Проверить предстоящие встречи Zoom перед подготовкой повестки, напоминания, follow-up или связанного workflow. | Zoom подключён в OOMOL, и подключённый аккаунт Zoom имеет разрешение просматривать запрошенные встречи. |
| Create Meeting | Создаёт встречу Zoom для авторизованного аккаунта Zoom. | Запланировать звонок с клиентом, проектную синхронизацию, интервью, занятие или внутренний обзор. | Zoom подключён в OOMOL, аккаунт может создавать встречи, и workflow содержит необходимые сведения о встрече. |
| Update Meeting | Обновляет сведения существующей встречи Zoom. | Изменить тему встречи, запланированное время, длительность, часовой пояс, повестку или другие поддерживаемые настройки. | Zoom подключён в OOMOL, аккаунт может обновить встречу, и workflow содержит ID встречи и обновлённые сведения. |
Get User
Сценарий: подтвердить, какой аккаунт Zoom подключён, перед использованием Zoom агентом или workflow. Это полезно, если вы управляете несколькими аккаунтами Zoom или хотите проверить авторизованный аккаунт во время настройки.
Предварительные требования:
- Zoom подключён в OOMOL.
- Подключённый аккаунт Zoom активен.
Что делает инструмент:
- Читает базовую информацию об авторизованном пользователе Zoom.
- Не создаёт, не обновляет и не удаляет встречи Zoom.
List Meetings
Сценарий: дать агенту возможность проверить предстоящие встречи Zoom перед подготовкой повестки, созданием напоминания, планированием follow-up или координацией с другим календарём или проектным инструментом.
Предварительные требования:
- Zoom подключён в OOMOL.
- Подключённый аккаунт Zoom имеет разрешение просматривать запрошенные встречи.
Что делает инструмент:
- Получает встречи, доступные авторизованному аккаунту Zoom.
- Возвращает метаданные встречи, доступные Zoom для авторизованного пользователя, например тему встречи, сведения расписания и данные подключения, если они доступны.
- Не изменяет встречи.
Create Meeting
Сценарий: дать агенту возможность запланировать встречу Zoom как часть workflow, например клиентский звонок, проектную синхронизацию, интервью, занятие или внутренний обзор.
Предварительные требования:
- Zoom подключён в OOMOL.
- Подключённый аккаунт Zoom имеет разрешение создавать встречи.
- У агента или workflow есть необходимые сведения о встрече, например тема, дата, время, часовой пояс и настройки встречи.
Что делает инструмент:
- Создаёт встречу Zoom для авторизованного аккаунта Zoom на основе переданных входных данных.
- Возвращает сведения о встрече, доступные через Zoom, например ID встречи и join URL, если они доступны.
- Сам не приглашает участников, если активный workflow OOMOL не использует другое подключённое app, например e-mail или календарь, для отправки приглашений.
Update Meeting
Сценарий: дать агенту возможность обновить существующую встречу Zoom при изменении планов, например тему, запланированное время, длительность, часовой пояс, повестку или другие поддерживаемые настройки.
Предварительные требования:
- Zoom подключён в OOMOL.
- Подключённый аккаунт Zoom имеет разрешение обновлять целевую встречу.
- У агента или workflow есть ID встречи и обновлённые сведения.
Что делает инструмент:
- Обновляет существующую встречу Zoom для авторизованного аккаунта Zoom на основе переданных входных данных.
- Не создаёт новую встречу.
- Не удаляет встречу.
Устранение неполадок
Не удаётся добавить App Zoom
- Убедитесь, что вы вошли в правильный аккаунт OOMOL.
- Убедитесь, что вы входите в тот аккаунт Zoom, который хотите подключить.
- Если аккаунт Zoom принадлежит организации, спросите администратора Zoom, требуют ли сторонние Marketplace apps или это app административного approval.
- Попробуйте отключить любое неудачное или частичное подключение Zoom в OOMOL, затем подключите снова.
- Если проблема сохраняется, обратитесь в поддержку OOMOL и укажите e-mail аккаунта OOMOL, e-mail аккаунта Zoom, время попытки, а также сообщение об ошибке или скриншот.
Инструмент Zoom не находит встречу
- Подтвердите, что подключённый аккаунт Zoom имеет доступ к встрече.
- Подтвердите, что workflow использует правильный диапазон дат, часовой пояс, ID встречи или вход поиска.
- Если вы недавно изменили разрешения Zoom, переподключите Zoom в OOMOL, чтобы обновить состояние авторизации.
Инструмент Zoom не может создать встречу
- Подтвердите, что подключённый аккаунт Zoom может создавать встречи напрямую в Zoom.
- Проверьте, что время начала, длительность, часовой пояс и обязательные поля встречи действительны.
- Если аккаунт Zoom управляется организацией, подтвердите, что политика аккаунта разрешает создание встреч через авторизованные apps.
Инструмент Zoom не может обновить встречу
- Подтвердите, что подключённый аккаунт Zoom владеет встречей или имеет разрешение на её обновление.
- Подтвердите, что workflow использует правильный ID встречи.
- Проверьте, что обновляемые поля допустимы для Zoom, например время начала, длительность, часовой пояс и повестка.
- Если разрешение на обновление было настроено в Zoom как необязательное, переподключите Zoom и предоставьте разрешение при запросе.
Удаление App
Вы можете удалить App Zoom из OOMOL или Zoom. Мы рекомендуем удалить её в обоих местах, если вы больше не хотите, чтобы OOMOL имел доступ к Zoom.
Удалить Zoom из OOMOL
- Войдите в OOMOL Console.
- Откройте Connections.
- Найдите Zoom среди подключённых apps.
- Откройте сведения подключения Zoom.
- Выберите Disconnect, Remove или эквивалентное действие удаления, показанное в OOMOL.
- Подтвердите удаление.
Удалить OOMOL из Zoom
- Войдите в аккаунт Zoom и откройте Zoom App Marketplace.
- Откройте Manage.
- Откройте Added Apps или найдите OOMOL.
- Выберите App OOMOL.
- Выберите Remove.
Что происходит после удаления
- OOMOL больше не сможет использовать инструменты Zoom для вашего аккаунта после удаления или деавторизации подключения Zoom.
- Workflows или агенты, зависящие от Zoom, могут завершаться ошибкой, пока вы не подключите Zoom снова.
- Существующие встречи Zoom, созданные до удаления, остаются в Zoom, если вы не удалите их в Zoom.
- Удаление App не удаляет ваш аккаунт OOMOL.
Обработка данных
OOMOL получает доступ к данным Zoom только после того, как администратор аккаунта Zoom авторизует App и пользователю или одобренному действию агента требуется Zoom. OOMOL использует данные Zoom только для предоставления инструментов Zoom, запрошенных через поддерживаемых OOMOL агентов, повторно используемые Skills и workflows.
- OAuth-токены Zoom хранятся зашифрованными.
- OAuth-токены Zoom не раскрываются AI-агентам, prompts, файлам проекта или конечным пользователям.
- OOMOL может обрабатывать профиль пользователя Zoom и метаданные встреч при вызове инструмента Zoom.
- Данные встреч и пользователей Zoom могут храниться только по необходимости в видимых пользователю результатах инструментов, записях использования, истории выполнения или операционных записях.
- Сохранённые данные шифруются в состоянии хранения и передаются через TLS/SSL.
- OOMOL не продаёт ваши данные Zoom.
- OOMOL не использует ваши данные Zoom для рекламы.
- OOMOL не использует приватный клиентский контент для обучения AI-моделей.
- OOMOL не хранит аудио, видео, расшифровки или файлы записей встреч Zoom как часть этого коннектора, если вы отдельно не используете другой workflow OOMOL, который явно скачивает или сохраняет такой контент.
- Когда вы удаляете или деавторизуете App Zoom, OOMOL прекращает использовать отозванную авторизацию Zoom. OOMOL удаляет или инвалидирует сохранённые токены авторизации Zoom согласно обычному процессу удаления подключения.
- Некоторые журналы, записи поддержки, записи безопасности или записи, связанные с биллингом, могут сохраняться, как описано в политике конфиденциальности.
FAQ
Нужен ли платный аккаунт Zoom?
Большинство инструментов OOMOL Zoom могут быть авторизованы аккаунтом Zoom с необходимыми разрешениями Zoom. Некоторые функции Zoom могут зависеть от вашего плана Zoom или политики организации.
Можно ли подключить несколько аккаунтов Zoom?
Используйте OOMOL Console, чтобы проверить текущие варианты подключения, доступные вашему аккаунту или workspace. Если нужна помощь с несколькими аккаунтами Zoom, обратитесь в поддержку.
Может ли агент автоматически использовать Zoom после подключения?
Подключение Zoom делает инструменты Zoom доступными в OOMOL, но использование инструментов всё равно зависит от выбранного агента, workflow и разрешений. Сервисы на основе аккаунтов по-прежнему требуют вашей авторизации.
Связаться с поддержкой
Если вам нужна помощь с добавлением, использованием или удалением App Zoom, обратитесь в поддержку OOMOL:
- Email: support@oomol.com
- Страница поддержки: https://oomol.com/ru/support/
Укажите e-mail аккаунта OOMOL, e-mail подключённого аккаунта Zoom, если применимо, действие, которое вы пытались выполнить, а также сообщение об ошибке или скриншот.