Microsoft Teamsのユーザーにアクティビティフィード通知を送信する

[アーティクル]
12/17/2024

Microsoft Teams アクティビティフィードを使用すると、ユーザーは変更を通知することで、注意が必要な項目をトリアージできます。 Microsoft Graph のアクティビティフィード通知 API を使用して、この機能をアプリに拡張できます。これにより、アプリはより豊富なエクスペリエンスを提供し、ユーザーが使用するツールとワークフローの変更を最新の状態に保つ手助けをすることで、ユーザーのエンゲージメントを向上できます。

アクティビティフィード通知のユースケース

ニュース: ユーザーが新しい割り当てや新しい投稿などの最新情報を更新し続けるのに役立ちます。
コラボレーション: コメントでファイルまたは @ メンションユーザーを共有すると、ユーザーは通知バナーにテキストプレビューを表示できます。
リマインダー: イベントまたはタスクについて知らせる通知。たとえば、今日トレーニングの期限があり、タスクやイベントを思い出すのに役立つリマインダー通知がアプリから送信されます。
アラート: 緊急または即時の注意が必要な通知。たとえば、トレーニングの期限が過ぎた場合や、管理者が最も優先度の高いバグを修正する要求を送信した場合などです。

アクティビティフィード通知の利点

アクティビティフィード通知は、ユーザーを Tab アプリにシームレスに取り込み、 アクティビティ からアプリへの追加のユーザーエンゲージメントをもたらすネイティブの Teams 統合です。
アクティビティフィード通知には、Teams デスクトップクライアントとモバイルクライアントの OS 通知が付属しているため、ユーザーの注意はシステムのポップアップとサウンドから取得されます。
通知コンテンツは高度にカスタマイズ可能で、ユーザーは通知されたイベントの概要をプレビューできます。
ユーザーが通知を選択すると、ユーザーアプリのエンゲージメントが向上するように、アプリを通知にディープリンクできます。
アクティビティフィード通知をさまざまな受信者に送信できます。たとえば、個人の通知を送信したり、ユーザーのグループにバッチ通知を送信したりします。
アプリマニフェスト (以前は Teams アプリマニフェストと呼ばれる) ローカライズでは、アクティビティフィード通知のテンプレートテキストがサポートされています。

アクティビティフィード通知の基本を理解する

Teams では、アクティビティフィード通知は、次の図に示すように、複数のビットの情報で構成されます。

コンポーネントには次のものが含まれます。

カウンター	説明
1	アバター: アクティビティを開始したユーザーを示します。
2	アクティビティの種類またはアプリアイコン: アクティビティの種類またはアプリアイコンは、アクティビティの種類を示します。アプリ通知の場合、行アイコンはアプリアイコンに置き換えられます。
3	タイトル: アクター + 理由: アクター: アクティビティを開始したユーザーまたはアプリの名前。理由: アクティビティについて説明します。
4	タイムスタンプ: アクティビティが発生したタイミングを示します。
5	テキストプレビュー: 通知の先頭から切り捨てられた行が表示されます。
6	場所: Teams でアクティビティが発生した場所を示します。

次の例は、コンポーネントが通知に関する詳細を提供する一緒に示しています。

アクティビティフィード通知カードの種類

次のバリエーションは、表示できるアクティビティフィード通知カードの種類を示しています。アプリのロゴは、アプリによって生成された通知のユーザーアバターに置き換えられます。

デスクトップ
モバイル

カウンター	説明
1	Teams カスタム
2	Windows
3	Mac

カウンター	説明
1	Android
2	iOS

アクティビティフィード通知 API を使用するための要件

アクティビティフィード API は、Teams アプリで動作します。アクティビティフィード通知を送信するための要件を次に示します。

アプリマニフェストには、webApplicationInfo セクションにMicrosoft Entraアプリ ID が追加されている必要があります。詳細については、「アプリマニフェストスキーマ」を参照してください。
アクティビティ通知は、アプリマニフェストに追加されたアクティビティの種類の有無に関係なく送信できます。
- 既定では、アプリマニフェストに activities セクションを追加せずに、アクティビティ通知 API を使用できます。 systemDefaultアクティビティの種類は予約されており、アクティビティフィード通知のActor+Reason行に自由形式のテキストを指定できます。詳細については、「カスタマイズ可能なアクティビティフィード通知を送信する」を参照してください。
  
  注:
  
  systemDefault アクティビティの種類は、パブリック開発者プレビューでのみ使用できます。
- 従来のモードでテンプレート化された通知を送信する場合は、 activityTypes プロパティをアクティビティセクションに追加する必要があります。詳細については、「アプリマニフェストスキーマ」を参照してください。
Teams アプリは、受信者が個人的にインストールするか、チームにインストールするか、参加しているチャットにインストールする必要があります。

アクセス許可

