---
sidebar_position: 12
title: "通知"
---

# 通知

## 概要

このガイドでは、アカウント、注文、請求、サービスに関する重要なイベントを通知するアプリ内通知システムについて説明します。通知はポータルのデータベースに保存され、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つだけ作成されること
