/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 が抜けていないか（= 管理者向け） |