委任されたアクセス許可またはアプリケーションのアクセス許可を使用して、アクティビティフィード通知を送信します。アプリケーションのアクセス許可を使用する場合は、TeamsActivity.Send.Userアクセス許可がユーザーがアクティビティ通知を送信することに同意するため、リソース固有の同意 (RSC) を使用することをお勧めします。アプリマニフェストファイルに RSC アクセス許可を追加してください。

アプリマニフェストの更新

このセクションでは、アプリマニフェストに追加する必要がある更新プログラムについて説明します。アプリマニフェストバージョン1.7以降を使用していることを確認します。

"$schema": "https://developer.microsoft.com/json-schemas/teams/v1.7/MicrosoftTeams.schema.json",
"manifestVersion": "1.7",

webApplicationInfo 更新プログラム

"webApplicationInfo":
{
    "id": "a3111f15-658e-457c-9689-fd20fe907330",
    "resource": "https://contosoapp.com"
}

パラメーター	型	説明
`id`	string	アプリ ID (クライアント ID) をMicrosoft Entraします。
`resource`	string	Microsoft Entra アプリに関連付けられているリソース。 Microsoft Azure Portal の応答 URL またはリダイレクト URL とも呼ばれます。

注:

同じスコープ内の複数の Teams アプリ (チーム、チャット、またはユーザー) が同じMicrosoft Entra アプリを使用している場合、エラーが発生する可能性があります。一意のMicrosoft Entra アプリを使用していることを確認します。

アクティビティの更新

"activities":
{
  "activityTypes": [
    {
      "type": "taskCreated",
      "description": "Task Created Activity",
      "templateText": "{actor} created task {taskId} for you"
    },
    {
      "type": "approvalRequired",
      "description": "Deployment requires your approval",
      "templateText": "{actor} created a new deployment {deploymentId}"
    }
  ]
}

パラメーター	型	説明
type	string	動作状況の種類。これは、特定のアプリマニフェストで一意である必要があります。
説明	string	人間が判読できる簡単な説明。これは Teams クライアントに表示されます。
templateText	string	アクティビティ通知のテンプレートテキスト。パラメーターを追加するには、パラメーターを `{}`にカプセル化します。

注:

actorは、常に呼び出し元の名前を受け取る特別なパラメーターです。委任された呼び出しでは、 actor はユーザーの名前です。アプリケーションのみの呼び出しでは、Teams アプリの名前を受け取ります。
予約済みの systemDefault アクティビティの種類は、アプリマニフェストの [ activities ] セクションに含めることはできません。 systemDefaultアクティビティの種類を使用すると、アクティビティフィード通知のActor+Reason行に自由形式のテキストを指定できます。

承認の更新

"authorization": 
{ 
  "permissions": { 
    "resourceSpecific": [ 
      {
        "type": "Application", 
         "name": "TeamsActivity.Send.User" 
      }, 
      { 
        "type": "Application",
        "name": "TeamsActivity.Send.Group"
      }, 
      { 
        "type": "Application", 
        "name": "TeamsActivity.Send.Chat" 
      } 
    ] 
  }
}

パラメーター	型	説明
type	string	RSC アクセス許可の種類。
name	string	RSC アクセス許可の名前。詳細については、サポートされている RSC アクセス許可に関するページを参照してください。

Teams アプリをインストールする

ユーザーがアクティビティフィード通知を受信するには、Teams アプリをチーム、チャット、または個人用スコープ内のユーザーにインストールする必要があります。詳細については、「 Teams アプリの配布方法」を参照してください。開発目的では、カスタムアプリのアップロードを推奨します。開発後、1 つのテナントに発行するか、すべてのテナントに発行するかに基づいて、適切な配布方法を選択できます。

Teams アプリインストール API を使用して、Teams アプリのインストールを管理することもできます。

アクティビティフィード通知をユーザーに送信する

Teams アプリはユーザー、チーム、チャットにインストールできるため、次の 3 つのコンテキストで通知を送信することもできます。

さらに、一度に最大 100 人のユーザーに通知を一括で送信できます。

複数のユーザーに一括で通知を送信する

各シナリオでサポートされているトピックの詳細については、特定の API を参照してください。カスタムテキストベースのトピックは、すべてのシナリオでサポートされています。

アクティビティフィード通知は、次のシナリオで使用できます。

注意が必要なカスタマイズされたコンテンツについて個人に通知します。
タブアプリまたは URL にリッチコンテンツを表示します。
複雑なユーザー操作をサポートします。
通知を開始したユーザーから委任された通知を送信します。
アプリマニフェストにテンプレートを配置します。
Teams は、通知のローカライズを処理します。

注:

アクティビティアイコンは、要求が行われたコンテキストに基づいています。委任されたアクセス許可で要求が行われた場合、ユーザーの写真がアバターとして表示され、Teams アプリアイコンがアクティビティアイコンとして表示されます。アプリケーションのみのコンテキストでは、Teams アプリアイコンがアバターとして使用され、アクティビティアイコンは省略されます。

通知をカスタマイズする

