ボットを Microsoft Teams に接続する

この記事の対象: SDK v4

Microsoft Teams を介してユーザーとコミュニケーションするようにボットを構成できます。 この記事では、Teams で Teams アプリを作成し、ボットを Azure の Teams アプリに接続して、Teams でボットをテストする方法について説明します。

前提条件

  • Azure サブスクリプション。 まだお持ちでない場合は、開始する前に無料アカウントを作成してください。
  • Azure に公開されていて、Teams に接続するボット。
  • カスタム アプリのアップロードまたはサイドローディングが有効になっている Teams の開発者テナント。 詳細については、「Microsoft 365 テナントの準備」を参照してください。
  • 有効な Teams アプリ パッケージ。 詳細については、「Microsoft Teams にアプリをアップロードする」を参照してください。

Azure のボットを構成します。

  1. Azure Portalを開きます。
  2. ボットの [Azure Bot リソース] ブレードを開きます。
  3. [チャネル] を開き、[Microsoft Teams] を選択します。
    1. サービス使用条件を読み、同意します。
    2. [メッセージング] タブで、ボットのクラウド環境を選択します。 詳細については、「Teams 機能を使用してアプリを計画する」の「ビルド後」セクションを参照してください。
    3. 適用を選択します。
  4. [ボットの埋め込みコードを取得] を選択し、Teams の埋め込みコードを見つけて、コードの https 部分をコピーします。 たとえば、https://teams.microsoft.com/l/chat/0/0?users=28:b8a22302e-9303-4e54-b348-343232 のようにします。 このコードを使用して、Teams でボットをテストできます。

ヒント

  • [通話] タブでは、Teams 通話機能がサポートされています。 詳細については、「Microsoft Teams の通話と会議ボットを登録する」を参照してください。
  • [公開] タブには、Teams アプリを Teams ストアに公開する方法に関する情報が含まれています。

Teams でボットをテストする

運用環境のボットは、Teams アプリの一部として Teams に追加する必要があります。 詳細については、「アプリをテストする」を参照してください。

重要

テスト以外の目的のために、GUID によってボットを追加することはお勧めできません。 そのようにすると、ボットの機能が厳しく制限されます。 運用環境のボットは、アプリの一部として Teams に追加する必要があります。

  1. ブラウザーで、埋め込みコードからコピーした URL を開き、ボットを Teams に追加するために使用する Microsoft Teams アプリ (クライアントまたは Web) を選択します。 ボットは、Microsoft Teams でメッセージの送受信を行える連絡先として一覧表示されます。
  2. Teams でボットと対話します。

ヒント

ローカル開発環境、ステージング環境、運用環境を切り替えるとエンドポイントが変更されるため、環境ごとに 1 つのボット チャネル登録を使用します。

Teams チャネル登録を削除すると、再び有効にしたときに、新しいキー ペアが生成されます。 これにより、ボットがプロアクティブ メッセージング用に保存した可能性があるすべての 29:xxx ID と a:xxx ID が無効になります。

Teams でボットを公開する

アプリを公開する方法については、Microsoft Teams アプリを配布する方法の「Teams の概要」を参照してください。 この記事とそれに関連する記事では、次の方法について説明しています。

  • ボットのインストール オプションを選択して構成する
  • Teams のアプリ マニフェスト、アプリ アイコン、アプリ パッケージを作成する
  • Teams にアプリをアップロードする
  • 組織または Teams ストアにアプリを公開する

追加情報