重要:2023年5月31日以前にZoom連携を設定していた場合は、ZoomのJWT認証の廃止に伴い、2023年8月31日までに、OAuth認証での連携に設定を変更いただく必要があります。手順については、「Zoom連携設定の移行手順」を参照してください。
Zoomとhacomonoを連携するには、初めにZoomの管理画面(Zoom App Marketplace)でZoomのAPIを実行するためのトークンを発行・取得します。取得したAPIトークンをhacomonoの管理サイトに設定することで、Zoomとhacomonoを連携させることができます。
Tips:APIトークンとは、ZoomのAPIを利用するための認証情報です。
STEP 1:Zoomの管理画面でAPIトークンを取得する
設定の前に:Zoomのアカウントをお持ちでない場合は、https://zoom.us/signupにアクセスしてアカウントを作成してください。アカウントのロールは「オーナー」または「管理者」で設定し(推奨)、「サーバー間 OAuth アプリ」(Server-to-server OAuth App)の権限を付与します。どうしても「カスタムロール」のアカウントを使用しなければならない場合は、「サーバー間 OAuth アプリ」の権限に加え、「ユーザー」の編集権限、「ミーティング」の表示権限を付与します。カスタムロールの場合、Zoom側の仕様変更などによって正しく設定できなくなる可能性があります。その場合は、オーナーまたは管理者のアカウントで設定してください。
APIトークンの発行・取得は、以下の手順で行います。
- Zoom App Marketplace(https://marketplace.zoom.us/)にアクセスし、[Sign In]をクリックしてログインします。
- 画面右上の[Develop]をクリックし、表示されるメニューから「Build App」を選択します。
-
[Server to Server OAuth App]を選択して[Create]をクリックします。
-
[App Name]に任意のアプリ名を入力して、[Create]をクリックします。
Note:アプリ名には全角文字(日本語)を使用することはできません。アプリ名は、メンバーサイトには表示されません。 - アプリが作成され、App credentialsの画面が表示されます。
-
[Information]を選択し、[Company Name]に会社名を、[Name]にご担当者のお名前を、[Email]にメールアドレスを入力します。
Note:設定したメールアドレス宛に、Zoomのアップデート情報など、hacomonoでのZoom連携に関係のあるご案内が届きます。 -
[Scopes]を選択し、[Add Scopes]をクリックします。
-
[Meeting]を選択します。
-
[View and manage all user meetings]を選択し、以下にチェックを入れます。
- [Delete a meeting]
- [Update a meeting]
- [Create a meeting for a user]
-
[View and manage sub account's user meetings]を選択し、以下にチェックを入れます。
- [Delete a meeting]
- [Update a meeting]
- [Create a meeting for a user]
-
[User]>[View all user information]を選択します。
-
[View users]にチェックを入れます。
- [Done]をクリックします。
- 以下の設定になっていることを確認します。
-
[Activation]を選択し、[Activate your app]をクリックします。
-
「Your app is activated on the account」が表示されたら、Zoom側の設定は完了です。
-
[App Credentials]を選択し、[Account ID]、[Client ID]、[Client secret]の文字列をコピーして、hacomonoの管理サイトに設定できるように保存しておきます。
[Copy]のクリックで、各項目の文字列をコピーできます。
STEP 2:ZoomのAPIトークンをhacomonoに登録する
Zoomの管理画面で取得したAccount ID、Client ID、Client secretを(「Zoomの管理画面でAPIトークンを取得する」を参照)、hacomonoの管理サイトのアドオン設定に登録します。
Zoomのアドオン設定は、以下の手順で行います。
- 管理サイトのサイドバーから[システム]>[システム設定]を選択し、システム設定の画面で[アドオン設定]タブを選択して、「Zoom」の[追加]をクリックします。
- Zoomの管理画面でコピーしたAccount IDを[Account ID]、Client IDを[Client ID]、Client secretを[Client secret]に入力します。
- オンラインレッスンの運用に合わせて、[ミーティング設定]の各項目にチェックを入れます。
- [保存]をクリックします。
-
[アクティベート]ボタンが表示されるので、クリックします。
-
[Zoom 詳細設定]の[デフォルト Zoom ユーザー ID]に、Zoomのアカウント名が表示されていれば、設定完了です。