Microsoft 365 間で Teams メッセージ拡張機能を拡張する

メッセージ拡張機能を使用すると、ユーザーはボタンとフォームを使用して Web サービスと対話できます。 ユーザーは、Microsoft 365 全体で Teams アプリを拡張することで、Microsoft Teamsと Outlook から外部システムでアクションを検索または開始できます。 メッセージ拡張機能には、次の 2 種類があります。

• 検索ベースのメッセージ拡張機能: ユーザーが外部システムを検索し、クライアントの新規作成メッセージ領域で結果を共有できるようにします。

• アクション ベースのメッセージ拡張機能: モーダル ポップアップを持つユーザーが情報を収集または表示し、対話を処理し、リッチ カードとしてクライアントに情報を送信できるようにします。

注:

Teams 検索ベースのメッセージ拡張機能は Outlook で一般提供され、アクション ベースのメッセージ拡張機能は Outlook のプレビューで利用できます。

Android および iOS 上の Outlook モバイル ユーザーは、Outlook on the web および Outlook for Windows のユーザーによって送信されたアプリからカードを受け取り、アクションを実行できます。

Microsoft 365 全体の Teams メッセージ拡張機能では、ステージビューとタスク モジュールを起動するためのカードを表示するリンク展開もサポートされています。

前提条件

Teams メッセージ拡張機能を Outlook に拡張するには、次のことを確認します。

• Windows デスクトップ、Web、モバイル向けの Outlook 内でのメッセージ拡張機能のサポートを確認する場合は、「 Microsoft 365 全体で Teams アプリを拡張する」のサポート 表を参照してください。
• Microsoft 365 開発者プログラム サンドボックス テナント。 アクション ベースのメッセージ拡張機能の場合は、Microsoft 365 ターゲット リリースの開発者テナントを登録します。
• Microsoft 365 Apps Current Channel からインストールされた Microsoft 365 アプリを含むテスト環境。
• (省略可能) Teams Toolkit 拡張機能を備えた Microsoft Visual Studio Code。

Teams メッセージ拡張機能を Outlook に拡張するには、Teams Toolkit を使用して新しいメッセージ拡張機能アプリを構築するか、既存の Teams メッセージ拡張機能アプリを Outlook に拡張します。

Outlook 用のメッセージ拡張機能アプリをビルドする

Visual Studio Code 用 Teams Toolkit 拡張機能を使用して、Outlook 用の Teams メッセージ拡張機能アプリを構築できます。 Outlook 用のメッセージ拡張機能アプリを構築するには、次のことを確認します。

• Teams でアプリをアップロードする
• Outlook でメッセージ拡張機能をプレビューする

検索ベースまたはアクション ベースのメッセージ拡張機能を構築できます。

検索ベースのメッセージ拡張機能

1. Visual Studio Code を開きます。

2. [表示] オプションまたは Ctrl + Shift + P の下にある [コマンド パレット...] を選択します。

3. [ Teams: 新しいアプリの作成] を選択します。

4. ドロップダウン リストから [ メッセージ拡張機能] を選択します。

5. [ カスタム検索結果 ] を選択して、最新のアプリ マニフェスト (以前は Teams アプリ マニフェスト) を使用して Teams 検索ベースのメッセージ拡張機能のサンプル コード をダウンロードします。

   

   左側のウィンドウの [ 開発] で [サンプルの表示] を選択して、 サンプル コードをダウンロードすることもできます。 [ サンプル ] タブが表示され、検索フィールドに「 NPM Search Connector」と入力します。

   

6. 推奨されるプログラミング言語を選択します。

7. ワークスペース フォルダーのローカル コンピューター上の場所を選択し、アプリケーション名を入力します。

8. [表示] オプションまたは Ctrl + Shift + P の下にある [コマンド パレット...] を選択します。

9. 「Teams: プロビジョニング」と入力して、Azure アカウントに関連するアプリ リソース (Azure App Service、App Service プラン、Azure Bot、マネージド ID など) を作成します。

10. サブスクリプションとリソース グループを選択します。

11. [プロビジョニング] を選択します。 または、拡張機能の [ライフサイクル] セクションで [プロビジョニング] を選択することもできます。

12. [表示] オプションまたは Ctrl + Shift + P の下にある [コマンド パレット...] を選択します。

13. 「Teams: デプロイ」と入力して、Azure でプロビジョニングされたリソースにサンプル コードをデプロイし、アプリを起動します。 または、拡張機能の [ライフサイクル] セクションで [デプロイ] を選択することもできます。

14. [展開] を選択します。

アクション ベースのメッセージ拡張機能

1. Visual Studio Code を開きます。

2. [表示] オプションまたは Ctrl + Shift + P の下にある [コマンド パレット...] を選択します。

3. [ Teams: 新しいアプリの作成] を選択します。

4. ドロップダウン リストから [ メッセージ拡張機能] を選択します。

