/contact/detail/{id} ページの操作方法を説明します。1人のコンタクト（= リード / 個人）の基本情報・アクセス履歴・送受信履歴・営業ステータスをまとめて確認できる画面です。
1. このページでできること
- 氏名 / メール / 電話 / 会社の閲覧と編集
- ステータス（7段階）の変更
- 配信停止フラグ（
receiver_email）の切替 - 過去のサイトアクセス履歴・ヒートマップの確認
- メール送信（個別アプローチ）の実行
- 会社の紐付け（主要会社の切替 / 他社追加）
- タグ付け / お断り（除外）設定
2. 画面の構成
ヘッダー部（基本情報）
| 項目 | 説明 |
|---|---|
| ステータス | 0=匿名 / 1=実名 / 2=アプローチ済 / 3=CV 済 / 4=商談 / 5=見積 / 6=受注 / 7=リピーター |
| 氏名 | 「{姓} {名} 様」表示。匿名は「匿名」 |
| 会社 | 主要紐付け会社（複数紐付け対応） |
| メール | 配信停止状態は赤バッジ |
| 電話 / IP / 住所 | サイト解析時に取れた情報 |
| タグ | 複数表示 |
| スコア | PV数（= 関心度） |
主要アクション（右上 or ヘッダー近辺）
| ボタン | 動作 |
|---|---|
| 編集 | EditContact モーダル: 氏名 / メール / 電話 / 会社 / ステータス / 配信停止フラグ / タグなどの編集 |
| メール送信 | ModalApproachContact を開いて即時送信（type_email=contact_approach_email） |
| タグ設定 | ModalUpdateTags |
| 会社を紐付け | 主要会社の切替 / 他社の追加・削除 |
| お断り | 会社を自動アプローチ対象から除外 |
| お断りを解除 | 上記の解除 |
アクセス履歴セクション
- 無限スクロールで全アクセス履歴を表示
- ページ別の閲覧時間 / 経路 / 流入元を確認
- 「ヒートマップを見る」ボタンでページ単位のスクロール / クリック分布を可視化
送受信履歴（会社経由でも確認可）
- 個別アプローチメール / 返信 / 自動アプローチ の履歴
- 開封・クリック状況
3. ステータスの考え方
7段階で営業フェーズを管理します:
0 匿名 → ステータス1未満。フォーム未入力でアクセスのみ 1 実名 → フォーム送信などで氏名・メール取得済 2 アプローチ済 → 1回以上メール / フォーム経由で接触済 3 CV済 → 資料DL / 問い合わせなどCVした 4 商談 → 初回商談実施済 5 見積 → 見積提示済 6 受注 → 受注確定 7 リピーター → 過去案件あり / 再取引中
「編集」モーダルでドロップダウンから変更可能です。
4. 配信停止（receiver_email）の管理
- ON（デフォルト）: メール配信可能
- OFF: 配信停止（= ユーザーがunsubscribeを実行した状態）
OFFのコンタクトに「メール送信」ボタンから送ろうとすると確認ダイアログが出ます（= 2026-06-15追加）。
5. URLクエリパラメータ
page=1 # アクセス履歴のページ
from_company={id} # 会社詳細から来た場合の戻り先
from_tab={tabName} # 会社詳細のどのタブから来たか
type_email=contact_approach_email # 開いた瞬間にメール送信モーダルを表示6. よく使う操作
メール送信
- 「メール送信」 ボタン → ModalApproachContact
- テンプレ選択 / 件名 / 本文 編集（CKEditor 5）
- 「メール送信する」で実行
- 配信停止コンタクトには警告ダイアログ → 必要ならOK
会社の紐付け切替
「会社を紐付け」 → ModalManageCompanies:
- 主要会社の切替
- 他社の追加 / 削除
- マスタにない会社は同モーダル内で検索後に新規登録
お断り（= 自動アプローチ除外）
「お断り」ボタン → 該当会社を自動アプローチ対象から除外。一覧で「お断り」 行動履歴として記録されます。「お断りを解除」で復活可。
7. トラブルシューティング
| 症状 | 確認 |
|---|---|
| 「メール送信」が無反応 | コンタクトにemailが登録されているか / ポップアップブロックを解除 |
| ヒートマップが表示されない | 「ヒートマップを見る」ボタンが消えている = まだ十分なアクセスログがない |
| ステータスを変えたのに一覧に戻ると反映されない | 一覧の検索条件で除外されている可能性。フィルタ確認 |
| 配信停止後も自動アプローチが走った | ジャーニー側にreceiver_email判定が無いノードがある可能性 → 別途相談 |