Graph API を使用して会議のトランスクリプトとレコーディングを取得する

注:

会議のトランスクリプトと録音をフェッチする API は、従量制課金 API です。 詳細については、「 会議 API の支払いモデル」を参照してください。

会議または通話の終了後にMicrosoft Teamsトランスクリプトと録音をフェッチするようにアプリを構成できるようになりました。 アプリでは、Microsoft Graph REST API を使用して、次のインスタンスに対して生成されたトランスクリプトと記録にアクセスしてフェッチできます。

  • スケジュールされたオンライン会議
  • アドホック呼び出し

ユース ケース

Graph APIを使用して会議のトランスクリプトと録音を取得するためのユース ケースをいくつか次に示します。

ユース ケース 説明 API のヘルプ
オンライン会議などの スケジュールされたインスタンス の会議のトランスクリプトと録音を自動的に取得する セールス マネージャーとして、Sales 垂直の複数の会議から有意義な分析情報をキャプチャするためのトランスクリプトと記録を取得する必要があります。 すべての会議のタブを保持し、会議のトランスクリプトと記録を手動で取得して有用な情報を取得することは、時間がかかり、非効率的です。 アプリで Graph API を使用して、目的に関連するすべての会議から会議のトランスクリプトと記録を自動的に取得します。 アプリは会議の通知を受け取り、会議終了後に生成されたときにトランスクリプトと記録を取得します。
その後、このデータを使用して次の情報を取得できます。
• 集計された分析情報とインテリジェンス分析
• 新しい潜在顧客とハイライト
• 会議のフォローアップと概要
オンライン会議などの スケジュールされたインスタンス の会議後のトランスクリプトと録音をフェッチする 人事イニシアチブとして、従業員の健康と生産性を理解し、改善するためのブレーンストーミング セッションを開催しています。 終了したら、ディスカッションを分析して、改善を計画するためのデータ ポイントを収集する必要があります。 会議後の概要を提供するために継続的にメモを取る必要があると、考えの流れが妨げられ、すべての貴重な提案をキャプチャできない場合があります。 アプリで Graph API を使用してトランスクリプトとレコーディングをフェッチすると、会議後にあなたと参加者がディスカッションに完全に集中できるようになります。 会議のトランスクリプトと記録の内容は、次の目的で利用できます。
• エンゲージメントとセンチメントの分析
• タスクまたは問題のリスト
• フォローアップ会議と通知
オンライン会議などの スケジュールされたインスタンス用に カスタマイズされたアプリを作成する 大手テック企業の営業担当者として、クライアントとつながり、取引を成立させなければなりません。 Teams と Outlook の予定表を通じて多数の会議がスケジュールされているため、すべての通話に出席し、ディスカッションや最新の更新プログラムを常に更新することが重要です。 次の機能を使用してアプリを作成します。
• Teams または Outlook の予定表を使用して会議がスケジュールされている場合に通知します。
• アプリでこれらの会議の AutoRecording=true を設定できるようにします。
• 会議の参加者としてボットを追加して、会議が記録されていること、およびコンテンツがアプリによって分析に使用されていることを示すバナーを表示します。
•アプリが会議の記録やトランスクリプトにアクセスすることを許可します。
•これらのアクセス許可の管理者の承認を取得するには時間がかかる可能性がありますように、 OnlineMeetingRecording.Read.All のアクセス許可の管理者の承認を必要とせずにアプリを許可します。
このユース ケース シナリオを紹介する サンプル アプリ を次に示します。
アドホック インスタンスの会議後にトランスクリプトと録音をフェッチする プロジェクト マネージャーとして、ロールでは、事前にスケジュールできない自発的なグループまたは 1 対 1 の呼び出しを行う必要があります。 会議出席依頼がないと、会議 ID は生成されないため、トランスクリプトや録音にアクセスできません。 大きなメモを取り下げて、重要なアクションアイテムを見逃す余地が大きくなります。 アプリで Graph API を使用して、会議後のトランスクリプトと録音をフェッチすると、あなたと参加者がディスカッションに完全に集中できるようになります。 アクセス許可 CallTranscripts.Read.All と CallRecordings.Read.Allを使用すると、通話トランスクリプトを次の目的で使用できます。
• 重要なアクション項目のキャプチャ
• タスクまたは問題の一覧表示
• フォローアップ会議と通知
PSTN 通話のトランスクリプトと録音の通話後のフェッチ あなたは、人間のアシスタントがMicrosoft Teamsを使用して着信または発信 PSTN 通話を使用してカスタマー サポートを提供するコール センターがあります。 アシスタントは、通話が終了した後、各呼び出しのメモを使用して、レコードの外部システムを手動で更新する必要があります。 アプリで Graph API を使用してトランスクリプトと録音を呼び出し後にフェッチすると、レコードを更新するために各アシスタントに必要な手動作業が減ります。 また、呼び出しトランスクリプトを使用してアプリで自動化をトリガーすることもできます。

