重要
この記事は、v3 Bot Framework SDK に基づいています。
インテリジェントなボットを構築して接続し、チャットを通じて Microsoft Teams ユーザーと自然に対話します。 または、幅広い Teams アプリ エクスペリエンス用の "コマンド ライン" インターフェイスとして使用する単純なコマンドベースのボットを提供します。 通知専用ボットを作成して、チャネルやダイレクト メッセージでユーザーに関連する情報を直接ユーザーにプッシュできます。 既存の Bot Framework ベースのボットを取り込み、Teams 固有のサポートを追加してエクスペリエンスを向上させることもできます。
留意事項: ボット
ボットは、会話でやり取りする他のチーム メンバーと同じように見えますが、六角形のアバター アイコンがあり、常にオンラインである点が異なります。
ボットは、関与している会話の種類に応じて動作が異なります。 Teams のボットは、 アプリ マニフェストのスコープと呼ばれる複数の種類の会話をサポートしています。
-
teamsチャネルの会話とも呼ばれます。 -
personalボットと 1 人のユーザーの間の会話。 -
groupChatボットと 2 人以上のユーザーの間の会話。
詳細については、「 Microsoft Teams ボットと会話する」を参照してください。
Teams アプリを使用すると、ボットをエクスペリエンスの主役にしたり、単なるヘルパーにしたりできます。 ボットは、タブやメッセージ拡張機能などの他の機能を含めることができる広範なアプリ パッケージの一部として公開されます。
ボット API
Teams は、ほとんどの Microsoft Bot Framework をサポートしています。 (Bot Framework に基づくボットが既にある場合は、Teams で動作するように簡単に適応できます。)SDK を利用するには、C# または Node.js のいずれかを使用することをお勧めします。 これらのパッケージは、基本的なボット ビルダー SDK クラスとメソッドを拡張します。
- Microsoft 365 グループ用のコネクタ カードなどの特殊なカード タイプを使用する。
- アクティビティに関する Teams 固有のチャネル データの使用と設定。
- メッセージ拡張機能要求を処理します。
SDK 拡張機能は、Bot Builder SDK などの依存関係をインストールします。
- .NET Bot Builder SDK for .NET の Microsoft Teams 拡張機能を使用するには、Visual Studio プロジェクトに Microsoft.Bot.Connector.Teams NuGet パッケージをインストールします。 Node.js 開発のために、BotBuilder for Microsoft Teams 機能は v4.6 の時点で Bot Framework SDK に組み込まれています。
重要
他の任意の Web プログラミング テクノロジで Teams アプリを開発し、 Bot Framework REST API を直接呼び出すことができますが、トークンの処理はすべて自分で実行する必要があります。
Teams 用開発者ポータル は、アプリ マニフェストの作成と構成に役立ち、また Bot Framework ボットを作成できます。 また、React コントロール ライブラリとインタラクティブ カード ビルダーも含まれています。
送信 Webhook
送信 Webhook を使用すると、ワークフローの開始や必要となる可能性のあるその他の簡単なコマンドなど、基本的な操作のための単純なボットを作成できます。 送信 Webhook は、作成したチームにのみ存在し、会社のワークフローに固有の単純なプロセスを目的としています。 詳細については、「 送信 Webhook」を参照してください。
優れた Teams ボットを構築する
次の記事では、Teams 用の優れたボットを作成するプロセスについて説明します。
- ボットの作成: Bot Framework チームが提供する優れたツール、ドキュメント、コミュニティを活用します。
- ボットに話しかけます: 基本的な会話フローを追加し、チャネル固有の機能を使用します。 .NET または Node.js で開発する場合は、Bot Builder SDK の拡張機能を使用して作業を簡略化します。
- ボットでカードを使用する: ユーザーの応答を伝えて受け入れるようにカードをデザインします。
- ボット イベントに応答する
- 通知専用ボット: ボットを使用してアプリの通知を送信します。
- コンテキストの取得: ユーザーに関する情報を取得します。
- ボット メニュー: ボットでメニューを使用します。
- ボットとファイル: ボットからファイルを送受信します。
- ボットでタブを使用する: タブとボットを連携させる。
- ボットのテスト: 個人用またはチームの会話用にボットを追加して、実際の動作を確認します。
ボット SDK V3
重要
この記事は、v3 Bot Framework SDK に基づいています。
Teams 用 Teams 開発者ポータル は、ボットの構築に役立つツールであり、ボットを参照するアプリ パッケージです。 また、React コントロール ライブラリとカード用の構成可能なサンプルも含まれています。 詳細については、「 Teams 用開発者ポータルの概要」を参照してください。 以下の手順では、ボットを手動で構成し、 Teams 用 Teams 開発者ポータルを使用しないことを前提としています。
Bot Framework を使用してボットを作成します。 ボットを作成した後、必ずおすすめのチャネル リストから Microsoft Teams をチャネルとして追加してください。 アプリ パッケージ/マニフェストを既に作成している場合は、生成した Microsoft アプリ ID を自由に再利用してください。
注
Azure でボットを作成しない場合は、次のリンクを使用して新しいボットを作成する必要があります: Bot Framework。 代わりに Bot Framework ポータルでボットの作成を選択した場合は、代わりに Microsoft Azure でボットを作成します。
Microsoft.Bot.Connector.Teams NuGet パッケージ、Bot Framework SDK、または Bot Connector API を使用してボットをビルドします。
Bot Framework Emulator を使用してボットをテストします。
ボットを Microsoft Azure などのクラウド サービスにデプロイします。 または、アプリをローカルで実行し、 ngrok などのトンネリング サービスを使用して、
https://45az0eb1.ngrok-free.app/api/messagesなどのボットの https:// エンドポイントを公開します。
注
ボットと Microsoft Azure
Bot Framework ポータルは、Microsoft Azure にボットを登録するために最適化されています。 次の点にご注意ください。
- Azure に登録されているボットの Microsoft Teams チャネルは無料です。 Teams チャネル経由で送信されたメッセージは、ボットに使用されたメッセージにはカウントされません。
- Azure を使用せずに新しい Bot Framework ボットを作成することはできますが、Bot Framework ポータルで公開されなくなった新しい Bot Framework ボットを作成する必要があります。
-
Bot Framework のボットのリストで既存のボットのプロパティ (たとえば、ボットを初めて開発するとき、特に ngrok を使用している場合に一般的である) などの既存のボットのプロパティを編集すると、[移行の状態] 列と青い [移行] ボタンが表示され、Microsoft Azure portal に移動します。 それが必要な場合以外は、[移行] ボタンを選択しないでください。代わりに、ボットの名前を選択すると、そのプロパティを編集できます。
- Microsoft Azure を使用してボットを登録する場合、ボット コードを Microsoft Azure でホストする必要はありません。
- Azure portal を使用してボットを登録する場合は、Microsoft Azure アカウントが必要です。 1 つ無料で作成できます。 作成時に ID を確認するには、クレジット カードを提示する必要がありますが、課金されることはありません。Teams でボットを作成して使用することはいつでも無料です。
- Teams 用開発者ポータルを使用して、Teams 内で直接アプリとボットの情報を登録/更新できるようになりました。 Direct Line、Web チャット、Skype、Facebook Messenger などの他のボット フレームワーク チャネルを追加または構成するには、Azure portal を使用するだけで済みます。