> ## Documentation Index
> Fetch the complete documentation index at: https://docs.yahont.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# Zoom

> Индексируйте расшифровки облачных записей Zoom

Коннектор Zoom индексирует расшифровку каждой встречи и вебинара с облачной записью. Укажите ID встреч или вебинаров,
email организаторов или группу Zoom. Если выбрать **Синхронизировать с Zoom**, каждая расшифровка видна только тем,
кто может смотреть запись в Zoom.

## Перед началом

Вам понадобятся:

* Учётная запись администратора Yahont.
* Аккаунт Zoom с тарифом **Pro** или выше и пользователь Zoom, который может создавать приложения в App Marketplace:
  владелец аккаунта или администратор с правом **Server-to-Server OAuth app**.
* Включённая **Audio transcript** в настройках облачной записи Zoom.
  Zoom создаёт расшифровку только для записей, сделанных после включения.
* Дополнение **Webinar**, если вы индексируете вебинары.
* Для **Определённые группы** или [синхронизации прав](#permission-sync) — Yahont Cloud или Enterprise Edition.

## Создание приложения Zoom

**1. Создайте приложение Server-to-Server OAuth**

Войдите на [marketplace.zoom.us](https://marketplace.zoom.us) и откройте **Develop → Build App**.
Выберите **Server to Server OAuth App** и задайте название, например «Yahont».

![Выбор типа приложения в Zoom, один из вариантов — Server to Server OAuth App](https://mintcdn.com/yahont-ai/x5XgCITQq31yLYvE/assets/admins/connectors/zoom/build_app.webp?fit=max\&auto=format\&n=x5XgCITQq31yLYvE\&q=85\&s=acba6e09a18224f89a46c61db6bdd4c6)

**2. Скопируйте учётные данные**

На странице **App Credentials** скопируйте **Account ID**, **Client ID** и **Client Secret**. Yahont нужны все три.

![Страница App Credentials с Account ID, Client ID и Client Secret](https://mintcdn.com/yahont-ai/x5XgCITQq31yLYvE/assets/admins/connectors/zoom/app_credentials.webp?fit=max\&auto=format\&n=x5XgCITQq31yLYvE\&q=85\&s=636f5d08663161fa2caeb820ff9a500e)

**3. Заполните вкладку Information**

Введите краткое описание, название вашей компании и контакт разработчика. Без них Zoom не активирует приложение.

**4. Добавьте scope**

На вкладке **Scopes** выберите **Add Scopes**. Найдите каждый scope из списка ниже,
отметьте его и выберите **Done**.

![Окно Add Scopes, отфильтрованное по scope cloud\_recording:read](https://mintcdn.com/yahont-ai/x5XgCITQq31yLYvE/assets/admins/connectors/zoom/add_scopes.webp?fit=max\&auto=format\&n=x5XgCITQq31yLYvE\&q=85\&s=5daa3c6a64ba4bcf045c8b0735febaf7)

Добавьте эти scope:

* `cloud_recording:read:list_user_recordings:admin`
* `cloud_recording:read:list_recording_files:admin`
* `user:read:list_users:admin`
* `group:read:list_members:admin`
* `meeting:read:meeting:admin`
* `meeting:read:past_meeting:admin`
* `meeting:read:list_past_instances:admin`
* `webinar:read:webinar:admin`
* `webinar:read:list_past_instances:admin`

Для **Синхронизировать с Zoom** добавьте также:

* `cloud_recording:read:recording_settings:admin`
* `cloud_recording:read:list_recording_registrants:admin`
* `user:read:user:admin`
* `user:read:settings:admin`

Все они только для чтения. Yahont никогда ничего не меняет в Zoom.

**5. Активируйте приложение**

На вкладке **Activation** выберите **Activate your app**.

![Вкладка Activation: приложение активировано в аккаунте](https://mintcdn.com/yahont-ai/x5XgCITQq31yLYvE/assets/admins/connectors/zoom/activation.webp?fit=max\&auto=format\&n=x5XgCITQq31yLYvE\&q=85\&s=c7b8dae005318ad413be7cecb2a5bf96)

## Настройка коннектора в Yahont

**1. Выберите тариф Zoom**

В панели администратора откройте **Коннекторы** и выберите **Zoom** в разделе **Встречи**.
В поле **Тариф Zoom** выберите `pro` для аккаунта Pro или `business_plus` для Business, Education,
Enterprise или Partner. Это задаёт, как часто Yahont может обращаться к Zoom.

**2. Добавьте учётные данные**

В разделе **Учётная запись для аутентификации** нажмите **Новая учётная запись Zoom**. Введите **Zoom Account ID**,
**Zoom Client ID** и **Zoom Client Secret** из вашего приложения Zoom, затем нажмите **Создать**.

![Страница настройки Zoom в Yahont с полем «Тариф Zoom» и формой нового аккаунта Zoom](https://mintcdn.com/yahont-ai/x5XgCITQq31yLYvE/assets/admins/connectors/zoom/onyx_credential.webp?fit=max\&auto=format\&n=x5XgCITQq31yLYvE\&q=85\&s=8c5efc2d2197ce11590a5fc56176c0de)

**3. Проверьте подключение**

Нажмите **Запустить проверки**. Yahont проверит учётные данные и scope в Zoom и сообщит обо всём, что Zoom отклонит.

**4. Выберите, что индексировать**

В разделе **Содержимое коннектора** заполните любое из полей:

* **ID встреч** и **ID вебинаров**: номера из приглашения на сеанс, по одному в каждой записи.
* **Email организаторов**: все записи, которые проводят эти люди.
* **ID группы Zoom**: все записи, которые проводят участники группы.
  ID находится в **User Management → Groups** на веб-портале Zoom.

Выключите **Включать встречи** или **Включать вебинары**, чтобы исключить один из типов сеансов.

![Раздел «Содержимое коннектора» на странице настройки Zoom](https://mintcdn.com/yahont-ai/x5XgCITQq31yLYvE/assets/admins/connectors/zoom/onyx_content.webp?fit=max\&auto=format\&n=x5XgCITQq31yLYvE\&q=85\&s=1e893b597cc302b01d9d582e1420726e)

**5. Выберите, кто видит расшифровки**

В разделе **Настройки коннектора** задайте **Доступ к документам**.
С вариантом **Синхронизировать с Zoom** каждая расшифровка видна тем, кто может смотреть запись в Zoom. См.
[Синхронизация прав](#permission-sync).

![Варианты доступа к документам на странице настройки Zoom](https://mintcdn.com/yahont-ai/x5XgCITQq31yLYvE/assets/admins/connectors/zoom/onyx_access.webp?fit=max\&auto=format\&n=x5XgCITQq31yLYvE\&q=85\&s=14aa8dfd48dd460bf46b2932908936aa)

**6. Задайте дату начала и создайте коннектор**

В разделе **Расписание** задайте **Индексировать документы после**.
Без даты первый запуск читает всю историю записей, и это может занять много времени.
Затем нажмите **Создать коннектор**.

## Синхронизация прав

С **Синхронизировать с Zoom** Yahont читает настройку **Link access** каждой записи в Zoom и выдаёт расшифровку тем же
людям. Владелец записи всегда её видит.

![Окно Share облачной записи Zoom с настройкой Link access](https://mintcdn.com/yahont-ai/x5XgCITQq31yLYvE/assets/admins/connectors/zoom/link_access.webp?fit=max\&auto=format\&n=x5XgCITQq31yLYvE\&q=85\&s=8060a3d9a134bf52a6d6a0bbbba376ab)

| Link access в Zoom | Кто видит расшифровку в Yahont |
| - | - |
| Private to me | Владелец |
| Only people with access | Владелец. API Zoom не отдаёт этот список |
| Signed-in users in my account | Все |
| Signed-in users from specific domains | Пользователи с адресами электронной почты в этих доменах |
| Anyone with the link | Все |

Люди, которые зарегистрировались на просмотр записи, видят её расшифровку в любом случае.
Yahont перечитывает настройки каждые 6 часов.

> [!NOTE]
>
> Чтобы ограничить каждую расшифровку её владельцем вместо **Все**,
> выключите **Считать доступ по ссылке публичным** в настройках коннектора.

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

> [accordion] Yahont не может подключиться к Zoom
>
> В ошибке сказано, что Zoom отказался выдать токен. Либо приложение не активировано,
> либо одно из трёх значений неверно. Активируйте приложение на вкладке **Activation**,
> затем снова скопируйте Account ID, Client ID и Client Secret.

> [accordion] Проверка подключения сообщает об отсутствующем scope
>
> В ошибке указан scope, который отклонил Zoom.
> Добавьте этот scope на вкладке **Scopes** приложения и повторите проверку.

> [accordion] Вебинары не индексируются
>
> У организатора нет дополнения Webinar, поэтому Zoom отклоняет все запросы по вебинарам.
> Назначьте дополнение в Zoom или выключите **Включать вебинары**.

> [accordion] Email организатора указан как ошибка индексации
>
> Yahont не нашёл активного пользователя Zoom с этим email. Проверьте написание и то,
> что пользователь всё ещё активен в Zoom. Деактивированный или удалённый пользователь не подходит.

> [accordion] Запись есть в Zoom, но её нет в Yahont
>
> У записи нет аудиорасшифровки, или Zoom ещё её обрабатывает. Включите **Audio transcript** в настройках записи Zoom:
> расшифровка создаётся только для записей, сделанных после этого.

> [accordion] Коллега не видит расшифровку, к которой ему открыт доступ в Zoom
>
> Запись использует **Only people with access**. API Zoom не отдаёт этот список,
> поэтому Yahont выдаёт доступ только владельцу.
> Откройте запись для своего аккаунта или домена либо задайте в настройке коннектора **Доступ к документам** значение
> **Все в вашей организации**.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.