通話と会議を含む Teams ボット - Teams

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

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

対話型音声応答 (IVR)。
通話コントロール。
デスクトップとアプリの共有を含むリアルタイムのオーディオストリームとビデオストリームへのアクセス。

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

このステップバイステップガイドは、通話機能と会議機能を備えたボットを作成するのに役立ちます。このチュートリアルの終わりまでに、次の出力を実現できます。

最終的な出力

前提条件

残り 10 分

次のツールをインストールし、開発環境を設定してください。

テナントOffice 365
Ngrok または同等のトンネリングソリューション
Visual Studio 2019
.NET Core SDK バージョン 3.1
アカウントを持つ Microsoft Teams (ゲストアカウントではありません)
すべてのコマンドを実行してWindows PowerShellをインストールする

通話と会議ボットのセットアップ

残り 9 分

アプリの Microsoft Azure portalでアプリ登録を使用してアプリケーションを登録し、Microsoft ID プラットフォームと統合して Microsoft Graph を呼び出します。次の操作を実行します。

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

ngrok トンネルを作成する:

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

ngrok http -host-header=rewrite 3978

Azure にアプリを登録する:

個人用 Microsoft アカウントを使用してAzure portalにサインインします。
Azure Active Directory サービスを選択し、左側のウィンドウ でアプリの登録 を選択し、[新しい登録] を選択します。
アプリケーションの登録ページが 開きます。アプリケーションの登録情報を入力します。
アプリのユーザーに表示されるわかりやすいアプリケーション名を入力 します 。
[サポートされているアカウントの種類] で、アプリケーションでサポートするアカウントを選択します。
[ リダイレクト URI (省略可能)] フィールドで、アプリ Web またはパブリッククライアント (モバイル & デスクトップ) の種類を選択し、アプリケーションのリダイレクト URI を入力します。

注意

Web アプリケーションの場合は、ベース URI を http://localhost:31544. パブリッククライアントアプリケーションの場合は、Azure AD がトークン応答を返すために使用する URI を次のように myapp://auth指定します。
[登録] を選択します。

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

ボットの [概要] ページで[ 要点 ] を選択し、将来の参照のために アプリケーションクライアント ID (Microsoft アプリ ID) を保存します。
[ 管理] で[ 証明書&シークレット ] セクションを選択し、[ クライアントシークレット ] を選択し、[ 新しいクライアントシークレット] を選択します。 [ クライアントシークレットの追加] ウィンドウが表示されます。
[説明] を入力し、[追加] を選択します。
[値] の列で、[クリップボードにコピー] を選択し、将来参照できるようにクライアントシークレット ID を保存します。

PowerShell スクリプトを実行してポリシーを作成します。

次の PowerShell スクリプトを使用して、オンライン会議を作成するためのデモテナントユーザーのポリシーを作成します。

注意

管理者として PSI Windows PowerShell実行し、スクリプトを実行します。
ボットの Microsoft アプリ ID に置き換え、object-idTeams へのログインに使用するアカウントの テナント ID に置き換えます azure-client-id (次の図に示すようにリンクをコピーすると、取得したリンクで Teams アカウントのテナント ID を確認できます)。
PowerShell スクリプトに、azure-client-id、、policy-description、object-idを追加PolicyNameします。 PowerShell のプロンプトが表示されたら、Teams アカウントでログインします。
PowerShell で次のコマンドを実行して、ポリシーが正常に作成されているかどうかを確認します。ポリシー名を定義済みのポリシー名に置き換えます。
```
Get-CsApplicationAccessPolicy -Identity “<<policy-identity/policy-name>>”
```

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

注意

アカウントが Microsoft の管理者の同意を付与できることを確認します。アクセス許可を追加した後、同意の状態を確認する場合に選択します Grant admin consent for Microsoft 。

ボットの [管理 ] ウィンドウで、[ API アクセス許可] を選択します。
[アクセス許可を追加] を選択します。 [要求 API のアクセス許可 ] ウィンドウが表示されます。
Microsoft API を 選択し、Microsoft Graph を選択します。
[アプリケーションのアクセス許可] を選択し、アクセス許可を選択します。
Azure アプリに次のGraph APIアプリケーションのアクセス許可を追加し、管理者の同意を付与します。
- Calls.AccessMedia.All
- Calls.Initiate.All
- Calls.InitiateGroupCall.All
- Calls.JoinGroupCall.All
- Calls.JoinGroupCallAsGuest.All
- OnlineMeetings.ReadWrite.All
[アクセス許可の追加] を選択します。

Azure アカウントでボットチャネル登録を作成する:

Azure portalを開きます。
[リソースの作成] を選択します。
検索ボックスで Azure Bot を検索します。
Azure Bot を選択します。
[作成] を選択します。
[ボットハンドル] フィールドでボットハンドル名を入力します。
ドロップダウンリストから [サブスクリプション] を選択します。
ドロップダウンリストから [リソースグループ] を選択します。

新しいリソースグループを作成するには、[ 新規作成] を選択し、リソース名を入力 し、[OK] を 選択し、[ 新しいリソースグループの場所 ] ドロップダウンリストから必要な場所を選択します。
Microsoft アプリ ID の マルチテナント として アプリ種類 を選択します。