5. [ フォーム入力の収集] と [データの処理 ] を選択して、最新のアプリ マニフェスト (以前は Teams アプリ マニフェスト) を使用して Teams アクション ベースのメッセージ拡張機能のサンプル コード をダウンロードします。

   

6. 優先プログラミング言語を選択します。

7. ワークスペース フォルダーのローカル コンピューター上の場所を選択し、アプリケーション名を入力します。

8. [表示] オプションまたは Ctrl + Shift + P の下にある [コマンド パレット...] を選択します。

9. 「Teams: プロビジョニング」と入力して、Azure アカウントに関連するアプリ リソース (Azure App Service、App Service プラン、Azure Bot、マネージド ID など) を作成します。

10. サブスクリプションとリソース グループを選択します。

11. [プロビジョニング] を選択します。 または、拡張機能の [ライフサイクル] セクションで [プロビジョニング] を選択することもできます。

12. [表示] オプションまたは Ctrl + Shift + P の下にある [コマンド パレット...] を選択します。

13. 「Teams: デプロイ」と入力して、Azure でプロビジョニングされたリソースにサンプル コードをデプロイし、アプリを起動します。 または、拡張機能の [ライフサイクル] セクションで [デプロイ] を選択することもできます。

14. [展開] を選択します。

これで、 Teams でアプリをアップロード し、 Outlook でメッセージ拡張機能をプレビューできます。 Teams Toolkit を使用してアプリ パッケージをビルドするには、「アプリ パッケージのビルド」を参照してください。

既存の Teams メッセージ拡張機能アプリを Outlook に拡張する

既存の Teams メッセージ拡張機能アプリを Outlook に拡張するには、次のことを確認します。

• アプリ マニフェストを更新します。
• アプリの Microsoft 365 チャネルを追加します。
• SSO の Microsoft Entra アプリ登録を更新します。
• Teams で更新したアプリをアップロードします。
• Outlook でメッセージ拡張機能をプレビューする

アプリ マニフェストを更新する

アプリ マニフェスト (以前は Teams アプリ マニフェストと呼ばれる) スキーマ バージョン1.13以降を更新して、Teams メッセージ拡張機能を Outlook で実行できるようにします。

アプリ マニフェストを開き、 $schema と manifestVersion を次の値で更新します。

{
"$schema" : "https://developer.microsoft.com/json-schemas/teams/v1.16/MicrosoftTeams.schema.json",
"manifestVersion" : "1.16"
}

アプリの Microsoft 365 チャネルを追加する

Microsoft Teams では、メッセージ拡張機能は、ホストする Web サービスと、Web サービスがホストされる場所を定義するアプリ マニフェストで構成されます。 Web サービスは、 Bot Framework SDK メッセージング スキーマを利用し、ボットに登録されている Teams チャネルを介して通信プロトコルをセキュリティで保護します。

ユーザーが Outlook からメッセージ拡張機能を操作するには、メッセージ拡張機能アプリの Azure ボット リソースに対して Microsoft 365 チャネルを有効にする必要があります。

注:

以前にボットの Outlook チャネルを有効にしている場合は、Microsoft Outlook でメッセージ拡張機能が正しく機能するように Microsoft 365 チャネルを有効にする必要があります。 Outlook チャネルは、Outlook で実行されているメッセージ拡張機能に使用されなくなり、無効にすることができます。

1. Microsoft Azure portal または Bot Framework ポータル (以前に登録している場合) に移動し、ボット リソースに移動します。

2. [設定>Channels] から。

3. [ 使用可能なチャネル] で、[ Microsoft 365 チャネル] を選択します。

   

4. [適用] を選択します。

   

5. ボットの [チャネル] ウィンドウに、Microsoft 365 チャネルがMicrosoft Teamsと共に一覧表示されていることを確認します。

SSO の Microsoft Entra アプリ登録を更新する

注:

このシナリオでは Microsoft Entra のシングル サインオン認証が含まれていないので、Teams Toolkit を使用して Outlook 用のアプリを構築する場合は、この手順をスキップできます。

メッセージ拡張機能の Microsoft Entra シングル サインオン (SSO) は、Teams の場合と同じように Outlook で動作します。 ただし、テナントのアプリ登録ポータルで、ボットの Microsoft Entra アプリ登録に複数のクライアント アプリケーション識別子を追加する 必要があります。

1. Azure 管理者アカウントを使用して、Azure portal にサインインします。

2. [アプリの登録] を選択します。

3. アプリケーションの名前を選択して、アプリの登録を開きます。

4. [管理>API の設定] を選択します。

