52 アプリのズーム
Zoom Meetingsビデオ会議内で作業するようにデジタル・アシスタントを構成できます。
- デジタル・アシスタントにアクセスするには、ZoomアプリケーションのOracle Digital Assistantを使用します。このアプリケーションは、ZoomのApp Marketplaceを介してインストールできます。
- その後、ユーザーは、進行中のZoom会議中にそのアプリケーション内でデジタル・アシスタントとチャットできます。
次に、Digital Assistantのズーム・アプリケーション・チャネルを作成するステップを示します。
ステップ1: ZoomのDigital Assistantアプリケーションのインストール
- Zoom App Marketplaceの「Oracle Digital Assistant (Zoomアプリの場合)」に移動します。
- Zoomにサインインしていない場合は、「ログインして追加」をクリックします。
- 「認可」をクリックして、ZoomのOracle Digital Assistantをインストールします。
ステップ2: Digital Assistantでのチャネルの作成
-
Digital Assistantで、左側のメニューの「チャネル」をクリックして、「ユーザー」を選択します。
-
「+チャネル」をクリックして「チャネルの作成」ダイアログを開きます。
-
チャネルに名前を付けます。
-
「アプリのズーム」をチャネル・タイプとして選択します。
- 「許可されるドメイン」フィールドに、ユーザーが接続できる許可されたドメインを入力します。
このフィールドは、ズーム・アプリケーション・チャネルに接続できるドメインを制御します。 ほとんどの場合、すべてのドメインを示すためにアスタリスク・ワイルドカード(
*)を入力することが必要になります。 -
「作成」をクリックします。
-
をクリックし、チャネルに関連付けるデジタル・アシスタントまたはスキルを選択します。
-
「ルーティング先」ドロップダウンで、チャネルに関連付けるデジタル・アシスタントまたはスキルを選択します。
- 「チャネル有効」コントロールを切り替えます。
-
次のステップで「シークレット・キー」および「チャネルID」の値を使用できるように、ページを開いたままにします。
ステップ3: ズームでのアプリケーションからチャネルへの接続の作成
Zoomアプリケーションがインストールされ、チャネルが作成されたら、Zoomインタフェース内でデジタル・アシスタントを使用できるように、ZoomとZoom Appチャネル間の接続を作成する必要があります。
新規接続を作成するには:
- Zoomクライアント内で、「スキルの接続」タブをクリックします。
- 名前を入力します。 Oracle Digital Assistantインスタンスのものと一致することをお薦めします。
- Oracle Digital Assistantインスタンスのホスト名を入力します。
これは、
https://の後、/botsuiの前にあるDigital Assistant URLの一部です - 作成したズーム・アプリケーション・チャネルのチャネルIDを入力します。
- Zoom Appチャネルの秘密キーを入力します。
- (オプション)接続を自分のみに表示する場合は、「プライベートに接続」チェック・ボックスを選択します。
チェックマークを外すと、この接続はあなたと同じZoomアカウントの下にいるすべてのユーザーに表示されます。
- 「接続」を押します。
接続が完了すると、デジタル・アシスタントのチャット・ウィジェットがZoomインタフェース内に表示されます。
- チャット・ウィジェットにテキストを入力してデジタル・アシスタントをテストします。
デジタル・アシスタントが期待どおりに動作する場合は、接続の準備ができ、チャット・ウィジェットを閉じることができます。
デジタル・アシスタントとの対話が終了したら、右上隅にあるXをクリックして終了します。
Digital Assistantへの接続を開く
Zoom Appチャネルを介してデジタル・アシスタントへの接続を作成したら、Zoomクライアントからデジタル・アシスタントをいつでも開くことができます:
- Zoomクライアントで、「最新」タブをクリックします。
このタブは、1つ以上の接続が保存されている場合にのみ表示されます。
- 既存の接続を検索するには、検索バーで接続の名前の入力を開始します。
- 探している接続が見つかったら、その接続をクリックします。
デジタル・アシスタントのチャット・ウィジェットが開きます。
ZoomアプリケーションのDigital Assistantをアンインストール
ZoomアプリケーションのOracle Digital Assistantをアンインストールする必要がある場合は、次のステップに従います:
- Zoomアカウントにサインイン
- 「アプリのマーケットプレイスを拡大」にナビゲートします。
- 「管理」>「追加されたアプリ」をクリックして、Oracle Digital Assistantエントリを検索します。
- 「ズームの場合はOracle Digital Assistant」エントリの「削除」ボタンをクリックします。
ズーム・アプリケーション・チャネルの制限
Zoomによって提供されるZoomアプリケーション環境は、webブラウザと非常によく似ていますが、主な違いがあります:
- マイクにアクセスできません。 つまり、Zoom Appチャネルを介してスキルとやり取りする場合、入力できるのは入力のみです。
- ユーザーのロケーションにアクセスするためのAPIはありません。 スキルでユーザーのロケーションを取得する必要がある場合は、スキルに手動で提供するよう依頼できます。
スキルに使用可能なアプリ・チャネル属性のズーム
スキルがZoom Appチャネルを介して接続されると、会話のユーザー入力ごとに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}: ズーム会議のID。 ミーティングが定期的なミーティングの場合、この値は、ミーティングの各オカレンスで同じになります。${profile.meeting.value.uuid}: ズーム会議の発生の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}: 会議ホストのEメール。${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を参照してください。
トラブルシューティング
ZoomアプリのOracle Digital Assistantのインストールに問題がある場合、またはZoomミーティングでデジタル・アシスタントとの接続に問題がある場合は、最初に表示されるエラー・メッセージに示されている指示に従ってください。
引き続き問題が発生する場合は、チームのZoomアカウントの管理者またはチームのOracle Digital Assistantインスタンスの管理者(あるいはその両方)に確認してください。
対応できない質問や問題については、My Oracle Supportまでお問い合わせください。