日程調整/Zoom Phoneの準備〜Zoom API連携

日程調整機能は、外部カレンダーサービスとFront Agentを連携する必要があります。

Zoomの設定は、Zoomアカウントの管理者権限ならびにFront Agentアカウントの管理者権限が必要です。

ZoomのAPIを取得

Zoom Marketplaceにアプリ登録

1. こちらのZoom Marketplace(https://marketplace.zoom.us) へサインインしてFront Agentに連携するアプリ登録を行います。

【注意】作業アカウントがテナントオーナーではない場合

権限があるアカウントのAPI設定作業

https://marketplace.zoom.us/ へ権限付与をされたユーザー(メールアドレス)でサインインし、右上プルダウン「Build Legacy App」より遷移します。

画面右下に「Server-to-server OAuth」枠の下「Create」で登録を進めます。

「App Name」に登録名を指定します。ここでは「Sample Server to Server App」と指定しています。「Create」で進みます。

最初に現れる画面上の「Account ID」「Client ID」「Client secret」はFront Agentに登録する際に必要になりますので控えておいて下さい。右下「Continue」で進みます。

Basic Information
App Name：Front Agent
Short Description：Front Agent
Company Name：貴社名(半角英語)

Developer Contact Information
Name : Sample Admin
Email : Zoom管理者メールアドレス

ユーザ情報となる「Name」と「Email address」を入力して「Continue」で進みます。
＊重要な変更事項や通知をメールアドレス宛に送付される場合に使用されるため利用可能なメールアドレスを指定ください。

次の画面は何もせず「Continue」で進みます。

「Scopes」ではトークンでアクセスできるAPIの範囲を指定します。「View and manage all user meeting」のアクセス許可の設定を行ってください。

オンライン会議利用のみと、Zoom Phone利用も含む場合で、スコープの設定が異なります。

【オンライン会議のみ】連携する場合

以下の通り、スコープを設定してください。

• Meeting > View and manage all user meetings
  • Update a meeting
  • Delete a meeting
  • Create a meeting for a user
  • Update a meeting’s in-meeting control

• User > View all user information
  • View a user’s schedulers
  • View users

最後にActivation >「Active your App」をクリックして有効にし、Front Agent側の登録を行います。

【電話Zoom Phoneとweb会議の両方】を連携する場合

以下の通り、スコープを設定してください。

• Meeting > View and manage all user meetings
  • Update a meeting
  • Delete a meeting
  • Create a meeting for a user
  • Update a meeting’s in-meeting control

• User > View all user information
  • View a user’s schedulers
  • View users

• Phone > View all users phone information
  • View phone users
  • View a phone user
  • View a call queue
  • View a call queue’s recordings

【電話Zoom Phoneのみ】を連携する場合

以下の通り、スコープを設定してください。

• User > View all user information
  • View a user’s schedulers
  • View users

• Phone > View all users phone information
  • View phone users
  • View a phone user
  • View a call queue
  • View a call queue’s recordings

（Zoom Phone連携のみ）次に、「Feature」からSecret Tokenをコピーしてください。後程Front Agent側で登録します。

最後にActivation >「Active your App」をクリックして有効にし、Front Agent側の登録を行います。

Front AgentにZoomの情報を登録する

Front Agentのレポートページ > 管理者機能 > Zoomオプション指定のページを開きます。

日程調整のみの場合

Zoomの「Account ID」「Client ID」「Client secret」を対応する項目にコピー&ペーストして登録をして完了です。

登録完了をすると、日程調整機能を使ってZoom会議を自動設定ができるようになります。

日程調整機能

Zoom Phone連携の場合

Zoom Phone連携の場合、Front Agent側に情報を登録してから、Zoom側にFront AgentのWebhook URLを登録して完了です。

1. Zoomの「Account ID」「Client ID」「Client secret」を対応する項目にコピー&ペーストします。
   さらに、「電話」の項目にチェックをつけ、Zoomのfeatureで追加設定した「Secret token」を貼り付けてください。
2. 上記の4項目を記入後、保存ボタンを押します。
3. 保存が完了すると、Webhook URLが出力されます。コピーボタンを押して控えてください。

次に上記作成したZoomのアプリに、Featureの追加設定を行います。

1. Feature > Event Subscriptionsにチェック
2. Subscription nameに適当な名前を入力します。例：PhoneRecording
3. Event notification endpoint URLに、Front Agentで出力したWebhook URLを貼り付けてください
4. Webhook URL貼付後、Validateボタンを押して、Validatedになることを確認
5. Add EventにZoom Phone > Call recording is completedをチェックし、Done
6. 最後にSaveを押す

最後に、一番右下のContinueボタンを押して、Zoomアプリを更新します。

Zoom Phone連携は、この後、自動録音の設定をしてください。

Zoom Phone連携