通話と会議を使用した Teams ボット - Teams

通話ボットと会議ボットMicrosoft Teams、クラウド通信 Graph API を統合することで、通話の作成、通話への参加、通話の転送またはリダイレクト、スケジュールされた会議への参加、参加者の招待などの基本的な機能が提供されます。

ボットは、リアルタイムの音声、ビデオ、画面共有を使用して、Teams の通話や会議と対話できます。 Teams アプリは、音声とビデオを使用してユーザーと対話して、通話やオンライン会議の Microsoft Graph API でのエクスペリエンスを向上させることができます。これらの API を使用すると、次の新機能を追加できます:

対話型音声応答 (IVR) を使用します。
呼び出し制御を使用します。
デスクトップやアプリの共有など、リアルタイムのオーディオおよびビデオストリームへのアクセスを提供します。

ボットを作成し、Teams アプリでこれらの Graph API を使用するための追加情報とアクセス許可を指定します。

このステップバイステップガイドは、Teams 通話ボットと会議ボットを設定するのに役立ちます。次の出力が表示されます。

ステップバイステップガイドが正常に完了した後の、ボットの呼び出しと会議の出力のスクリーンショット。

前提条件

残り 14 分

次のツールをインストールし、開発環境を設定していることを確認します。

	インストール	使用するには...
	Microsoft 365 開発者アカウント	アプリをインストールするための適切なアクセス許可を持つ Teams アカウントにアクセスします。
	Visual Studio 2022	Visual Studio 2022 でエンタープライズバージョンをインストールし、ASP.NET および Web 開発ワークロードをインストールできます。最新バージョンを使用します。
	.NET Core SDK	ローカルデバッグと Azure Functions アプリのデプロイ用にカスタマイズされたバインド。最新バージョンを使用するか、移植可能なバージョンをインストールします。
	Microsoft Teams	Microsoft Teams、チャット、会議、通話を 1 か所で行うためにアプリを通じて作業するすべてのユーザーと共同作業を行うことができます。
	Windows PowerShell	すべてのコマンドを実行してインストールします。
	開発トンネル	Teams アプリの機能 (会話型ボット、メッセージ拡張機能、受信 Webhook) には、受信接続が必要です。トンネルは、開発システムを Teams に接続します。開発トンネルは、localhost をインターネットに安全に開き、アクセス権を持つユーザーを制御するための強力なツールです。開発トンネルは、Visual Studio 2022 バージョン 17.7.0 以降で使用できます。または ngrok をトンネルとして使用して、開発システムを Teams に接続することもできます。タブのみを含むアプリには必要ありません。このパッケージは、(npm devDependencies を使用して) プロジェクトディレクトリ内にインストールされます。

注:

ngrok をダウンロードしたら、サインアップして authtoken をインストールします。

ローカル環境を設定する

残り 13 分

Microsoft-Teams-Samples を開きます。
[ コード] を選択します。
ドロップダウンメニューから、[ GitHub Desktop で開く] を選択します。
[ 複製] を選択します。

Microsoft Entra アプリを登録する

残り 12 分

アプリが Microsoft ID プラットフォームと統合され、Microsoft Graph API を呼び出すために Microsoft Azure portal を使用してアプリケーションを登録するには、次の手順を実行します。

Web サーバーのエンドポイントへの ngrok トンネルを作成します。
Azure ボットサービスにボットを登録する Azure ボットリソースを作成します。
ボットのシングルサインオン (SSO) 認証を有効にするクライアントシークレットを作成します。
PowerShell を使用してオンライン会議を作成するためのデモテナントユーザーのポリシーを作成します。
ダウンストリーム呼び出しの API アクセス許可を追加します。
Azure アカウントでボットチャネル登録を作成します。
Microsoft Teams チャネルを追加して、ボットを Teams チャネルにデプロイします。
作成した ngrok トンネルにメッセージングエンドポイントを追加します。

アプリの登録を追加する

Azure ポータルに移動します。
[アプリの登録] を選択します。
[ + 新規登録] を選択します。
アプリの名前を入力します。
任意の組織ディレクトリ (任意の Microsoft Entra ID テナント - マルチテナント) で [アカウント] を選択します。
[登録] を選択します。

