Implementation Detail

詳細設計

画面仕様、架電キュー状態遷移、次の架電先選定、KPI算出、Googleスプレッドシート連携、Zoom Phone連携、AI要約まで、実装に必要な判断をまとめます。

画面仕様

KPIダッシュボード

当日・当月の架電数、接続率、商談化、再架電漏れ、担当者別KPIを表示。マスターは全体、リーダーはチーム、担当者は自分のみ。

リスト取り込み

GoogleスプレッドシートID、シート名、列マッピング、取り込み前プレビュー、重複確認、CRM登録、書き戻しを行う。

架電モード

次の1件だけを表示し、ワンクリック架電、結果入力、次回架電日時、保存して次へを中心にする。

リード詳細

通話履歴、メモ、文字起こし、AI要約、次アクションを管理。担当者には原則詳細一覧を見せない。

架電キュー状態遷移

queued 取得 in_progress 結果保存 done
状態意味次の遷移
queued架電待ちin_progress / skipped / held
in_progress担当者が表示中または架電中done / held / queued
done結果保存済み完了
skipped今回スキップqueuedへ戻すか保留
held保留リーダー確認後にqueuedへ戻す

次の架電先ロジック

  1. 自分に割り当てられている
  2. 架電タスクが待機中
  3. 期限が今日以前、または期限未設定
  4. リードステータスが未架電または再架電
  5. 優先度が高い
  6. 再架電期限が近い
  7. 架電回数が少ない
  8. 最終架電日時が古い
priority_score =
  優先度点
  + 再架電期限超過点
  + 未架電点
  - 架電回数ペナルティ

KPI算出

KPI算出方法
架電数call_logs の件数
接続数connected / interested / meeting_booked の件数
接続率接続数 ÷ 架電数
商談化数meeting_booked の件数
商談化率商談化数 ÷ 架電数
再架電予定数next_call_at が入っている未完了件数
再架電漏れ数next_call_at が過去で未完了の件数

連携シーケンス

Google Sheets取り込み

  1. シートID登録
  2. ヘッダー検証
  3. 電話番号正規化
  4. 重複チェック
  5. CRM登録
  6. CRM IDを書き戻し

Zoom Phone実連携

  1. 架電開始
  2. タスクを進行中へ
  3. Zoom Phoneで発信
  4. 通話終了Webhook
  5. 通話IDを紐づけ
  6. KPIへ反映

AI要約

  1. 文字起こし取得
  2. 個人情報マスキング
  3. AI要約
  4. 温度感分類
  5. 人間レビュー
  6. CRMへ反映

実装優先順位

順番作るもの理由
1DB・認証・RBAC顧客情報と電話番号を扱う土台
2Sheets取り込みCRM登録の入口
3架電モード担当者が実際に使う中心機能
4結果保存・KPIリーダーとマスターが成果を判断できる
5Zoom Phone連携入力負担を減らし、通話証跡を残す
6AI要約商談候補と次アクションを見逃さない

関連ファイル