受信箱・スレッド処理

受信したメールを閲覧・振り分け・ステータス管理する画面です。

受信メールを見る

• スレッド一覧: 件名・送信者・受信日時・未読件数を表示。新しい順
• スレッド詳細: スレッド内の各メッセージを順に表示 (最新が下)。HTML メールは DOMPurify でサニタイズ済み
• 添付ファイル: 各メッセージに一覧表示。クリックでダウンロード
• 既読管理: スレッドを開くと全メッセージが自動で既読に
• デフォルトビュー: 未対応 + 対応中のスレッドのみ表示。タブで「完了のみ」「すべて」に切り替え可能
• Load More ページング: スレッド一覧は 20 件ずつ表示。下部の「さらに読み込む」で追加 20 件をロード。cursor ベースなので新着到着でも位置ずれ・重複なし
• 「下書き」インジケータ: 自分が書きかけの返信を持っているスレッドは、件名の左に赤いイタリック「下書き」が表示されます。下書きを破棄すると消えます
• 下書きの自動再開: 下書きがあるスレッドを開くと、返信フォームが自動で展開して内容を再開できます (本文に内容のある下書きのみ。空のドラフトでは展開しない)

スレッド要約 (AI)

スレッド詳細画面の 「AI で要約」 ボタンから、スレッド全体の AI 要約を表示できます。長い会話の文脈把握や、引き継ぎ・横展開のときに有用です。

• 4 セクション構造: 概要 / 顧客のリクエスト / 過去の対応 / 次のアクション (推奨)
• 500 字以内に収まるよう生成 (token 上限 + プロンプト指示の二重制御)
• 結果ダイアログには「再生成」「閉じる」のみ。本文への自動挿入はしません
• 全ロールが利用可能 (オーナー / 対応者 / 確認者 / 閲覧者)
• 1 回 ~30 credit を消費。レート制限はユーザー単位で 5 req / 分
• メールボックス単位の AI 無効化設定で OFF にできます (メールボックス設定 → AI アシスタント)
• 返信下書きや本文の推敲については送信ページ → AI アシスタントを参照

サイドパネルのカウントバッジ

メールボックス内の左サイドパネル (内部ナビ) には、業務状況が一目で分かるよう各フォルダに件数バッジが表示されます。

• 更新タイミング: 自分のアクション (送信 / 既読化 / ステータス変更 / 下書き破棄 / 承認 等) は即時反映。他メンバーや外部由来 (新着メール 等) は最大 60 秒で polling 反映
• 「更新」ボタン: 押すとプロバイダからの取り込みをバックグラウンドで開始し、取り込めたメールから順次一覧に反映されます。件数が多くても画面は固まらず、すべて取り込み終わるまで裏で続行します (途中でやめてもエラーにはならず、取り込み済みのメールはそのまま残ります)。認証切れ・接続エラーなど対処が必要な場合のみエラーを表示します
• 0 件は非表示: 件数バッジは 1 件以上のときのみ表示されます
• 折りたたみ rail: パネルを折りたたむと、tooltip に「ラベル名 (件数)」形式で表示

ステータスと担当者

スレッドごとに単一担当者とステータスを管理します。

担当者アサイン

• スレッド詳細の「担当者」欄から自分 / 他メンバー / 解除を選べます
• オーナー / 対応者ロールのみ操作可能。閲覧者 / 確認者は閲覧のみ
• 自分以外をアサインすると、相手ユーザーに mail.assigned 通知が即時メール配信されます (個人設定で「1 時間まとめ」「1 日まとめ」にしていても、この通知だけは即時)
• 自分にアサインした場合は通知なし (self-assign)
• 再オープン: 完了スレッドに新着メールが到着すると自動で「未対応」に戻り、元の担当者は解除されます (再アサインを促す)

緊急度 (priority)

各スレッドには 緊急度フラグ を 3 段階で設定できます。 受信箱の一覧で色付きアイコンで識別でき、 並び替えやフィルタの基準として使えます。

• スレッド詳細ヘッダーの旗アイコンから 3 段階を切り替え可能
• 複数スレッドを選択して一括変更も可能 (受信箱の一括操作バー)
• 自動化ルール (mailbox-setup → 自動化ルール) の action で「条件マッチしたら緊急度を自動設定」 もできる
• 緊急度自体は通知トリガーにはならない。 即時通知が欲しい場合は別途自動化ルールの「ラベル付与 + 担当者アサイン」 で通知を発火させる

応答期限 (SLA)

スレッドごとに「この日時までに対応する」という期限を設定できます。カスタマーサポートで SLA (Service Level Agreement) を満たすための可視化・エスカレーション機能です。

期限の設定

• スレッド詳細画面の「期限を設定」ボタンから個別に設定
• +1 時間 / +24 時間 / +3 日 のプリセット + 任意の日時指定
• 期限は色付きバッジでスレッドヘッダに表示されます (余裕あり = 灰、期限近い = 黄、期限切れ = 赤)

自動適用

メールボックス設定の「接続」タブに「SLA (応答期限)」セクションがあり、自動適用時間を設定できます。

• 自動適用時間: N を指定すると、新規受信メールのスレッドに「受信時刻 + N 時間」を期限として自動セット
• 警告通知 (期限前): M 分前に担当者へ事前通知。空欄なら警告はオフ
• 既存スレッドの期限は自動適用で上書きされません (手動設定を尊重)

通知

• 期限接近通知: mail.slaWarning
• 期限切れ通知: mail.slaBreached
• 通知先は担当者。未アサインの場合は mailbox オーナーに届きます
• 退職などでメールボックスから外れたユーザーには通知は飛びません (自動フォールバック)

カスタム処理状況

デフォルトの「未対応 / 対応中 / 完了」3 ステータスに加えて、メールボックスごとに独自のステータスを追加できます (見積作成中・確認待ち・顧客返信待ち 等)。

設定

• メールボックス設定の「処理状況」タブを開く
• 「処理状況を追加」で名前 / 色 / 種別 (未対応 / 対応中 / 完了 のいずれか) を指定
• ドラッグ&ドロップで並び替え可能。「並び順を保存」で確定

デフォルトステータスの扱い

• 新規メールボックスには「未対応」「対応中」「完了」の 3 つがデフォルトで作成されます
• デフォルトは削除不可ですが、名前と色は自由に変更できます
• デフォルトは「種別」の変更ができません (フォルダ分類の基準を保つため)

種別 (kind) の役割

独自ステータスにも「未対応 / 対応中 / 完了」の 3 種別を必ず紐付けます。 これは未対応ビュー・完了ビューのフィルタで利用される内部区分です。 例:「見積作成中」は種別「対応中」にしておけば、「未対応」タブには出ず「対応中」タブに入ります。

削除時の挙動

削除したステータスを使っていたスレッドは、同じ種別のデフォルトに自動的に移動します (例: 「見積作成中 (対応中)」を削除すると、該当スレッドは「対応中」デフォルトに切り替わります)。スレッドの種別は保たれます。

同時対応の検知 (Presence)

複数メンバーが同じスレッドを同時に見ていることを UI で可視化し、作業の重複を防ぎます。

• 「いま見ているメンバー」アバター: スレッド詳細ヘッダに、直近 60 秒以内にそのスレッドを閲覧していたメンバーのアバターが表示されます
• 「返信作成中」バナー: 誰かが返信フォームを開くと、他メンバーの画面上部に「◯◯ さんが返信を作成中」とバナーが表示されます (返信自体はブロックしません — 同時返信の可能性は 409 Conflict で別途検知)
• Ping 間隔は 30 秒、TTL は 60 秒。ブラウザを閉じると自動で消えます