アプリは Microsoft Entra ID に登録されています。アプリの概要ページが表示されます。

注:

さらに使用するために 、アプリケーション (クライアント) ID と ディレクトリ (テナント) ID からアプリ ID を 保存します。

トンネルを作成する

dev tunnel
ngrok

Visual Studio を開きます。
[ 新しいプロジェクトの作成] を選択します。
検索ボックスに「ASP.NET」と入力します。検索結果から [ ASP.NET Core Web App] を選択します。
[次へ] を選択します。
「プロジェクト名」と入力し、[次へ] を選択します。
[作成] を選択します。

概要ウィンドウが表示されます。
デバッグドロップダウンリストで、[Dev Tunnel (アクティブトンネルなし)]>[トンネルの作成]を選択します。...

ポップアップウィンドウが表示されます。
ポップアップウィンドウで次の詳細を更新します。
1. アカウント: Microsoft または GitHub アカウントを入力します。
2. [名前]: トンネルの名前を入力します。
3. トンネルの種類: ドロップダウンリストから [ 一時] を選択します。
4. アクセス: ドロップダウンリストから [パブリック] を選択 します。
[OK] を選択します。

開発トンネルが正常に作成されたことを示すポップアップウィンドウが表示されます。
[OK] を選択します。

作成したトンネルは、次のようにデバッグドロップダウンリストにあります。
F5 キーを押して、デバッグモードでアプリケーションを実行します。
[セキュリティ警告] ダイアログが表示されたら、[はい] を選択します。

ポップアップウィンドウが表示されます。
[続行] を選択します。

開発トンネルのホームページが新しいブラウザーウィンドウで開き、開発トンネルがアクティブになりました。
Visual Studio に移動し、[ 表示] > [出力] を選択します。
[出力コンソール] ドロップダウンメニューで、[Dev Tunnels]\(開発トンネル\) を選択します。

出力コンソールには、開発トンネル URL が表示されます。

ngrok またはコマンドプロンプトを使用して、ローカルで実行されている Web サーバーのパブリックに利用可能な HTTPS エンドポイントへのトンネルを作成します。 ngrok で次のコマンドを実行します。

ngrok http --host-header=localhost 3978

ヒント

ERR_NGROK_4018が発生した場合は、コマンドプロンプトに記載されている手順に従ってサインアップし、ngrok を認証します。 ngrok http --host-header=localhost 3978 コマンドを実行します。

ウィンドウに HTTPS URL が表示されます。

ngrok HTTPS URL を示すスクリーンショット。

Web 認証を追加する

左側のウィンドウの [ 管理] で、[ 認証] を選択します。
[プラットフォームの追加>Web] を選択します。
完全修飾ドメイン名に auth-end を追加して、アプリのリダイレクト URI を入力します。たとえば、https://your-devtunnel-domain/auth-end および https://your-ngrok-domain/auth-end が禁止となります。
[ 暗黙的な許可とハイブリッドフロー] で、[ アクセストークン と ID トークン ] チェックボックスをオンにします。
[構成] を選択します。
[ Web] で、[ URI の追加] を選択します。
https://token.botframework.com/.auth/web/redirect を入力します。
[保存] を選択します。

クライアントシークレットを作成する

左側のウィンドウの [ 管理] で、[ 証明書 & シークレット] を選択します。
[ クライアントシークレット] で、[ + 新しいクライアントシークレット] を選択します。

[ クライアントシークレットの追加] ウィンドウが表示されます。
「説明」と入力します。
[追加] を選択します。
[ 値] で、[ クリップボードにコピー ] を選択して、クライアントシークレットの値を保存して、さらに使用します。

ダウンストリーム呼び出しの API アクセス許可を追加する

左側のウィンドウの [ 管理] で、[ API のアクセス許可] を選択します。
[ + アクセス許可の追加] を選択します。
[Microsoft Graph] を選択します。
[アプリケーションのアクセス許可] を選択します。
次のアクセス許可を選択します。
- Calls.AccessMedia.All
- Calls.Initiate.All
- Calls.InitiateGroupCall.All
- Calls.JoinGroupCall.All
- Calls.JoinGroupCallAsGuest.All
- OnlineMeetings.ReadWrite.All
[アクセス許可の追加] を選択します。