5. [ 承認されたクライアント アプリケーション ] セクションで、次のすべての Client Id 値が一覧表示されていることを確認します。

   Microsoft 365 クライアント アプリケーション	クライアント ID
   Teams デスクトップとモバイル	1fec8e78-bce4-4aaf-ab1b-5451cc387264
   Teams Web	5e3ce6c0-2b1f-4285-8d4b-75ee78787346
   Microsoft 365 Web	4765445b-32c6-49b0-83e6-1d93765276ca
   Microsoft 365 デスクトップ	0ec893e0-5785-4de6-99da-4ed124e5296c
   Microsoft 365 mobile	d3590ed6-52b3-4102-aeff-aad2292ab01c
   Outlook デスクトップ	d3590ed6-52b3-4102-aeff-aad2292ab01c
   Outlook Web Access	bc59ab01-8403-45c6-8796-ac3ef710b3e3
   Outlook モバイル	27922004-5251-4030-b22d-91ecd9a37ea4

Teams でカスタム アプリをアップロードする

更新したメッセージ拡張機能 (アプリ パッケージ) を Teams にアップロードします。 完了すると、メッセージの作成領域からインストールされている アプリ にメッセージ拡張機能が表示されます。

1. アプリ マニフェストとアプリ アイコンを含む .zip ファイルを作成 します。

2. Microsoft Teamsに移動し、サンドボックス テナント アカウントを使用してサインインします。

3. [アプリ]>[アプリの管理]>[アプリのアップロード] を選択します。

   

4. [ カスタム アプリのアップロード ] オプションを選択し、.zip ファイルを選択し、それを Teams クライアントにインストール (追加) します。

   

Teams を介してアップロードした後、メッセージ拡張機能は Outlook for Windows デスクトップと Web で使用できます。

Outlook でメッセージ拡張機能をプレビューする

Outlook on the web で実行されているメッセージ拡張機能をテストする方法を次に示します。 Outlook on the web で実行されているアプリをプレビューするには、次の手順に従います。

1. テスト テナント資格情報を使用して outlook.com にサインインします。

2. [新規メッセージ] を選択します。

3. リボンの [ アプリ ] を選択します。

   

メッセージ拡張機能が一覧表示されます。 そこからそれを呼び出し、Teams でメッセージを作成する場合と同じように使用できます。

デバッグ

メッセージ拡張機能をデバッグするときに、Activity オブジェクトの channelId フィールドによってボット要求のソース (Teams と Outlook から発信) を識別できます。 ユーザーがクエリを実行すると、サービスは標準の Bot Framework Activity オブジェクトを受け取ります。 Activity オブジェクトのプロパティの 1 つは channelIdであり、ボット要求の発生場所に応じて、 msteams または m365extensionsの値を持ちます。 詳細については、「 検索ベースのメッセージ拡張機能 SDK 」と 「アクション ベースのメッセージング拡張機能 SDK」を参照してください。

制限事項

更新されたメッセージ拡張機能は Teams で引き続き実行されますが、次の制限事項に注意する必要があります。

• Outlook のメッセージ拡張機能は、 compose コンテキストでのみサポートされます。 Teams アプリ マニフェストでは、 commandBox や message などのメッセージ拡張コンテキストは Outlook ではサポートされていません。

• 作成ボックスに カードを送信 するアクション ベースのメッセージ拡張機能は、Outlook でサポートされています。 ただし、 ボットを使用してカードを配信 することはサポートされていません。 このシナリオでは、メッセージ拡張機能を変換して、Outlook の作成ボックスに カードを送信 できます。

• 1 つのメールに 5 枚を超える アダプティブ カード を挿入することはできません。

• 種類messageBack、imBack、invoke、signinのカード アクションはサポートされていません。 openURL は、サポートされている唯一のカード アクションです。

• アダプティブ カードアクションがサポートされています。 Action.Submit では、ステージビューとタスクモジュールの起動のみがサポートされています。

注:

リンクが展開されていないアプリをテストする場合は、テスト後にアプリを手動で削除してください。 複数のアプリが同じドメインを監視している場合、最近インストールされたアプリは、Teams と同様に、Outlook のリンクを解除するために呼び出されない可能性があります。

Microsoft Teams 開発者コミュニティ チャネルを使用して、問題を報告し、フィードバックを提供します。

コード サンプル

サンプルの名前	説明	Node.js
NPM Search Connector	メッセージ拡張機能アプリを構築するための Teams Toolkit サンプル アプリ。 Teams と Outlook で動作します。	表示
Teams リンクの展開解除	リンクの展開を示すシンプルな Teams アプリ。 Teams、Outlook で動作します。	表示
Stageview のタブ	Microsoft Teams Stageview でタブを示すタブ サンプル アプリ。 Teams、Outlook、Microsoft 365 アプリで動作します。	表示
Microsoft 365 の Teams アクション ベースのメッセージ拡張機能	メッセージ拡張機能アプリを構築するための Teams Toolkit サンプル アプリ。 Teams と Outlook で動作します。	表示

次の手順

Outlook および Microsoft 365 アプリ用の Teams アプリを発行する