送信 Webhook をビルドする
Webhook は、外部アプリと統合するMicrosoft Teamsに役立ちます。 Teamsでは、送信 Webhook はボットとして機能し、@mention を使用してチャネル内のメッセージを検索します。 送信 Webhook を使用すると、ユーザーは、Microsoft Bot Frameworkを介してボットを作成するプロセス全体を実行することなく、Web サービスにメッセージを送信できます。 送信 Webhook は、Teamsから JSON ペイロードを受け入れるサービスにデータを投稿します。
発信 Webhook の主な機能
- 任意の外部 Web サービスに通知を送信します。
- カードや画像を含むリッチ テキスト メッセージで応答します。
- 個人またはプライベートのスコープ内ではなく、パブリック チャネルでメッセージを受信します。
- HTTP POST を Web サービスに送信し、応答を取得します。
注意
送信 Webhook は、チーム内の名簿やチャネルの一覧を取得するなど、他の API にはアクセスできません。
このステップ バイ ステップ ガイドは、Teamsで送信 Webhook を作成するのに役立ちます。 次の出力が表示されます。
前提条件
次のツールをインストールし、開発環境を設定してください。
有効なアカウントを持つMicrosoft Teams
ngrok の最新バージョン (devbox テスト用のみ) または同等のトンネリング ソリューション
注意
ngrok をダウンロードしたら、サインアップして authtoken をインストールします。
ローカル環境を設定する
リポジトリをローカル GitHubに複製Microsoft-Teams-Samples
します。
Microsoft Teamsサンプルを開きます。
[ コード] を選択します。
ドロップダウン メニューから、[デスクトップで開く] GitHub 選択します。
[ 複製] を選択します。
送信 Webhook を作成する
必要なチームを選択し、(••) ドロップダウン メニューから [ チームの管理 ] を選択します。
ナビゲーション バーから [アプリ] タブを選択します。
ngrok を使用して、ローカルで実行されている Web サーバーのパブリックに利用可能な HTTPS エンドポイントへのトンネルを作成します。 ngrok で次のコマンドを実行します。
ngrok http --host-header=localhost 3978
ウィンドウの右下隅にある [ 送信 Webhook の作成] を選択します。
.
次の詳細を入力します:
名前: [@mention] タブの webhook タイトル。
コールバック URL: JSON ペイロードを受け入れ、Teamsから POST 要求を受信する ngrok から生成された URL。 api/Sample または api/authenticatedSample を使用するには、次の操作を行います。
api/sample の場合は、ngrok URL をコピーして貼り付け、/api/sample を追加します。
認証されたサンプルの場合は、ngrok URL をコピーして貼り付け、/authenticatedSample?id=contoso を追加します。
説明: プロファイル カードとチーム レベルのアプリ ダッシュボードに表示される詳細な文字列。
プロファイル画像 (省略可能): Webhook のアプリ アイコン。
[作成] を選択します。 発信 Webhook は、現在のチームのチャネルに追加されます。
Hash-based Message Authentication Code (HMAC)
ダイアログ ボックスが表示されます。 AuthProvider.cs ファイルのセキュリティ トークンを使用して、Teamsと指定された外部サービス間の呼び出しを認証できます。注意
送信 Webhook は、URL が有効でサーバーとクライアント認証トークンが等しい場合にのみ、チームのユーザーが使用できます。 たとえば、HMAC ハンドシェイクなどです。
サービスをビルドして実行する
最新バージョンのVisual Studioを起動します。
FileOpen > > Project/Solution に移動します。
csharp フォルダーから WebhookSampleBot.sln ファイルを選択します。
AuthProvider.cs ファイルの "contoso" を "M365x712764" および HMAC に更新します。
F5 キーを押してプロジェクトを実行します。
以下のダイアログが表示されたら、[はい] を選択します:
Web ページには、ローカル ホスト情報が表示されます。
Teamsでアプリを操作する
[ 全般] を選択して、新しい会話を開始します。
[ 新しい会話 ] を選択して会話を開始します。
発信 Webhook の名前 を入力@して、チャネルで呼び出します。
[ 送信] を選択します。
注意
アダプティブ カード、ヒーロー カード、テキスト メッセージは、送信 Webhook で添付ファイルとして送信できます。
会議チャットに新しいメッセージが表示されます。
チャレンジを完了する
このようなことを思い付いたのですか?
おめでとうございます。
送信 Webhook アプリの使用を開始するためのチュートリアルを完了しました。
このセクションに問題がある場合 このセクションを改善できるよう、フィードバックをお送りください。