1. Zoom App MarketplaceでOracle Digital Assistant for Zoomアプリケーションに移動します。
2. Zoomにサインインしていない場合は、「サインインして追加」をクリックします。
3. 「認可」をクリックして、Oracle Digital Assistant for Zoomをインストールします。

1. デジタル・アシスタントで、左側のメニューの「チャネル」をクリックして、「ユーザー」を選択します。

2. 「+チャネル」をクリックして「チャネルの作成」ダイアログを開きます。

3. チャネルの名前を指定します。

4. チャネル・タイプとして「アプリケーションのズーム」を選択します。

5. 許可されたドメイン・フィールドに、ユーザーが接続できる許可されたドメインを入力します。

   このフィールドは、ズーム・アプリケーション・チャネルに接続できるドメインを制御します。ほとんどの場合、すべてのドメインを示すためにアスタリスク・ワイルドカード(*)を入力します。

6. 「作成」をクリックします。

7. をクリックし、チャネルに関連付けるデジタル・アシスタントまたはスキルを選択します。

8. 「ルート先」ドロップダウンで、チャネルに関連付けるデジタル・アシスタントまたはスキルを選択します。

9. 「チャネル有効」コントロールをオンに切り替えます。

10. 次のステップで「秘密キー」および「チャネルID」の値を使用できるように、ページを開いたままにします。

Zoomアプリケーションがインストールされ、チャネルが作成されたら、Zoomインタフェース内でデジタル・アシスタントを使用できるように、ZoomとZoom Appチャネルの間の接続を作成する必要があります。

新規接続を作成するには:

1. Zoomクライアント内で、「スキルの接続」タブをクリックします。
2. 名前を入力します。Oracle Digital Assistantインスタンスのものと一致することをお薦めします。
3. Oracle Digital Assistantインスタンスのホスト名を入力します。

   これは、https://後および/botsui前のデジタル・アシスタントURLの一部です

4. 作成したZoom AppチャネルのチャネルIDを入力します。
5. Zoomアプリケーション・チャネルの秘密キーを入力します。
6. (オプション)接続のみを表示する場合は、「プライベートに接続」チェック・ボックスを選択します。

   チェックマークを外すと、この接続はあなたと同じZoomアカウントの誰にも表示されます。

7. 「接続」を押します。

   接続が完了すると、デジタル・アシスタントのチャット・ウィジェットがZoomインタフェース内に表示されます。

8. チャット・ウィジェットにテキストを入力して、デジタル・アシスタントをテストします。

デジタル・アシスタントが期待どおりに機能する場合は、接続の準備ができ、チャット・ウィジェットを閉じることができます。

デジタル・アシスタントとの対話が完了したら、右上隅にあるXをクリックして終了します。

Zoomアプリケーション・チャネルを介してデジタル・アシスタントへの接続を作成したら、いつでもZoomクライアントからデジタル・アシスタントを開くことができます:

1. Zoomクライアントで、「最新」タブをクリックします。

   このタブは、1つ以上の保存済接続がある場合にのみ表示されます。

2. 既存の接続を検索するには、検索バーに接続の名前の入力を開始します。
3. 探している接続を見つけたら、それをクリックします。

   デジタル・アシスタントのチャット・ウィジェットが開きます。

Oracle Digital Assistant for Zoomアプリケーションをアンインストールする必要がある場合は、次のステップに従います。

1. Zoomアカウントにサインイン
2. Zoom App Marketplaceに移動します。
3. 「管理」→「追加されたアプリケーション」をクリックし、Oracle Digital Assistantエントリを検索します。
4. Oracle Digital Assistant for Zoomエントリの「削除」ボタンをクリックします。

Zoomが提供するZoom App環境は、Webブラウザと非常によく似ていますが、主な違いがあります。

• マイクにアクセスできません。つまり、Zoom Appチャネルを介してスキルと対話する場合、入力できるのは入力のみです。
• ユーザーの場所にアクセスするためのAPIがありません。スキルでユーザーの場所を取得する必要がある場合は、手動で指定するように依頼できます。

スキルがZoomアプリケーション・チャネルを介して接続されている場合、会話内のユーザー入力ごとにZoomからユーザー・プロファイル情報を取得できます。ユーザー・プロファイル情報の取得に使用できる式を次に示します。

• ${profile.user.value.id}: 現在のユーザーのズーム・ユーザーID。
• ${profile.user.value.first_name}: 現在のユーザーの名。
• ${profile.user.value.last_name}: 現在のユーザーの姓。
• ${profile.user.value.email}: 現在のユーザーの電子メール・アドレス。

これらの式で使用可能なユーザー属性の詳細は、https://developers.zoom.us/docs/api/rest/reference/zoom-api/methods/#tag/Usersを参照してください。

Zoomには、会議自体に関する情報を取得できる変数もあります。これらにアクセスするには、現在のユーザーのアカウントで会議を作成する必要があります。その情報にアクセスするために使用できる式を次に示します。

• ${profile.meeting.value.id}: Zoom会議のID。会議が繰返しの会議の場合、この値は会議の発生ごとに同じになります。
• ${profile.meeting.value.uuid}: Zoom会議の発生のID。この値は、同じ会議の発生間でも常に一意です。
• ${profile.meeting.value.created_at}: 会議がスケジュールされた日時。この会議がスケジュールされずに開始された場合、その値は${profile.meeting.value.started_at}と同じです。
• ${profile.meeting.value.started_at}: 会議が開始された日時。
• ${profile.meeting.value.host_id}: 会議ホストのID。
• ${profile.meeting.value.host_email}: 会議ホストの電子メール。
• ${profile.meeting.value.topic}: 短い会議の説明。
• ${profile.meeting.value.agenda}: 長い会議の説明。
• ${profile.meeting.value.recurrence}: 会議が繰返し会議の場合、この式では、会議の開始時、繰返し回数、繰返しの停止時(該当する場合)、繰返しのタイプ(月次、週次、日次など)、および繰返しのタイミング(週次または月次会議の場合に繰り返される日など)の詳細を示すオブジェクトにアクセスします。
• ${profile.meeting.value.type}: 会議のタイプを示す整数。(1はインスタント会議、2はスケジュール済会議、3は固定時間なしの繰返し会議、8は固定時間ありの繰返し会議)

現在のユーザーが会議所有者である場合は、参加者に関する次の情報を取得できます。この情報は、参加者が参加して休暇を取るときにアクティブに保持されるため、各発話には、その時点で参加者に関する最新情報が保持されます。

• ${profile.meeting.participants}: 会議の現在の参加者を含む配列。各配列オブジェクトには、次のオブジェクトが含まれます。
  • participantUUID: 参加者のID (各会議で一意)
  • screenName: パーティクルの画面名。
  • role: 参加者のロール(ホスト、共同ホスト、参加者など)。
  • active: 参加者が現在会議に参加しているかどうかを示すブール。

会議プロファイル変数の詳細は、https://developers.zoom.us/docs/api/rest/reference/zoom-api/methods/#tag/Meetingsを参照してください。

Oracle Digital Assistant for Zoomアプリケーションのインストールに問題がある場合、またはZoom会議でのデジタル・アシスタントとの接続に問題がある場合は、最初に表示されるエラー・メッセージに示されている指示に従ってください。

引き続き問題が発生する場合は、チームのZoomアカウントの管理者またはチームのOracle Digital Assistantインスタンスの管理者(あるいはその両方)に確認してください。

対処できない質問や問題については、My Oracle Supportにお問い合せください。