注:

アプリに IT 管理者の同意が付与されていない場合、ユーザーは初めてアプリを使用する際に同意を提供する必要があります。
ユーザーは、Microsoft Entra アプリが別のテナントに登録されている場合にのみ、API のアクセス許可に同意する必要があります。

スコープを追加する

左側のウィンドウの [ 管理] で、[ API の公開] を選択します。
[ + スコープの追加] を選択します。
スコープ名として「access_as_user」と入力します。
[ 同意できるユーザー] で、[ 管理者とユーザー] を選択します。
残りのフィールドの値を次のように更新します。
- 「Teams は管理者の同意表示名としてユーザーのプロファイルにアクセスできます」と入力します。
- 「Teams でアプリの Web API を現在のユーザーとして管理者の同意の説明として呼び出すことができます」と入力します。
- 「Teams」と入力すると、ユーザープロファイルにアクセスし、ユーザーの代わりにユーザーの同意表示名として要求を行うことができます。
- ユーザーの同意の説明と同じ権限を持つこのアプリの API を呼び出すには、「Teams を有効にする」と入力します。
[状態] が [有効] に設定されていることを確認してください。
[スコープの追加] を選択します。

次の図は、フィールドと値を示しています。

注:

スコープ名は、最後に追加/access_as_userアプリケーション ID URI と一致する必要があります。

クライアントアプリケーションを追加する

左側のウィンドウの [ 管理] で、[ API の公開] を選択します。

[ 承認されたクライアントアプリケーション] で、アプリの Web アプリケーションに対して承認するアプリケーションを特定します。
[ + クライアントアプリケーションの追加] を選択します。
Teams モバイルまたはデスクトップと Teams Web アプリケーションを追加します。
1. Teams モバイルまたはデスクトップの場合: 1fec8e78-bce4-4aaf-ab1b-5451cc387264としてクライアント ID を入力します。
2. Teams Web の場合: 5e3ce6c0-2b1f-4285-8d4b-75ee78787346としてクライアント ID を入力します。
[ 承認されたスコープ ] チェックボックスをオンにします。
[アプリケーションの追加] を選択します。

次の図は、 クライアント ID を表示します。

ポリシーを作成する

デモテナントユーザーが PowerShell スクリプトを使用してオンライン会議を作成できるようにするポリシーを作成するには、次の手順を実行します。

管理者として Windows PowerShell PSI を実行し、スクリプトを実行します。
```
New-CsApplicationAccessPolicy -Identity "<<policy-identity/policy-name>>" -AppIds "<<azure-client-id>>" -Description "Policy-description"
Grant-CsApplicationAccessPolicy -PolicyName "<<policy-identity/policy-name>>" -Identity "<<object-id-of-the-user-to-whom-policy-need-to-be-granted>>"
```
注:

Windows PowerShell PSI を初めて使用する場合は、次のコマンドを実行します。
- Set-ExecutionPolicy -ExecutionPolicy Unrestricted -Scope CurrentUser
- Install-Module -Name MicrosoftTeams -Force -AllowClobber を実行する

Windows PowerShell スクリプトの次のフィールドを置き換えます。

フィールド	説明
policy-identity/policy-name	ポリシーの名前。
azure-client-id	Azure portal でアプリを登録するときに生成した Microsoft アプリ ID。
Policy-description	ポリシーの説明。
object-id-of-the-user-to-whom-policy-need-to-be-granted	グラフエクスプローラーを使用してポリシーを生成する必要があるユーザーの ID。

オブジェクト ID を生成するには、ポリシーを付与する必要がある資格情報を使用して Microsoft Graph Explorer にサインインします。
ツールバーから [Graph Explorer] を選択します。
[クエリの実行] を選択します。応答プレビューで応答が生成されます。
応答プレビューから id プロパティの値をコピーし、PowerShell スクリプトのオブジェクト ID に置き換えます。
PowerShell スクリプトを実行します。
Connect-MicrosoftTeamsを実行し、ポリシーを付与する必要がある資格情報でサインインします。
PowerShell で次のコマンドを実行して、ポリシーが正常に作成されたかどうかを確認します。ポリシー名を定義したポリシー名に置き換えます。
```
Get-CsApplicationAccessPolicy -Identity “<<policy-identity/policy-name>>”
```
注:

