# Discourse Zoom
**URL:** https://meta.discourse.org/t/discourse-zoom/142711
**Category:** Plugin
**Tags:** official, zoom
**Created:** [26.Февраль.2020 19:18:08 UTC](https://meta.discourse.org/t/discourse-zoom/142711 "2020-02-26T19:18:08Z")
**Posts on this page:** 20
**Page:** 1
### Author:  [@Discourse](https://meta.discourse.org/u/Discourse)
#### Post date: [26.Февраль.2020 19:18:08 UTC](https://meta.discourse.org/t/discourse-zoom/142711/1 "2020-02-26T19:18:08Z")
| | | |
| --- | --- | --- |
| :discourse2: | **Краткое описание** | **Discourse Zoom** предоставляет администраторам и пользователям Discourse с платной подпиской Zoom возможность планировать, управлять и участвовать в вебинарах Zoom непосредственно из платформы Discourse. |
| 🛠 | **Ссылка на репозиторий** | [https://github.com/discourse/discourse-zoom](https://github.com/discourse/discourse-zoom) |
| 📖 | **Руководство по установке** | [Как установить плагины в Discourse](https://meta.discourse.org/t/install-plugins-in-discourse/19157) |
> [@](#):
>
> :discourse2: Поскольку это #официальный плагин, поддерживаемый командой Discourse, #поддержка, #содействие:ошибки, #содействие:ux и #содействие:функции могут быть запрошены в соответствующих категориях на Meta, с указанием соответствующего тега плагина. Нажмите на одну из ссылок ниже, чтобы создать запрос. 👍
>
> [❓ **Поддержка**](https://meta.discourse.org/new-topic?category_id=6&body=%3E%20Before%20asking,%20did%20you%20search%20first%3F%20Press%20%F0%9F%94%8D%20at%20the%20upper%20right%20to%20search.&tags=zoom "Запрос поддержки по настройке и использованию Discourse Zoom") [🐛 **Ошибка**](https://meta.discourse.org/new-topic?category_id=1&tags=zoom "Сообщение об ошибке означает, что что-то сломано и мешает нормальному использованию плагина") [👀 **UX**](https://meta.discourse.org/new-topic?category_id=9&tags=zoom "Обсуждение пользовательского интерфейса Discourse Zoom и того, как представлены функции (включая язык и элементы интерфейса)") [💡 **Функция**](https://meta.discourse.org/new-topic?category_id=2&tags=zoom "Обсуждение того, как можно улучшить или расширить существующие функции Discourse Zoom, и как могут работать предлагаемые новые функции")
## Обзор
Этот плагин интегрирует вебинары Zoom в экземпляр Discourse. Вебинары Zoom могут быть связаны с темами, пользователи Discourse могут регистрироваться на вебинары и присоединяться к ним, когда они начинаются.
> ⚠ В связи с тем, что Zoom прекращает поддержку аутентификации JWT, начиная с 1 августа 2023 года механизм аутентификации плагина изменился с JWT (теперь устаревшего, Zoom удалит его 1 сентября) на Server-to-Server OAuth. Существующим пользователям плагина необходимо обновить свои настройки.
### Возможности
- Когда начинается вебинар Zoom, кнопка «Регистрация» автоматически переключается на «Присоединиться», и при нажатии на неё вебинар запускается с использованием Zoom SDK на выделенной конечной точке внутри вашего сообщества Discourse
- Автоматически напоминает зарегистрированным участникам вебинара за N минут до начала события (N настраивается в параметрах плагина, по умолчанию напоминания отключены)
- Администраторы могут добавлять панелей к вебинару в Discourse
- Администраторы могут добавить ссылку на видеозаписи вебинара в Discourse, которая затем отображается пользователям после завершения события
- Ведущие и панелей вебинаров Zoom связаны с учетными записями пользователей Discourse
## Использование
Чтобы использовать плагин Discourse Zoom, сначала необходимо установить его в вашем экземпляре Discourse и настроить с учетными данными вашего приложения Zoom Server-to-Server OAuth. После настройки плагина вы можете создать новый вебинар Zoom, создав новую тему и связав её с вебинаром. Затем пользователи могут зарегистрироваться на вебинар непосредственно из темы.
## Установка
### Шаг 1: Установка плагина в ваш экземпляр Discourse
Вы можете установить плагин в ваш экземпляр Discourse, следуя [инструкциям здесь](https://meta.discourse.org/t/install-plugins-in-discourse/19157).
### Шаг 2: Создание приложения Server-to-Server OAuth в Zoom Marketplace
* * *
Чтобы начать, вам нужно создать [приложение Server-to-Server OAuth](https://developers.zoom.us/docs/internal-apps/create/) в Zoom Marketplace. Это приложение потребуется для отправки запросов к API Zoom и получения уведомлений о событиях через Webhooks.
* * *
### Шаг 3: Настройка плагина
После установки плагина перейдите к настройкам вашего сайта Discourse и установите флажок `zoom enabled`, затем сохраните.
В Zoom Marketplace перейдите на вкладку **App Credentials** :
Затем скопируйте и вставьте значения в соответствующие настройки сайта в вашем экземпляре Discourse:
- `zoom s2s account id`
- `zoom s2s client id`
- `zoom s2s client secret`
### Шаг 4: Установите секретный токен webhook
На вкладке **Feature** вашего приложения Zoom Server-to-Server OAuth скопируйте «Secret Token» и добавьте его в настройку сайта `zoom webhooks secret token` вашего сайта Discourse.
### Шаг 5: Включите подписки на события
Оставаясь на вкладке **Feature** вашего приложения Zoom Server-to-Server OAuth, включите «Event Subscriptions» и нажмите кнопку Add Event Subscription:
Затем установите «Event notification endpoint URL» в:
`https://YOURSITE.COM/zoom/webhooks/webinars.json`
затем нажмите кнопку + Add Events:
Откройте вкладку **Webinar** из списка типов событий и отметьте все перечисленные события. Если вы не видите разрешения на события **Webinar** , проверьте [как включить разрешения](https://developers.zoom.us/docs/internal-apps/#enable-permissions).
Под «Event notification endpoint URL», который вы установили ранее, найдите кнопку Validate:
Если всё сработало, должно появиться 
Наконец, нажмите кнопку Save внизу страницы
### Шаг 6: Scopes
После того как вы настроили подписки на события, перейдите на вкладку `Scopes` и нажмите кнопку `Add Scopes`. Здесь вы выберете следующие области действия, либо выполнив поиск по указанным в таблицах значениям, либо вручную, либо используя частичные значения, например, вместо поиска `webinar:read:list_panelists:admin` ищите `webinar:read:`. Это сузит отображаемые элементы, чтобы было легче найти нужные.
В приложении Server to server OAuth на вкладке scopes нажмите кнопку `Add Scopes`, и появится окно:
В поле поиска scopes ищите по полному или частичному имени. Для удобства вы можете скопировать и вставить каждое из следующих scopes в соответствующие таблицы или найти их на соответствующих вкладках:
**Users**
| scope | desc |
| --- | --- |
| user:read:user:admin | View a user |
| user:read:email:admin | Verify a user’s email |
| user:read:list\_users:admin | View users |
**Webinar**
| scope | desc |
| --- | --- |
| webinar:read:list\_panelists:admin | View a webinar’s panelists |
| webinar:read:list\_absentees:admin | View a past webinar’s absentees |
| webinar:read:webinar:admin | View a webinar |
| webinar:read:registrant:admin | View a webinar’s registrant |
| webinar:read:list\_registrants:admin | View a webinar’s registrants |
| webinar:write:batch\_registrants:admin | Add registrants to a webinar |
| webinar:delete:webinar:admin | Delete a webinar |
| webinar:write:panelist | Add panelists to a webinar |
| webinar:delete:registrant | Remove a webinar’s registrant |
| webinar:write:webinar | Create a webinar for a user |
| webinar:update:status | Update a webinar’s status |
| webinar:delete:panelist | Remove a webinar’s panelist |
| webinar:update:webinar | Update a webinar |
| webinar:write:registrant | Add a registrant to a webinar |
**Webinar**
| scope | desc |
| --- | --- |
| webinar:read:list\_panelists:admin | View a webinar’s panelists |
| webinar:read:list\_absentees:admin | View a past webinar’s absentees |
| webinar:read:webinar:admin | View a webinar |
| webinar:read:registrant:admin | View a webinar’s registrant |
| webinar:read:list\_registrants:admin | View a webinar’s registrants |
| webinar:write:batch\_registrants:admin | Add registrants to a webinar |
| webinar:delete:webinar:admin | Delete a webinar |
| webinar:write:panelist | Add panelists to a webinar |
| webinar:delete:registrant | Remove a webinar’s registrant |
| webinar:write:webinar | Create a webinar for a user |
| webinar:update:status | Update a webinar’s status |
| webinar:delete:panelist | Remove a webinar’s panelist |
| webinar:update:webinar | Update a webinar |
| webinar:write:registrant | Add a registrant to a webinar |
### Шаг 7: Создание приложения Meeting SDK
> ⚠ Zoom изменил некоторые вещи на своей стороне, мы работаем над обновлением руководства.
* * *
Приложение SDK для встреч аутентифицирует пользователя, чтобы он мог присоединиться к вебинару
* * *
Начните с создания `General App`, и в разделе `Select how the app is managed` выберите `User-managed`.
На вкладке Basic Information вашего General App скопируйте и вставьте `Client ID/ SDK key` в поле `zoom sdk key`, а `Client Secret/SDK secret` — в поле `zoom sdk secret`.
Прокрутив вниз, вы найдете раздел `OAuth Information`. В поле `OAuth Redirect URL` укажите URL вашего сайта, например, `https://YOURSITE.com`.
### Шаг 8: Укажите использование вашего приложения
На вкладке `Features` выберите подвкладку `Embed`, включите `Meeting SDK`
## Ограничения
Плагин работает только с вебинарами, которые не требуют регистрации в Zoom.
## Уведомление о критических изменениях
Из-за устаревания в API Zoom старые экземпляры плагина необходимо будет настроить в соответствии с шагами, указанными в этом сообщении.
> :discourse2: Размещено нами? Этот плагин доступен в наших планах Enterprise.
---
### Author:  [@Planeshifter](https://meta.discourse.org/u/Planeshifter)
#### Post date: [03.Март.2020 19:51:09 UTC](https://meta.discourse.org/t/discourse-zoom/142711/2 "2020-03-03T19:51:09Z")
Большое спасибо за работу над этим, отличная функция!
Мне удалось установить плагин, создать приложение JWT в Zoom и настроить Discourse, как описано.
Однако у меня возникли проблемы при использовании кнопки «Zoom Webinar» в редакторе для привязки запланированного совещания к сообщению.
Будет здорово, если вы сможете добавить пояснение, что именно нужно вводить в текстовое поле под надписью «Add Webinar». Ни ID совещания, ни полный URL для меня не работают.
Ещё один небольшой замеченный мною момент: ссылка на репозиторий на странице «Плагины» в панели администратора ведёт на [https://github.com/discourse-org/discourse-zoom](https://github.com/discourse-org/discourse-zoom), хотя должна вести на [GitHub - discourse/discourse-zoom: Integrate Zoom events in Discourse. · GitHub](https://github.com/discourse/discourse-zoom).
---
### Author:  [@downey](https://meta.discourse.org/u/downey)
#### Post date: [03.Март.2020 19:58:28 UTC](https://meta.discourse.org/t/discourse-zoom/142711/3 "2020-03-03T19:58:28Z")
Интересная концепция, и выглядит как отличный опыт для участников сообщества!
Меня интересует, обсуждалась ли уже возможность более универсального (независимого от вендора) рабочего процесса с этим плагином; по сути, чтобы предлагать аналогичную интеграцию таймера обратного отсчета до конкретной даты и времени, указание хоста и/или спикера, ссылку на URL вебинара, последующие ссылки на записи и т. д.
В качестве примера я имел в виду Jiti (с открытым исходным кодом), но, очевидно, в этой области есть несколько вариантов.
---
### Author:  [@pmusaraj](https://meta.discourse.org/u/pmusaraj)
#### Post date: [04.Март.2020 00:13:42 UTC](https://meta.discourse.org/t/discourse-zoom/142711/4 "2020-03-04T00:13:42Z")
> [@Planeshifter](#):
>
> Было бы здорово, если бы вы могли добавить пояснение, что именно нужно вводить в текстовое поле под кнопкой «Добавить вебинар». Ни ID встречи, ни полная ссылка, похоже, не работают у меня.
Вам нужно ввести ID вебинара. В логах вашего сайта в папке `/logs` вы сможете увидеть более подробную информацию, если добавление события в модальном окне по-прежнему не удаётся. Я также исправил проблему со ссылкой, о которой вы упомянули, спасибо за сообщение об этом.
> [@downey](#):
>
> Меня интересует, обсуждалось ли уже возможность создания более универсального (независимого от вендора) рабочего процесса с этим плагином; по сути, чтобы предлагать возможность встраивания таймера обратного отсчёта до конкретной даты и времени, указывать ведущего и/или участников панельной дискуссии, ссылку на URL вебинара, позже — ссылки на записи и так далее.
К сожалению, на данный момент универсальный рабочий процесс, независимый от вендора, не поддерживается. Однако вызовы API Zoom абстрагированы, поэтому возможно добавить поддержку другого вендора с определёнными усилиями (хотя плагин пришлось бы переименовать в что-то менее связанное с Zoom).
---
### Author:  [@sunjam](https://meta.discourse.org/u/sunjam)
#### Post date: [26.Март.2020 19:40:33 UTC](https://meta.discourse.org/t/discourse-zoom/142711/20 "2020-03-26T19:40:33Z")
Есть ли возможность добавить _поддержку встреч_ без регистрации в этот плагин, а также вебинары? Отличная работа!
---
### Author:  [@davidkingham](https://meta.discourse.org/u/davidkingham)
#### Post date: [04.Апрель.2020 15:58:44 UTC](https://meta.discourse.org/t/discourse-zoom/142711/29 "2020-04-04T15:58:44Z")
Теперь, когда Zoom требует пароль для всех встреч и вебинаров, я думаю, что плагин перестал работать. Я попытался создать вебинар, и при попытке присоединиться появляется ошибка: «Ваше соединение истекло, и вы не можете присоединиться к встрече. Проверьте подключение к сети и повторите попытку».
---
### Author:  [@pmusaraj](https://meta.discourse.org/u/pmusaraj)
#### Post date: [04.Апрель.2020 16:28:09 UTC](https://meta.discourse.org/t/discourse-zoom/142711/30 "2020-04-04T16:28:09Z")
Я разберусь с этим сегодня. Возможно, это временная проблема: веб-клиент Zoom помечен как «на техническом обслуживании» на их странице статуса [status.zoom.us](http://status.zoom.us).
---
### Author:  [@sunjam](https://meta.discourse.org/u/sunjam)
#### Post date: [05.Апрель.2020 00:49:17 UTC](https://meta.discourse.org/t/discourse-zoom/142711/31 "2020-04-05T00:49:17Z")
Хочу лишь уточнить, что использование вебинаров требует минимальной платы в размере 40,00 долларов США в месяц за активацию плюс 14,99 долларов США в месяц за тариф Pro. С уважением.
---
### Author:  [@pmusaraj](https://meta.discourse.org/u/pmusaraj)
#### Post date: [05.Апрель.2020 01:11:52 UTC](https://meta.discourse.org/t/discourse-zoom/142711/32 "2020-04-05T01:11:52Z")
Да, к сожалению, похоже, что Web SDK Zoom сейчас недоступен. Они сообщают, что работают над [возвращением его в строй](https://devforum.zoom.us/t/zoom-web-sdk-affected-due-to-web-client-maintenance/10951) (не совсем понятно, что это означает).
Пока что я добавил обходное решение в плагин: при присоединении к вебинару, если подключение через SDK не удаётся, теперь будет отображаться этот экран:
---
### Author:  [@sheldrake](https://meta.discourse.org/u/sheldrake)
#### Post date: [06.Апрель.2020 10:37:29 UTC](https://meta.discourse.org/t/discourse-zoom/142711/33 "2020-04-06T10:37:29Z")
К сведению: кооператив, который я основал, выбрал [https://bigbluebutton.org/](https://bigbluebutton.org/). Самохостинг обошёлся нам гораздо дешевле, чем аккаунт Zoom для вебинаров.
---
### Author:  [@davidkingham](https://meta.discourse.org/u/davidkingham)
#### Post date: [08.Апрель.2020 17:03:22 UTC](https://meta.discourse.org/t/discourse-zoom/142711/39 "2020-04-08T17:03:22Z")
Привет, Пена, я только что заметил, что в профиле пользователя есть вкладка `Webinar`. Как администратор, я могу её просмотреть, как и ожидалось, но как обычный пользователь я получаю эту ошибку:
```plaintext
Доступ запрещён
при попытке загрузить [/topics/webinar-registrations/chris_murray.json](https://community.naturephotographers.network/topics/webinar-registrations/chris_murray.json)
```
Из логов:
```plaintext
Ошибка: Forbidden
Url: https://community.naturephotographers.network/assets/ember_jquery-57d09ec67e9e407d9b0d42aa1fefd1a470c45310d953b07793a3ca8adc6ec599.js
Строка: 1
Столбец: 267206
Расположение окна: https://community.naturephotographers.network/u/chris_murray/activity
o/t
### Author:  [@pmusaraj](https://meta.discourse.org/u/pmusaraj)
#### Post date: [11.Апрель.2020 20:09:20 UTC](https://meta.discourse.org/t/discourse-zoom/142711/43 "2020-04-11T20:09:20Z")
> [@davidkingham](#):
>
> Я только что заметил, что в профиле пользователя есть вкладка «Webinar». Как администратор, я могу её просматривать, как и ожидалось, но как обычный пользователь получаю эту ошибку.
Мне не удалось воспроизвести эту проблему. Я тестировал на нескольких сайтах с разными именами пользователей, включая локальную установку с именем, содержащим знак подчёркивания.
> [@oneflydown](#):
>
> Не уверен, возможно, плагин использует веб-клиент Zoom, который в последнее время испытывает некоторые проблемы.
Да, плагин использует WebSDK от Zoom, и в некоторых браузерах возникают проблемы.
---
### Author:  [@davidkingham](https://meta.discourse.org/u/davidkingham)
#### Post date: [13.Апрель.2020 22:34:08 UTC](https://meta.discourse.org/t/discourse-zoom/142711/46 "2020-04-13T22:34:08Z")
К сведению: я только что провёл вебинар с использованием этого функционала, и кнопка «Присоединиться» вообще не работала — у всех возникло тайм-аут-сообщение от Zoom. Однако я перенаправил всех на обычную ссылку Zoom, которая работала без проблем. Похоже, WebSDK испытывает множество проблем. Возможно, стоит добавить возможность указывать URL для кнопки «Присоединиться» вручную, вместо того чтобы полагаться на WebSDK, который даёт сбои?
---
### Author:  [@pmusaraj](https://meta.discourse.org/u/pmusaraj)
#### Post date: [14.Апрель.2020 01:47:04 UTC](https://meta.discourse.org/t/discourse-zoom/142711/47 "2020-04-14T01:47:04Z")
SDK Zoom должен работать, если вы развернули проект — я обновлял плагин на прошлой неделе. Однако они заблокировали все предыдущие версии, так что, если вы не развертывали проект недавно, это может быть причиной проблемы. И добавление ссылки Zoom в качестве опции выглядит логичным.
---
### Author:  [@davidkingham](https://meta.discourse.org/u/davidkingham)
#### Post date: [14.Апрель.2020 02:23:09 UTC](https://meta.discourse.org/t/discourse-zoom/142711/48 "2020-04-14T02:23:09Z")
Спасибо, Пенар. Я не знал, что есть обновление. Надеюсь, это исправит проблему в следующий раз.
Вопрос насчёт видео, которое можно добавить после: это работает только для записей из облака Zoom? Если я использую Vimeo или YouTube, система пишет, что это неподдерживаемый формат. Просто любопытно, не критично, так как я могу просто включить его в пост.
---
### Author:  [@pmusaraj](https://meta.discourse.org/u/pmusaraj)
#### Post date: [15.Апрель.2020 02:05:54 UTC](https://meta.discourse.org/t/discourse-zoom/142711/49 "2020-04-15T02:05:54Z")
> [@davidkingham](#):
>
> Это работает только для облачных записей Zoom?
Да, это поле работает только с URL-адресом прямого видеофайла. YouTube или Vimeo не подойдут, но, как вы правильно заметили, для ссылок на YouTube/Vimeo гораздо проще использовать одноблочное встраивание.
---
### Author:  [@sheldrake](https://meta.discourse.org/u/sheldrake)
#### Post date: [15.Апрель.2020 11:22:01 UTC](https://meta.discourse.org/t/discourse-zoom/142711/50 "2020-04-15T11:22:01Z")
См.: [BigBlueButton video conference](https://meta.discourse.org/t/bigbluebutton-video-conference/148050)
---
### Author:  [@davidkingham](https://meta.discourse.org/u/davidkingham)
#### Post date: [02.Май.2020 15:20:27 UTC](https://meta.discourse.org/t/discourse-zoom/142711/51 "2020-05-02T15:20:27Z")
Небольшой фидбек после нескольких использований.
1. Кнопка «Присоединиться», скрытая до начала вебинара, неудобна для пользователей. Я получаю несколько писем до начала вебинара с вопросом, где ссылка для подключения, хотя я указал это в описании вебинара и в уведомлении о том, что кнопка появится с началом трансляции. Люди просто не читают. Лично я предпочёл бы, чтобы кнопка «Присоединиться» всегда была видна: если на неё нажать раньше времени, система просто сообщит, что вебинар ещё не начался, и пользователи вернутся, чтобы уточнить точное время начала.
2. Возможно ли добавить поддержку репетиций? В случае с вебинарами есть такая опция: ведущий и спикеры могут общаться друг с другом заранее, не включая трансляцию для участников. Они могут перейти по ссылке на встречу в Zoom в это время, и им будет показано уведомление о том, что встреча ещё не началась, но они находятся в своеобразной «комнате ожидания». Как только мы включаем трансляцию, они автоматически подключаются. Это решило бы множество проблем для пользователей.
---
### Author:  [@pmusaraj](https://meta.discourse.org/u/pmusaraj)
#### Post date: [08.Май.2020 02:43:29 UTC](https://meta.discourse.org/t/discourse-zoom/142711/52 "2020-05-08T02:43:29Z")
Приносим извинения за задержку, Дэвид.
> [@davidkingham](#):
>
> Кнопка «Присоединиться», скрытая до начала вебинара, неудобна для пользователей. Я получаю несколько писем до начала вебинара с вопросом, где находится ссылка для присоединения.
Есть настройка, которая, вероятно, поможет вам в этом:
Если установить значение 30, кнопка появится за 30 минут до запланированного времени вебинара.
> [@davidkingham](#):
>
> Возможно ли добавить поддержку репетиций? В случае с вебинарами есть такая опция: ведущий и panelists могут общаться заранее, не транслируя это для участников.
Вы также можете использовать это с помощью настройки выше. По последним данным, вебхуки Zoom не срабатывают, когда репетиция переходит в полноценное мероприятие, что немного усложняет эту ситуацию.
---
### Author:  [@davidkingham](https://meta.discourse.org/u/davidkingham)
#### Post date: [08.Май.2020 23:31:19 UTC](https://meta.discourse.org/t/discourse-zoom/142711/53 "2020-05-08T23:31:19Z")
Спасибо, Пена, но дело не совсем в этом.
Во-первых, моя кнопка «Присоединиться сейчас» больше вообще не работает:
https://www.loom.com/embed/b14f580cd00740e2a6607733fb4cb34f
Ранее она работала, но проблема возникла в последние пару недель. Кроме того, я также не вижу отображения резервной ссылки.
Далее, отдельная проблема, которую я описывал ранее, связана с режимом репетиции. Когда у меня была упомянутая выше проблема, всё работало следующим образом: когда я запускал вебинар в режиме репетиции, кнопка «Присоединиться» не появлялась, независимо от того, как установлено значение «присоединиться к Zoom за X минут до начала». Она появлялась только тогда, когда я фактически начинал трансляцию, что я предпочитаю делать только за 5 минут до начала. В идеале кнопка «Присоединиться» должна появляться в момент, заданный настройкой, тогда участники получали бы уведомление от Zoom о том, что вебинар ещё не начался.
Не могли бы вы добавить опцию, которая просто переключает кнопку регистрации на кнопку «Присоединиться» в заданное время, и при этом использовалась бы прямая ссылка на Zoom? Не резервная ссылка, а принудительная ссылка, чтобы полностью обойти эту проблему. Ещё раз спасибо, Пена!
[Следующая страница](https://meta.discourse.org/t/discourse-zoom/142711.md?page=2)