Teams ユーザーは、フィードまたはバナーとして表示される通知をカスタマイズできます。アクティビティフィード API を介して生成された通知もカスタマイズできます。ユーザーは、Teams の設定を使用して通知する方法を選択できます。次のスクリーンショットに示すように、ユーザーが選択できる Teams アプリが一覧に表示されます。

ユーザーは、アプリの横にある [編集] を選択し、通知をカスタマイズできます。アプリマニフェストには、 description フィールドが表示されます。

例

アクティビティフィード通知を送信する方法の例については、「送信アクティビティフィード通知の例」を参照してください。

送信アクティビティフィード通知の予約済みアクティビティの種類

systemDefault アクティビティの種類は予約されており、アクティビティの追加中にアプリマニフェストで使用することはできません。
テンプレート化された通知は、定期的な大量の通知のバッチに対してアプリマニフェストのアクティビティテンプレートに依存するため、使用することをお勧めします。
systemDefault予約済みアクティビティの種類は、他のアクティビティの種類がアプリマニフェストに一覧表示されている場合でも使用できます。

systemDefault アクティビティの種類の利点と制限事項を次に示します。

利点制限事項

アプリマニフェストにアクティビティの種類を追加せずに、新しいシナリオをテストし、アクティビティフィード通知 API を試すことができます。

Teams ストアアプリでは、 systemDefault アクティビティの種類によってプロセスが簡略化され、アプリマニフェストでアクティビティの種類を一定に調整する必要がなくなるため、時間を節約できます。 systemDefault アクティビティの種類はすぐに使用できます。アプリマニフェストによって提供される組み込みのローカライズ機能を利用することはできません。

systemDefault アクティビティの種類を使用してカスタマイズ可能な通知を送信することはできません。ユーザーは、Teams クライアント設定のトグルを使用してアプリからのすべての通知をオフにできます。これにより、アプリとそのユーザー間の通信が妨げられる可能性があります。

利点	制限事項
アプリマニフェストにアクティビティの種類を追加せずに、新しいシナリオをテストし、アクティビティフィード通知 API を試すことができます。 Teams ストアアプリでは、 `systemDefault` アクティビティの種類によってプロセスが簡略化され、アプリマニフェストでアクティビティの種類を一定に調整する必要がなくなるため、時間を節約できます。 `systemDefault` アクティビティの種類はすぐに使用できます。	アプリマニフェストによって提供される組み込みのローカライズ機能を利用することはできません。 `systemDefault` アクティビティの種類を使用してカスタマイズ可能な通知を送信することはできません。ユーザーは、Teams クライアント設定のトグルを使用してアプリからのすべての通知をオフにできます。これにより、アプリとそのユーザー間の通信が妨げられる可能性があります。

コードサンプル

サンプルの名前	説明	.NET	Node.js
アクティビティフィード通知を送信する	サンプルアプリは、Microsoft Graph APIを使用してアクティビティフィード通知を送信する方法を示しています。	表示	表示

ステップバイステップのガイド

Teams でアクティビティフィード通知を送信するには、ステップバイステップガイドに従います。

次の方法で共有

Microsoft Teamsのユーザーにアクティビティフィード通知を送信する

アクティビティフィード通知のユースケース

アクティビティフィード通知の利点

アクティビティフィード通知の基本を理解する

アクティビティフィード通知カードの種類

アクティビティフィード通知 API を使用するための要件

アクセス許可

アプリマニフェストの更新

webApplicationInfo 更新プログラム

アクティビティの更新

承認の更新

Teams アプリをインストールする

アクティビティフィード通知をユーザーに送信する

通知をカスタマイズする

例

送信アクティビティフィード通知の予約済みアクティビティの種類

コードサンプル

ステップバイステップのガイド

関連項目

その他のリソース

次の方法で共有

Microsoft Teamsのユーザーにアクティビティ フィード通知を送信する

アクティビティ フィード通知のユース ケース

アクティビティ フィード通知の利点

アクティビティ フィード通知の基本を理解する

アクティビティ フィード通知カードの種類

アクティビティ フィード通知 API を使用するための要件

アクセス許可

アプリ マニフェストの更新

webApplicationInfo 更新プログラム

アクティビティの更新

承認の更新

Teams アプリをインストールする

アクティビティ フィード通知をユーザーに送信する

通知をカスタマイズする

例

送信アクティビティ フィード通知の予約済みアクティビティの種類

コード サンプル

ステップ バイ ステップのガイド

関連項目

その他のリソース

Microsoft Teamsのユーザーにアクティビティフィード通知を送信する

アクティビティフィード通知のユースケース

アクティビティフィード通知の利点

アクティビティフィード通知の基本を理解する

アクティビティフィード通知カードの種類

アクティビティフィード通知 API を使用するための要件

アプリマニフェストの更新

アクティビティフィード通知をユーザーに送信する

送信アクティビティフィード通知の予約済みアクティビティの種類

コードサンプル

ステップバイステップのガイド