注意

Microsoft App ID セクションでは Creation type 、 Create new Microsoft App ID 新しいボットを作成するために既に選択されています。ボットを既に登録している場合は、選択 Use existing app registrationすることもできます。フィールドに Existing app id Microsoft アプリ ID を入力し、フィールドに値を Existing app password 入力します。
[既存のアプリの登録を使用 する] を選択し、デモテナントに登録されている Azure アプリのアプリ ID とアプリ シークレット を入力します。
[確認 + 作成] を選びます。
検証に合格した場合は、[作成] を選択します。

ボットサービスがプロビジョニングされるまで少し時間がかかります。
[リソースに移動] を選びます。ボットと関連リソースがリソースグループに一覧表示されます。

これで、Azure ボットが作成されました。

Microsoft Teams チャネルに追加するには:

[ホーム] に移動します。
[最近使ったリソース] セクションに一覧表示されているボット開きます。
左側のウィンドウで [チャネル] を選択し、Microsoft Teams を選択します。使用可能なチャネルの一覧から選択できます。
サービス利用規約に同意するチェックボックスをオンにし、[承諾する] を選択します。
[保存] を選択します。
Microsoft Teams を 選択し、Teams チャネルページの [通話] タブを選択します。
[ 呼び出しを有効にする] を選択し、HTTPS ngrok URL で Webhook を更新します (https://yourNgrok/api/callback) 最後に追加 /api/callback します)。
[保存] を選択します。

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

ボットの ホーム ページに移動し、左側のウィンドウの [設定] で [構成] を選択します。
ngrok に移動します。
次の図に示すように、HTTPS URL (https から io) をコピーします。
メッセージングエンドポイント で、ngrok から使用できる HTTPS URL を追加し、URL の最後に /api/messages を追加します。
[適用] を選択します。

Azure Bot Serviceでボットを正常に設定したので、ボットサービス接続を設定する必要があります。

Teams アプリパッケージを更新して作成する

残り 4 分

Microsoft Teams で会話型ボットを認証し、Teams アプリパッケージを作成して組織にアップロードする方法を理解するようにボットサンプルを構成します。

Visual Studio で appsettings.json を更新します。
Visual Studio で manifest.json を更新し、エクスプローラーで zip ファイルに圧縮します。

Bot を呼び出すための appsettings を更新します。

リポジトリ https://github.com/OfficeDev/Microsoft-Teams-Samples.gitに移動します。
[ コード ] を選択し、ドロップダウンを選択します。
[ ZIP のダウンロード] を選択します。
ダウンロードされたリポジトリのパスを確認してください。
エクスプローラー で、Microsoft-Teams-Samples-main > サンプル > ボット呼び出し会議 > csharp フォルダーに移動します。
Visual Studio で appsettings.json ファイルを開き、ボットの構成を更新します。
- ボットの MicrosoftAppId 構成ページから取得できます。以前 MicrosoftAppPassword に保存したクライアントシークレット ID の値です。
- Teams へのログインに Tenant ID 使用するアカウントのリンクから取得または UserId 取得できます。イメージ内のパスに従って、次の tenant idリンクを取得します。
- Microsoft Graph Explorer サイトから取得DisplayName``UserIdできます。
  - Teams アカウントを使用してページにログインし、検索ボックスに URl の末尾に追加 Users し、[クエリの実行] を選択します。
  - アカウントにリンクされた表示名とユーザー ID が生成されます。
  - 3 つのアカウントを選択し、appsettings.json に追加DisplayName``UserIdします。
注意

Tenant IDまたは UserId Teams アカウントは通話を開始する場所を示しDisplayName``UserId、ユーザーは通話をリダイレクトまたは転送する相手を示します。
、 ClientId``AppId アプリケーション (クライアント) ID、および MicrosoftAppPassword``ClientSecret``AppSecret Value に置き換えますMicrosoftAppId。
URL を使用して更新 BotBaseUrl します ngrok 。
更新 Tenant ID と UserId.
更新 DisplayName と UserId.
[保存] を選択します。

マニフェストを更新するには:

エクスプローラー で、Microsoft-Teams-Samples-main > サンプル > ボット呼び出し会議 > csharp > マニフェスト フォルダーに移動します。
manifest.json ファイルを Visual Studio で開きます。
ファイルで manifest.json {id}、{BotId} を見つけて、Microsoft アプリ ID を追加します。
https:// を除く validDomains に ngrok URL を追加して保存します。
作成manifest.zipするマニフェストフォルダーの内容を zip 化します。

注意

その manifest.zip 中に追加のフォルダーを含めてはなりません。 zip フォルダー内には manifest json 、ソースファイル、 color アイコン、アイコン outline が含まれている必要があります。組織または Teams アカウントのデモテナントにマニフェストをアップロードし、Visual Studio でソリューションを実行します。
Teams に移動します。
アップロード manifest.zipするには、 ストア > [アプリの管理] > [カスタムアプリのアップロード ] を選択し、エクスプローラーのリポジトリフォルダーから開 manifest.zip きます。
[ 追加] を選択して、Teams に通話ボットをインストールします。

このボットは、Visual Studio でのデバッグ後に操作できます。