Microsoft Teams アクティビティ フィード通知を使用するためのベスト プラクティス

この記事では、Microsoft Graph で Microsoft Teams アクティビティ フィード通知を使用するためのベスト プラクティスについて説明します。 これらのベスト プラクティスは、次の場合に適用されます。

• 行動喚起通知の作成
• 通知への応答の要求
• 外部イベントに関する通知の作成

次の図は、Teams でのアクティビティ フィード通知の例を示しています。

アクティビティ フィード通知を実装する場合は、次の点に注意してください。

• トースト通知は、ユーザーをアプリではなくアクティビティ フィードにリダイレクトします。 別のアクティビティを表示するには、ユーザーがアクティビティ フィードで関連付けられている通知を選択する必要があります。
• ユーザーは、選択したアプリが通知を送信した後にのみ通知設定を管理できます。
• 各通知のアイコンは、アプリ マニフェストに含まれています。 Microsoft Graph では、アイコンのカスタマイズはサポートされていません。
• 優先度通知はサポートされていません。

通知エクスペリエンスを強化する

Microsoft Teams では、アクティビティ フィードとトースト形式の両方で通知が表示されます。 ユーザーは、チャット、チャネル、会議、またはその他のアプリ間で複数のソースから通知を受け取ります。 ユーザー エクスペリエンスを強化するには、次の推奨事項を適用します。

• 通知トーストまたはフィード内のコンテンツをローカライズします。 ローカライズは、アプリのコンテンツが ローカライズされている場合にのみ行われます。
• アクティビティの種類に適したタイトルと説明を入力します。 @メンションやアナウンスなどの短いタイトルを使用します。 ユーザーが言及したアクティビティや作成後のアクティビティなど、長いタイトルは避けてください。
• 通知は、ユーザーに関連する重要な情報を伝える必要があります。 たとえば、 ディエゴがあなたに販売チケットを割り当てた のは関連するメッセージです。 Joni は営業チームを離れた のではありません。
• サイクリング アプリの新機能を試すなど、本質的にプロモーション的な通知は送信しないでください。
• ボット メッセージとアクティビティ フィード通知からの重複通知を避けます。 詳細については、「 アクティビティ フィード通知またはボット フレームワーク メッセージの選択」を参照してください。
• 通知の テキスト プレビュー セクションを使用します。 ユーザーが通知の重要性を判断し、必要に応じてアクションを実行するのに役立つ情報を提供します。
• Teams の他のすべての通知設定と一致するように、通知タイトルの末尾にピリオドを追加しないでください。
• 通知とそのコンテンツの関係をユーザーに明確にします。 たとえば、ユーザーが休暇を承認するための通知を受け取ると、通知はそれらをアプリの対応するセクションにリダイレクトする必要があります。 通知がユーザーやタスクなどのエンティティの削除または削除に関連する場合は、受信者をコンテンツに誘導し、必要なアクションを示します。
• フィード エクスペリエンスが自己完結型であることを確認します。 たとえば、ポップアップとモーダルはアプリに残る必要があります。
• アプリがユーザーごとに 1 分あたり 20 件を超える通知を送信しないことを確認します。 カウントが 20 を超えると、通知は自動的に調整されます。
• アプリの読み込み時間が、フィード内の通知を切り替えたときのユーザーのエクスペリエンスに悪影響を与えないことを確認します。
• アクティビティ フィードの通知の保存期間についてユーザーに通知します。 Microsoft Teams では、ストレージ期間は 30 日です。

  注:

  30 日間のストレージ制限はすべての通知に適用されます。 アクティビティ フィード通知 API を介して送信される通知に固有ではありません。

アクティビティ フィード通知またはボット フレームワーク メッセージを選択する

アクティビティ フィード通知またはボット フレームワーク メッセージは使用できますが、両方の通知の種類は使用しないでください。 次のセクションでは、通知の種類と、それぞれを使用するタイミングについて説明します。

アクティビティ フィード通知

アクティビティ フィード通知は Teams アクティビティ フィードに表示され、さまざまな場所へのリンクを含めることができます。 次の通知:

• ユーザーがアクションを実行したり、通知をトリアージしたりできるようにします。
• チャットまたはチャネル、個人用アプリ、またはチャットまたはチャネル メッセージのタブにユーザーを誘導します。

アクティビティ フィード通知 API を使用すると、ユーザーは通知設定から 通知の種類ごとに通知 を構成できます。

アクティビティ フィード通知を使用する場合は、ボット通知がチャットまたはチャネルに送信され、アクティビティ フィードにも送信される場合は、アプリが二重通知を送信する可能性があることに注意してください。 シナリオで必要な場合にのみ、二重通知を送信します。

委任された通知を使用して、より良い通知エクスペリエンスを作成します。 アクティビティ フィード通知 API は、委任された呼び出しまたはアプリケーションのみの呼び出しを送信できます。 委任された呼び出しでは、通知の送信者が通知を開始したユーザーとして表示され、アプリケーションのみの呼び出しでは、送信者がアプリとして表示されます。

chainId パラメーターを使用して新しい通知を作成する代わりに、既存のアクティビティ フィード通知を更新できます。

ボット フレームワーク メッセージ

ボット メッセージは、チャット メッセージまたはチャネル メッセージとして配信されます。 ユーザーがチャットまたはチャネルの通知をオンにした場合、トリガーされる通知はチャットまたはチャネル メッセージとして送信されます。 ボット メッセージを送信するには、@メンションアクティビティ フィードに通知を表示するユーザーの名前を指定します。

アラートをチャットまたはチャネル メッセージとして使用すると便利です。たとえば、すべてのチャネル メンバーによって使用されるメッセージです。

関連コンテンツ

• Microsoft Teams のアクティビティ フィード通知を設計する
• Microsoft Teams API の概要