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

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

アクティビティ フィード通知の使用例

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

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

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

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

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

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

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

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

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

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

アクティビティ フィード API は、Teams アプリと連携します。 アクティビティ フィード通知を送信するための要件は次のとおりです。

• アプリ マニフェストの Microsoft Entra アプリ ID を webApplicationInfo セクションに追加する必要があります。 詳細については、「 アプリ マニフェスト スキーマ」を参照してください。
• アクティビティ通知は、アプリ マニフェストにアクティビティ タイプを追加した場合でも、追加しなくても送信できます。
  • 既定では、アクティビティ通知 API は、アプリ マニフェストに activities セクションを追加せずに使用できます。 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 update

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

アクティビティの更新

"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}"
    }
  ]
}

承認の更新

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

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

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

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

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

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

• チャットでのユーザーへの通知の送信
• チームでのユーザーへの通知の送信
• ユーザーへの通知の送信

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

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

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

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

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

通知をカスタマイズする

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

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

例

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

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

• systemDefaultアクティビティの種類は予約済みであるため、アクティビティの追加時にアプリ マニフェストで使用することはできません。
• 通知のテンプレート化は、反復的で大規模なバッチの通知については、アプリ マニフェスト内のアクティビティ テンプレートに依存するため、テンプレート化された通知を使用することをお勧めします。
• systemDefault で予約されたアクティビティの種類は、他のアクティビティの種類がアプリ マニフェストにリストされている場合でも使用できます。

systemDefault アクティビティ タイプの利点と制限事項は次のとおりです。

コード サンプル

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

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

関連項目

• Teams の通知ボット
• Microsoft Teams アプリのアクティビティ フィード通知を設計する