会議と通話のトランスクリプトと録音を取得する

特定の会議と通話のトランスクリプトと記録を取得するには:

  1. トランスクリプトと記録にアクセスするためのMicrosoft Entra IDに対するアクセス許可を構成する
  2. 会議のトランスクリプトと録音が利用可能になったときに通知を受け取る
  3. Graph API を使用してトランスクリプトをフェッチする
  4. Graph API を使用して記録をフェッチする

トランスクリプトと記録にアクセスするためのMicrosoft Entra IDに対するアクセス許可を構成する

アプリには、トランスクリプトと記録をフェッチするために必要なアクセス許可が必要です。 Organization全体のアプリケーションのアクセス許可または特定の会議のリソース固有の同意 (RSC) アプリケーションのアクセス許可を使用して、Teams 会議のトランスクリプトと記録にアクセスして取得できます。

注:

  • 上記のリソースには、 adhocCalls に対する新しいアクセス許可 ( OnlineMeetingsと並列) が必要です。
  • 2 つの個別の適切なスコープのリソース (1 つは onlineMeetings 用、もう 1 つは adhocCalls用) にサブスクライブします。 これらのリソースは、データのフェッチに使用する URL を提供します。

組織全体のアプリケーションのアクセス許可を使用する

オンライン会議や通話の場合は、テナント全体で会議のトランスクリプトと録音にアクセスするようにアプリを構成できます。 この場合、会議の開催者は Teams 会議チャットにアプリをインストールする必要はありません。 管理者がorganization全体のアプリケーションアクセス許可を承認すると、アプリはテナント内のすべての会議のトランスクリプトと記録を読み取り、アクセスできます。

アプリに付与できるorganization全体のアプリケーションアクセス許可の詳細については、「オンライン会議のアクセス許可」を参照してください。

注:

アドホック呼び出しでは、アプリベースのアクセス許可とユーザー委任アクセス許可が許可されます。

会議固有の RSC アプリケーションのアクセス許可を使用する

アプリがインストールされている Teams 会議のトランスクリプトと録音のみを取得する場合は、アプリの会議固有の RSC アクセス許可を構成します。 承認されたユーザーは、会議チャットでアプリをインストールできます。 会議が終了すると、アプリで API 呼び出しを行って、その会議のトランスクリプトと記録を取得できます。

会議固有の RSC アクセス許可の詳細については、「 チャットまたは会議の RSC アクセス許可」を参照してください。

注:

アドホック呼び出しに対する RSC ベースのアクセス許可は有効になっていません。

トランスクリプトまたは記録が利用可能になったときに通知を受け取る

アクセス許可を構成したら、利用可能な場合、またはすべての関連する会議やアドホック呼び出しでトランスクリプトと記録の 変更通知 を受信するようにアプリを構成します。 オンライン会議の場合、通知には会議 ID と開催者 ID が含まれており、トランスクリプト コンテンツへのアクセスと記録に役立ちます。 アプリは、会議の終了後に生成されたときに、会議のトランスクリプトと記録を取得できます。 アドホック通話の場合、会議 ID は自発的なイベント (PSTN、1:1、グループ通話) のため使用できません。 アドホック呼び出しの通知パスには制限はありませんが、 getAll API はアドホック呼び出しインスタンスにも使用できません (たとえば、呼び出しレベルでの成果物の一覧表示)。 トランスクリプトの内容は、 .vtt ファイルとして使用できます。 会議の記録は、 .mp4 ファイルとして使用できます。

アプリには、次の種類の変更通知を使用できます。

サブスクリプション スコープ 説明 サポートされるリソースのパス
テナントのレベル トランスクリプトまたは記録は、テナントのオンライン会議または通話で使用できます。 organization内のすべてのトランスクリプト:
• オンライン会議の場合: communications/onlineMeetings/getAllTranscripts
• 通話の場合: communications/adhocCalls/getAllTranscripts