実行中のスクリプトがシステムで無効になっていないことを確認します。詳細については、「実行ポリシー」を参照してください。

ボットを作成する

残り 7 分

Azure ボットリソースを作成する

注:

Teams でボットを既にテストしている場合は、このアプリと Teams からサインアウトします。この変更を確認するには、もう一度サインインします。

[ホーム] に移動します。
[ + リソースの作成] を選択します。
検索ボックスに「 Azure Bot」と入力します。
Enter キーを押します。
[ Azure Bot] を選択します。
[作成] を選択します。
ボットハンドルにボット名を入力します。
ドロップダウンリストから [サブスクリプション] を選択します。
ドロップダウンリストから [リソースグループ] を選択します。

既存のリソースグループがない場合は、新しいリソースグループを作成できます。新しいリソースグループを作成するには、次の手順に従います。
1. [ 新規作成] を選択します。
2. リソース名を入力し、[ OK] を選択します。
3. [ 新しいリソースグループの場所 ] ドロップダウンリストから場所を選択します。
[ 価格] で、[ プランの変更] を選択します。
[ FO Free>Select] を選択します。
[Microsoft アプリ ID] で、[マルチテナントとしてのアプリの種類] を選択します。
[ 作成の種類] で、[ 既存のアプリの登録を使用する] を選択します。
アプリ ID を入力します。

注:

同じ Microsoft アプリ ID を持つ複数のボットを作成することはできません。
[確認 + 作成] を選びます。
検証に合格したら、[ 作成] を選択します。

ボットのプロビジョニングには数分かかります。
[リソースに移動] を選びます。

Azure ボットが正常に作成されました。

Teams チャネルを追加する

左側のウィンドウで、[チャネル] を選択 します。
[ 使用可能なチャネル] で、[ Microsoft Teams] を選択します。
チェックボックスをオンにして 、利用規約に同意します。
[ 同意する] を選択します。
[適用] を選択します。

メッセージングエンドポイントを追加するには

dev tunnel
ngrok

出力コンソールの開発トンネル URL をメッセージングエンドポイントとして使用します。
左側のウィンドウの [ 設定] で、[ 構成] を選択します。
メッセージングエンドポイントを https://your-devtunnel-domain/api/messages 形式で更新します。
[適用] を選択します。

Azure Bot サービスでボットが正常に設定されました。

注:

Application Insights Instrumentation キーにエラーが表示される場合は、アプリ ID で更新します。

ngrok から HTTPS URL をコピーします。

注:

ngrok の HTTPS URL は、完全修飾ドメイン名です。 WebAppDomainは、https://を含まない完全修飾ドメイン名です。
左側のウィンドウの [ 設定] で、[ 構成] を選択します。
メッセージングエンドポイントを https://your-ngrok-domain/api/messages 形式で更新します。
[適用] を選択します。

Azure Bot サービスでボットを正常に設定しました。

注:

Application Insights Instrumentation キーにアプリ ID を使用したエラー更新が表示される場合。

アプリ設定とマニフェストファイルを設定する

残り 6 分

Teams から tenantId または UserId を取得します。 tenantIdを取得するには、次の手順に従います。
- [ Teams] を選択します。
- [その他のオプション (...)] を選択します。
- [チームへのリンクを取得する] を選択します。
- サイトから displayName と id を取得できます。
- Teams テナントアカウントを使用して Microsoft Graph Explorer にサインインします。
- 検索ボックスの URL の末尾に Users を追加します。
- [クエリの実行] を選択します。
  
  アカウントにリンクされている表示名とユーザー ID が生成されます。
任意の 3 つのアカウントを選択し、appsettings.json ファイルの DisplayName と UserId に追加します。

注:

TenantId または Teams アカウントの UserId は、通話を開始する場所を示し、ユーザーの DisplayName と UserId は、通話をリダイレクトまたは転送するユーザーを示します。

アプリの設定を更新する

