メインコンテンツにスキップ
すべてのコレクション🔗外部サービス(アプリ)との連携Zoom
Zoom(OAuth)およびZoom Phoneのマイアプリ登録方法
Zoom(OAuth)およびZoom Phoneのマイアプリ登録方法

2024年10月9日時点の仕様です。

Yoom 運営事務局 avatar
対応者:Yoom 運営事務局
今週アップデートされました

ZoomおよびZoom Phoneをマイアプリに登録するためには「Client ID」と「Client secret」が必要です。

ここではOAuth方式で上記の「Client ID」と「Client secret」を取得する方法を説明します。

それぞれをマイアプリへ登録するには、Zoomのアカウント登録(無料)が必要です。

アカウント未登録の場合は、マイアプリ登録前にこちらよりZoomのアカウントをご登録ください。

※こちらの連携方法は、ZoomのAdmin-managedの権限範囲での連携となります。

User-managedの権限範囲で連携したい場合はこちらをご参照ください。

Zoom App Marketplaceでのアプリ登録

  1. こちらのページにアクセスし、ログイン(サインイン)します。

  2. 右上のDevelopというメニューから「Build App」をクリックします。

3.General Appを選択し、Createを押します。

4.設定画面に遷移するので、左上のアプリ名の鉛筆マークを押し、任意のアプリ名に設定します。

5.同じ画面上にあるSelect how the app is managedという項目内を以下のように変更します。

  • Admin-managedにチェックをつけ、Saveを押します。

6.同じ画面内下部にあるOAuth Informationという項目内を以下のように設定します。

  • OAuth Redirect URLという欄にまず以下のURLをペーストします。

    ​HTTPS://yoom.fun/settings/my_apps/oauth_callback
  • その後、以下のURLをOAuth Redirect URLの先ほど入力したURLの上から再度ペーストします。また、OAuth Allow Listsの欄にも同様にペーストします。

    https://yoom.fun/settings/my_apps/oauth_callback

    ※Use Strict Mode for Redirect URLsとSubdomain Checkについてはチェックは不要です。

7.次に左メニューのScopesを押して、Add Scopesメニューにアクセスし、添付赤枠の
+Add Scopesを押します。

8.検索窓に以下記載のScope内容をコピー&ペーストで入れ、表示された対象Scopeにチェックを入れていき、すべてのチェックが完了したらDoneを押します。

このとき○○:adminか○○:masterのいずれかが表示される場合は、admin側のチェックをつけてください。

※Zoom(OAuth)とZoom Phoneでそれぞれ選択するScopeが異なります。

以下はZoom(OAuth)と連携時に選択するScopeです。

--------------------------------------------------

  • Report

    • report:read:user:admin

  • Meeting

    • meeting:write:meeting

    • meeting:read:list_meetings

  • Webinar

    • webinar:write:registrant

    • webinar:read:list_registrants

    • webinar:read:list_webinars

  • Recording

    • cloud_recording:read:list_recording_files

  • User

    • user:update:settings

    • user:delete:user

    • user:write:user:admin

    • user:read:user

--------------------------------------------------

以下はZoom Phoneと連携時に選択するScopeです。

--------------------------------------------------

  • Phone(Zoom Phoneと連携する場合に必要なScopeです)

    • phone:read:list_call_logs:admin

    • phone:read:call_log:admin

    • phone:read:audio:admin

    • phone:read:list_call_recordings:admin

    • phone:read:call_recording:admin

    • phone:read:user:admin

--------------------------------------------------

9.すべての設定が完了したら、画面左にあるApp CredentialsからClientIDとClient Secretをそれぞれコピーします。

Yoomで「Client ID」と「Client secret」を登録

上記で取得した「Client ID」と「Client secret」をYoomで登録します。

Yoomの「マイアプリ」ページからZoom(OAuth)を選択し、取得した「Client ID」と「Client secret」を設定し、登録するボタンをクリックしてください。

Zoomの認証画面が表示されるため、「Allow」ボタンをクリックしてください。

Zoom Phoneの連携で認証エラーが発生する場合

この場合、以下を参考にZoom、Zoom Phoneのプランや設定をご確認ください。

アカウントタイプの確認

ZoomアカウントにZoom Phone機能が有効化されていることを確認してください。この機能は通常、ビジネスまたはエンタープライズアカウントで利用可能です。無料または基本アカウントを使用している場合は、Zoom Phone機能を利用するためにアップグレードが必要です。

ライセンスの割り当て確認

Zoom Phone APIにアクセスしようとしているユーザーアカウントにZoom Phoneライセンスが割り当てられていることを確認してください。Zoom管理ポータルにログインし、「ユーザー管理」セクションに移動して、各ユーザーに割り当てられているライセンスを確認します。ライセンスが割り当てられていない場合は、ユーザーに割り当てる必要があります。

ユーザーに対するZoom Phoneの有効化

ユーザーにZoom Phoneが有効化されていない場合は、管理ポータルを通じて有効化できます。「電話システム管理」に移動し、「ユーザー」を選択します。そこから、ユーザーを見つけて、そのアカウントに対してZoom Phoneを有効化します。

以上で、Zoom(OAuth)およびZoom Phoneのマイアプリ登録が完了です 🎉

こちらの回答で解決しましたか?