/mail/inboxページの操作方法を説明します。取引先からの返信メールを「自分の Gmail / Outlook から grip 専用アドレスへ転送」する形でgrip上に集約し、会社 / コンタクトに自動紐付けして営業履歴と統合管理する画面です。
1. このページでできること
- 取引先からの返信メールを1画面で一括確認
- Fromアドレスからの自動会社紐付け / 未紐付け振り分け
- そのまま返信送信
- 商談化フラグ（CVカウント）の管理
- アーカイブ（= 処理済み）/ 削除 / 紐付け解除
2. 事前準備（転送設定）
画面上部「転送先アドレス」カードに自分専用のアドレス（例:xxxxxx@inbound.grip.space）が表示されます。
- Gmail / Outlookなど普段の受信箱の設定で、そのアドレスへの転送を有効化
- 自社ドメイン管理カードに自社ドメイン（例:
grip.space）を追加（自社内メールは取り込み対象外にするため） - 上部「受信を有効化」トグルをON
これで以後の返信メールがgrip上に流れてきます。
3. 画面の構成
上部カード
| カード | 内容 |
|---|
| 転送先アドレス | 自社専用inboundアドレス + 受信ON/OFF |
| 自社ドメイン | 取り込み対象外（= 内部メール除外）ドメインの追加 / 削除 |
フィルタ バー
| タブ | 件数の意味 |
|---|
| 受信トレイ | 未読 + 紐付け済（= アーカイブ以外） |
| 未紐付け | Fromから会社が特定できていないメール |
| 紐付け済み | matched_company_idがセットされたメール |
| アーカイブ | 処理済み（ignored） |
| すべて | 全件 |
一覧テーブル
| 列 | 意味 |
|---|
| ☑ | 一括選択 |
| ★ | 重要マーク（クリック切替） |
| ● | 未読インジケータ（青ドット） |
| 差出人 | from_name または from_email |
| 件名 + 本文プレビュー | クリックで詳細モーダル |
| 状態 | pending / matched / ignoredの色バッジ |
| 受信日時 | YYYY-MM-DD HH:MM（JST） |
4. メール詳細モーダル
メール行クリックで開きます。開いた瞬間に既読化されます。
表示内容
- 件名 / 差出人 / 受信日時
- 本文（HTML or plain）
- 会社候補チップ: fromドメインから推測された会社候補（1社のみなら自動紐付け済）
主要ボタン
| ボタン | 動作 |
|---|
| 返信 | ModalApproachContactを開いて返信メール作成（matched 済みのみ） |
| 会社を紐付け | 候補チップ クリック or 「会社名で検索」から手動指定 |
| 紐付け解除 | status をpendingに戻す（会社 / コンタクトは削除しない） |
| アーカイブ | status='ignored'に |
| CVカウント | このメールをCVとしてカウント（= ジャーニーやKPIに反映） |
自動紐付けのルール
- Fromのメールアドレスで既存コンタクトを検索 → ヒットすれば即紐付け
- メールドメインから会社候補を検索 → 1件のみなら自動紐付け
- 複数候補があれば手動選択
- どれもなければ「未紐付け」タブに残る
紐付けると同時にmatched_company_id / matched_contact_idがセットされ、/company/view/{id}の送受信履歴 にも反映されます。
5. URL
| URL | 内容 |
|---|
/mail/inbox | このページ |
/mail/ | 同じくInbox表示（旧URL互換） |
| 詳細モーダル内のリンク | /company/view/{id}//contact/detail/{id} |
URLクエリパラメータは現状なし（= 状態はモーダル / フィルタボタンで管理）。
6. よく使う運用
| シナリオ | 操作 |
|---|
| 朝イチで返信を一覧確認 | 受信トレイ タブ → 上から既読 |
| 重要顧客の返信だけ後で対応 | ★ で重要マーク |
| 自社内メールが入ってきた | 「自社ドメイン」に該当ドメイン追加で次回以降除外 |
| 商談化した返信をKPIに乗せる | 詳細を開いて「CVカウント」をオン |
| 不要 / スパムを片付け | ☑ 一括選択 → アーカイブ |
7. トラブルシューティング
| 症状 | 確認 |
|---|
| 一覧が空 | 転送先アドレスへの転送設定が完了しているか / 「受信を有効化」がONか |
| 自社内メールが入ってくる | 「自社ドメイン」にドメインを追加 |
| 会社候補が出ない | fromドメインがマスタにない可能性。手動検索 → なければ会社一覧で新規登録 → 再度紐付け |
| 返信ボタンが押せない | 未紐付けメールは返信不可。先に会社を紐付け |
/mail/inboxで受信が止まった（= テスト環境） | テストコンテナの再起動時にtarget=/var/Maildirが抜けていないか（= 管理者向け） |