organization内のすべての録音:
• オンライン会議の場合: communications/onlineMeetings/getAllRecordings
• 通話の場合: communications/adhocCalls/getAllRecordings
会議レベルまたは通話レベル トランスクリプトまたはレコーディングは、特定の会議または通話で使用できます。
特定の会議のすべてのトランスクリプト: communications/onlineMeetings/{onlineMeetingId}/transcripts

特定の会議のすべての記録: communications/onlineMeetings/{onlineMeetingId}/recordings

特定のアドホック呼び出しのすべてのトランスクリプト: /communications/adhocCalls/{callId}/transcripts

特定のアドホック呼び出しのすべての録音: /communications/adhocCalls/{callId}/recordings
ユーザー スコープ トランスクリプトまたは記録は、特定のユーザーによって開始されたオンライン会議の開催またはアドホック通話で使用できます。 特定のユーザーによって編成された会議または指定したユーザーによって文字起こしが開始される通話で使用できる通話トランスクリプト:
• オンライン会議の場合: users/{userId}/onlineMeetings/getAllTranscripts
• アドホック呼び出しの場合: users/{userId}/adhocCalls/getAllTranscripts

特定のユーザーによって編成された会議または指定したユーザーによって文字起こしが開始される通話で使用できる通話記録:
• オンライン会議の場合: users/{userId}/onlineMeetings/getAllRecordings
• アドホック呼び出しの場合: users/{userId}/adhocCalls/getAllRecordings
アプリスコープ トランスクリプトまたはレコーディングは、特定の Teams アプリがインストールされている会議で使用できます。 アドホック呼び出しには適用されません。 特定の Teams アプリがインストールされている会議で使用できる通話トランスクリプト:
• オンライン会議の場合: appCatalogs/teamsApps/{id}/installedToOnlineMeetings/getAllTranscripts

特定の Teams アプリがインストールされている会議で使用できる通話記録:
• オンライン会議の場合: appCatalogs/teamsApps/{id}/installedToOnlineMeetings/getAllRecordings

オンライン会議またはアドホック通話が終了した後にトランスクリプトまたはレコーディングを利用できるタイミングをアプリで認識する方法の詳細については、「 トランスクリプトと録音が使用可能になったときに通知を受け取る」を参照してください。

会議がいつ終了するかをアプリで認識する方法の詳細については、「 変更通知をサブスクライブする 」および 「Bot Framework を使用して会議 ID と開催者 ID を取得する」を参照してください。

重要

  • Graph API を呼び出してトランスクリプトと記録にアクセスおよび取得するプロセスは、会議固有の RSC アプリケーションのアクセス許可とorganization全体のアプリケーションのアクセス許可の両方で変わりません。
  • これらの API は、ベータ版でのみプライベート チャット会議、チャネル会議、アドホック呼び出しをサポートします。
  • アドホック呼び出しの場合:
    • 通知をサブスクライブして、呼び出し ID にアクセスします。
    • 通話がまだ進行中に通話 ID を取得するには、アプリで App-hosted/service-hosted Calls を介して呼び出しを行い、 callChainIdを使用します。

オンライン会議インスタンスの AI で生成された会議の概要を取得する

アプリでは、会議AI 分析情報 API を使用して、会話の概要、アクション アイテム、メンションなど、AI によって生成された会議の概要を直接フェッチできます。 詳細については、「会議AI 分析情報 API を使用して会議の分析情報を取得する」を参照してください。

コード サンプル

サンプルの名前 説明 Node.js C#
オンライン会議のトランスクリプト ボット このサンプル アプリでは、Microsoft Graph APIを使用して会議のトランスクリプトを取得し、ダイアログに表示します。 表示 表示
オンライン会議のトランスクリプトの記録 このサンプル アプリでは、Graph API を使用して Teams 会議のトランスクリプトとレコーディングを取得します。 表示 表示
アドホック呼び出しのトランスクリプトと録音 このサンプル アプリでは、PSTN、1:1、グループ通話など、アドホック通話用の Graph API を使用して会議のトランスクリプトと録音を取得します。 表示

次の手順

会議のトランスクリプトと録音が利用可能になったときに通知を受け取る

関連項目

  • Last updated on