複製されたリポジトリ内の appsettings.json ファイルに移動します。
Visual Studio で appsettings.json ファイルを開き、次の情報を更新します。
- MicrosoftAppId、ClientId、AppIdをボットの Microsoft アプリ ID に置き換えます。
- MicrosoftAppPassword、ClientSecret、AppSecretをボットのクライアントシークレットの値に置き換えます。
- BotBaseUrlを ngrok または dev tunnel ドメイン名に置き換えます。
- TenantIdをUserIdに置き換えます。
- DisplayNameをIdに置き換えます。
[保存] を選択します。

アプリマニフェストの更新

複製されたリポジトリ内の manifest.json ファイルに移動します。
Visual Studio で manifest.json ファイルを開き、次の変更を行います。
- {id}`` and {BotId}' を Microsoft アプリ ID に置き換えます。
- {{domain-name}}のすべての出現箇所を、ngrok ドメイン名または開発トンネルドメイン名に置き換えます。

サービスをビルドして実行する

残り 5 分

サービスをビルドして実行するには、Visual Studio を使用します。

Visual Studio を開きます。
[ファイル>Open>Project/Solution..] に移動します。
csharp>Source フォルダーからCallingBotSample.sln ファイルを選択します。
F5 キーを押してプロジェクトを実行します。

Web ページが開き、 ボットの準備ができました! というメッセージが表示されます。

Teams に通話ボットと会議ボットを追加する

残り 4 分

複製したリポジトリで、 csharp > Source > AppManifest に移動します。
AppManifest フォルダーに存在する次のファイルを含む .zip ファイルを作成します。
- manifest.json
- outline.png
- color.png
注:

manifest.zipに追加のフォルダーを含めてはなりません。 zip フォルダー内には、ソースファイル、color アイコン、outline アイコンmanifest json必要があります。
Teams クライアントで、[ アプリ ] アイコンを選択します。
[アプリの管理] を選択します。
[ アプリのアップロード] を選択します。
ポップアップウィンドウで、[ カスタムアプリのアップロード] を選択します。オプションが表示された場合は、カスタムアプリのアップロードが有効になります。
Csharp > Source > AppManifest に移動します。
[ 開く ] を選択して、 AppManifest フォルダーに作成した .zip ファイルをアップロードします。
[ 追加] を選択して、 Teams に通話ボット アプリをインストールします。

通話ボットと会議ボットとの対話

残り 3 分

ボットを使用すると、チャネル内またはチャット内の専用スペース内のサービスとコンテンツにアクセスできます。

Teams でアプリと対話しましょう。

Teams の左側のウィンドウで、[他の アプリの表示 (...)] を選択し、一覧からアプリを選択します。

ボットは、アダプティブカードを使用してウェルカムテキストを送信します。
[ 呼び出しの作成] を選択します。

$[Create Call]$呼び出しの作成$ オプションが赤で強調表示された [通話ボットのMicrosoft Teamsのスクリーンショット。最小化された通話画面が画面の右下隅に表示されます。$
[ 呼び出しの転送] を選択します。
ボットに会議のスケジュールを設定し、参加者を招待するように依頼できます。

課題の完了

残り 1 分

あなたはこのような出力を思いついたのですか?

ステップバイステップガイドが正常に完了した後の、ボットの呼び出しと会議の出力のスクリーンショット。

おめでとうございます。

100% 完了しました

Microsoft Teamsのボット呼び出しと会議アプリの使用を開始するためのチュートリアルを完了しました。

次の方法で共有

Teams 通話と会議ボット

前提条件

ローカル環境を設定する

Microsoft Entra アプリを登録する

ボットを作成する

アプリ設定とマニフェストファイルを設定する

サービスをビルドして実行する

Teams に通話ボットと会議ボットを追加する

通話ボットと会議ボットとの対話

課題の完了

おめでとうございます。

次の方法で共有

Teams 通話と会議ボット

前提条件

ローカル環境を設定する

Microsoft Entra アプリを登録する

ボットを作成する

アプリ設定とマニフェスト ファイルを設定する

サービスをビルドして実行する

Teams に通話ボットと会議ボットを追加する

通話ボットと会議ボットとの対話

課題の完了

おめでとうございます。

アプリ設定とマニフェストファイルを設定する