ボットを Microsoft Teams に接続する
この記事の対象: SDK v4
Microsoft Teams を介してユーザーとコミュニケーションするようにボットを構成できます。 この記事では、Teams で Teams アプリを作成し、ボットを Azure の Teams アプリに接続して、Teams でボットをテストする方法について説明します。
前提条件
- Azure サブスクリプション。 まだお持ちでない場合は、開始する前に無料アカウントを作成してください。
- Azure に公開されていて、Teams に接続するボット。
- カスタム アプリのアップロードまたはサイドローディングが有効になっている Teams の開発者テナント。 詳細については、「Microsoft 365 テナントの準備」を参照してください。
- 有効な Teams アプリ パッケージ。 詳細については、「Microsoft Teams にアプリをアップロードする」を参照してください。
Azure のボットを構成します。
- Azure Portalを開きます。
- ボットの [Azure Bot リソース] ブレードを開きます。
- [チャネル] を開き、[Microsoft Teams] を選択します。
- サービス使用条件を読み、同意します。
- [メッセージング] タブで、ボットのクラウド環境を選択します。 詳細については、「Teams 機能を使用してアプリを計画する」の「ビルド後」セクションを参照してください。
- 適用を選択します。
- [ボットの埋め込みコードを取得] を選択し、Teams の埋め込みコードを見つけて、コードの https 部分をコピーします。 たとえば、
https://teams.microsoft.com/l/chat/0/0?users=28:b8a22302e-9303-4e54-b348-343232
のようにします。 このコードを使用して、Teams でボットをテストできます。
ヒント
- [通話] タブでは、Teams 通話機能がサポートされています。 詳細については、「Microsoft Teams の通話と会議ボットを登録する」を参照してください。
- [公開] タブには、Teams アプリを Teams ストアに公開する方法に関する情報が含まれています。
- 21Vianet が運用する Microsoft Azure ではボット埋め込みコード取得機能がサポートされていません。 Teams チャネルをテストするには、Teams アプリを作成し、以下の手順を使用してデプロイします。
Teams でボットをテストする
運用環境のボットは、Teams アプリの一部として Teams に追加する必要があります。 詳細については、「アプリをテストする」を参照してください。
重要
テスト以外の目的のために、GUID によってボットを追加することはお勧めできません。 そのようにすると、ボットの機能が厳しく制限されます。 運用環境のボットは、アプリの一部として Teams に追加する必要があります。
- ブラウザーで、埋め込みコードからコピーした URL を開き、ボットを Teams に追加するために使用する Microsoft Teams アプリ (クライアントまたは Web) を選択します。 ボットは、Microsoft Teams でメッセージの送受信を行える連絡先として一覧表示されます。
- Teams でボットと対話します。
ヒント
ローカル開発環境、ステージング環境、運用環境を切り替えるとエンドポイントが変更されるため、環境ごとに 1 つのボット チャネル登録を使用します。
Teams チャネル登録を削除すると、再び有効にしたときに、新しいキー ペアが生成されます。 これにより、ボットがプロアクティブ メッセージング用に保存した可能性があるすべての 29:xxx ID と a:xxx ID が無効になります。
Teams でボットを公開する
アプリを公開する方法については、Microsoft Teams アプリを配布する方法の「Teams の概要」を参照してください。 この記事とそれに関連する記事では、次の方法について説明しています。
- ボットのインストール オプションを選択して構成する
- Teams のアプリ マニフェスト、アプリ アイコン、アプリ パッケージを作成する
- Teams にアプリをアップロードする
- 組織または Teams ストアにアプリを公開する
追加情報
- Teams アプリ開発の詳細については、「Microsoft Teams 用アプリの構築」と「作業の開始」を参照してください。
- Teams 用ボットの作成に関する詳細については、「Microsoft Teams のボット」を参照してください。
- Teams でのボットの公開とテストに関する詳細については、「Microsoft Teams アプリを配布する」と「アプリをテストする」を参照してください。
- フィードバックを提供したり、その他のリソースを探したりするには、Microsoft Teams Developer Community チャンネルを参照してください。