プロアクティブメッセージを送信する

プロアクティブメッセージとは、次のようなメッセージを含むユーザーからの要求に応答していないボットによって送信されるメッセージです。

ウェルカムメッセージ
通知
予定されたメッセージ

このステップバイステップガイドは、ボットからプロアクティブなメッセージを送信するのに役立ちます。次の出力が表示されます。

チャット内のプロアクティブな hello メッセージ。
アダプティブカードとしてのプロアクティブな hello メッセージ。

前提条件

残り 23 分

次をインストールしてください。

Visual Studio 2019
ASP.NET と Web 開発、または .NET Core クロスプラットフォーム開発ワークロード
ngrok: 最小限の労力でローカル開発サーバーをインターネットに公開できるクロスプラットフォームアプリケーション
無料のTeams開発者テナントを取得する

ローカル環境を設定する

残り 21 分

サンプルコード (Zip ファイル) をダウンロードし、ファイルを抽出します。
抽出されたファイルに移動し、 ProactiveBot.csproj をダブルクリックします。ソリューションがVisual Studioで開きます。
Visual Studioで、プロジェクト (ProactiveBot) を右クリックし、[ビルド] を選択してソリューションをビルドします。
トラブルシューティング

パッケージが見つからない というエラーが発生した場合は、次の手順に従います。
1. ツール > NuGet パッケージマネージャーパッケージマネージャー設定 > に移動します。
2. 表示される [オプション] ウィンドウで、[NuGet パッケージマネージャー > Package ソース] を選択します。
3. [追加] を選択します。
4. [名前] フィールドと https://api.nuget.org/v3/index.json [ソース] フィールドに入力nuget.orgします。
5. [ 更新] と [OK] を選択します。
6. プロジェクトをリビルドします。
解凍して ngrok をインストールします。
- Windows: ダブルクリックしますngrok.zip。
- Linux または OS X: ターミナルから ngrok を解凍し、コマンドを unzip /path/to/ngrok.zip 実行します。
コマンドラインから次の引数を指定して ngrok を実行します。

ngrok http 3978 --host-header=localhost
次の手順で ngrok ベース URL として参照するには、ngrok URL (画像で強調表示されているように) をコピーします。

アプリTeams作成してインストールする

残り 18 分

App Studio Teams >に移動し、ダウンロードしたAppManifest.zipサンプルコード (Zip ファイル) で使用できるファイルをインポートします。
[ボットの > セットアップ] を選択 します。
[ボットのセットアップ] ウィンドウで、「名前」(プロアクティブメッセージデモ など) と入力します。
[ 個人用 ] を選択し、[ ボットの作成 ] を選択してボットを作成します。
(コピーした) ngrok ベース URL に /api/messages を追加し、 ボットエンドポイントアドレス として設定します。 URL は次のようになります https://yourngrokdomain.ngrok.io/api/messages。
変更が有効になるまで数秒待ちます。

時間がかかる場合は、[ タブ] を選択し、[ Bots ] セクションを選択して強制的に更新します。
[新しいパスワードの生成] を選択して新しいアプリパスワードを生成し、それをコピーします。
Visual Studioに移動し、appsettings.json ファイルを 開きます。の値 MicrosoftAppPasswordとしてパスワードを貼り付けます。
App Studio に移動し、アプリ ID をコピーします。
Visual Studioに移動し、appsettings.json ファイルを 開きます。アプリ ID を値 MicrosoftAppIdとして貼り付けます。 appsettings.json次の設定値があります。
F5 キーを押すか、IIS Express を選択してコードを実行します。

対応するプロアクティブなメッセージサンプルが表示されます。
**テストに移動し、**インストール を配布 > して、同じアプリをもう一度インストールします。
チャットで http://localhost:3978/api/notify プロアクティブな Hello メッセージを取得する URL を選択します。
Teamsに移動します。インストールが成功すると、ボットからプロアクティブな hello メッセージが表示されます。

アダプティブカードをプロアクティブメッセージに追加する

残り 13 分

Visual Studioで、デバッグプロセスを停止します。
[依存関係] を右クリックし、[NuGet パッケージの管理] を選択します。
NuGet ProactiveBot で、[参照] を選択し、[AdaptiveCards] を検索します。
[インストール] を選択します。

NotifyController.cs ファイルを開き、既存BotCallbackのコードを次のコードに置き換えてアダプティブカードメッセージを送信します。

private async Task BotCallback(ITurnContext turnContext, CancellationToken cancellationToken)
 {
             AdaptiveCard card = new AdaptiveCard(new AdaptiveSchemaVersion(1, 0));

             card.Body.Add(new AdaptiveTextBlock()
             {
                 Text = "Proactive Hello",
                 Size = AdaptiveTextSize.ExtraLarge
             });

             card.Body.Add(new AdaptiveImage()
             {
                 Url = new Uri("http://adaptivecards.io/content/cats/1.png")
             });

             Attachment attachment = new Attachment()
             {
                 ContentType = AdaptiveCard.ContentType,
                 Content = card
             };

             await turnContext.SendActivityAsync(MessageFactory.Attachment(attachment));
 }

波線の赤い線にマウスポインターを合わせ、 AdaptiveCards を使用して エラーを解決します。
F5 キーを押してコードを実行します。
Teamsに移動し、アプリをアンインストールします。
同じアプリを再インストールしてイベントを取得します conversationUpdate 。
[api/notify] URL を (http://localhost:3978/api/notify) 選択して、アダプティブカードでプロアクティブな hello メッセージを取得します。

チャレンジを完了する

残り 3 分

このようなことを思い付いたのですか? アダプティブカードでのプロアクティブな hello メッセージの表示方法は次のとおりです。

アダプティブカードのプロアクティブ hello

おめでとうございます。

100% 完了しました

シナリオを完了しました。

毎日通知を送信したり、定期的にユーザーからのフィードバックを要求したりできます。
調整の制限を処理して、複数の通知を回避します。

プロアクティブ メッセージを送信する