Assist_Design/docs/ja/uat/notifications.md

sidebar_position, title

sidebar_position	title
12	通知

通知

概要

このガイドでは、アカウント、注文、請求、サービスに関する重要なイベントを通知するアプリ内通知システムについて説明します。通知はポータルのデータベースに保存され、Salesforce（Platform Events経由）、WHMCS（フルフィルメントプロセス経由）、ポータル自体からのイベントによってトリガーされます。

ポータルフロー

通知ベル

1. ベルアイコンはログイン中のすべてのページのナビゲーションバーに表示されます。
2. 未読通知がある場合、ベルにカウントバッジが表示されます（9件超は「9+」）。
3. 未読数は60秒ごとに自動更新されます。

通知ドロップダウン

1. ベルをクリックすると最新10件の通知が表示されます。
2. 各通知に表示される情報：
   • タイプを示すアイコン（緑：肯定的、琥珀色：警告、青：一般）
   • 通知タイトル（未読は太字）
   • 短いメッセージ
   • 相対的なタイムスタンプ
   • 未読インジケーター（小さな青い点）
3. 上部に**「Mark all read」**ボタン（未読通知がある場合）。
4. 各通知はホバー時のXボタンで個別に非表示にできます。

通知タイプ

タイプ	タイトル	トリガー	リンク先
Internet Eligible	「インターネットサービスが利用可能」	利用資格確認完了	インターネットサービスページ
Internet Ineligible	「インターネットサービスは利用不可」	利用資格確認完了	サポートページ
ID Verified	「本人確認完了」	エージェントが在留カードを承認	チェックアウト継続
ID Rejected	「本人確認に対応が必要」	エージェントが在留カードを却下	確認再提出ページ
Order Approved	「注文承認済み」	Salesforceで注文承認	注文ページ
Service Activated	「サービス有効化」	WHMCSプロビジョニング完了	サービスページ
Order Failed	「注文に対応が必要」	フルフィルメントエラー	サポートページ
Cancellation Scheduled	「解約予定」	顧客が解約をリクエスト	サービスページ
Invoice Due	「請求書期限」	7日以内に支払期限	請求書ページ

通知のトリガー方法

Salesforceから（Platform Events経由）：

• SalesforceエージェントがInternet_Eligibility_Status__cやId_Verification_Status__cを更新した際、Platform Eventが発火し通知を作成。
• 通知は最終状態（Eligible/Ineligible、Verified/Rejected）でのみ作成されます。

フルフィルメントプロセスから：

• 注文の承認、有効化、またはフルフィルメントワークフロー中のエラー時に通知を作成。

ダッシュボードチェックから：

• ダッシュボード読み込み時に7日以内に期限の請求書があるかチェックし、通知を作成。

重複排除

• 大部分の通知タイプは1時間の重複排除ウィンドウを使用。
• 請求書期限等は24時間の重複排除ウィンドウを使用。

WHMCSで起こること

• WHMCSはポータル通知を直接保存しません。
• ただし、WHMCSイベントが間接的に通知をトリガーする場合があります（サービス有効化時、請求書期限接近時など）。

Salesforceで起こること

• SalesforceイベントがPlatform Events経由で通知をトリガーします。
• Salesforceはポータル通知レコードを保存しません。通知はポータルのデータベースに存在します。

確認すべき重要事項

• ベルアイコンが正しい未読数を表示すること
• ドロップダウンに正しいタイトル、メッセージ、アイコン、タイムスタンプが表示されること
• 通知クリックで未読インジケーターが消えること
• 「Mark all read」ですべての未読インジケーターが消えること
• アクションリンク付き通知が正しいページに移動すること
• Salesforceでの利用資格・確認ステータス変更時に通知が表示されること
• 同じイベントを1時間以内に2回トリガーしても通知が1つだけ作成されること