Skip to content

欄位字典

Call 物件 Custom Properties

系統使用的 HubSpot Call 物件自訂欄位：

內部名	顯示名	型別	寫入時機	範例值
`genesys_conversation_id`	Genesys 對話 ID	string	P2-A 建 Call 時	`abc12345-...`
`transcribe_status`	處理狀態	enum	各階段更新	`pending / transcribing / transcribed / summarizing / summarized / failed`
`transcribe_error`	錯誤訊息	string	失敗時	`[UNANSWERED]` / `whisper timeout`
`transcript_raw`	原始逐字稿	string（長文）	P2-B 寫入	雙軌時間穿插格式
`intent_label`	意圖標籤	enum	P2-C 寫入	`詢價 / 售後 / 抱怨 / 一般諮詢`
`follow_up`	後續待辦	string	P2-C 寫入	`寄目錄\n回電報價`

HubSpot 原生 Call 欄位（系統使用）

內部名	用途
`hs_call_title`	寫【AI摘要】+ call_subject
`hs_call_body`	寫完整摘要 + 雙軌逐字稿
`hs_call_direction`	INBOUND / OUTBOUND
`hs_call_from_number`	來電號碼（INBOUND）
`hs_call_to_number`	對方號碼（OUTBOUND）
`hubspot_owner_id`	接話業務員

Contact 物件 Custom Properties

AI 自動填寫（fill-only-empty）

內部名	顯示名	型別	寫入規則
`firstname`	名字	string	空白才補（≥ 2 字才填）
`lastname`	姓氏	string	4 碼電話 fallback 會被清空
`gender`	性別	enum	空白才補；從稱謂推（先生→男）
`salutation`	稱謂	string	空白才補（先生/小姐/媽媽等）
`company`	公司	string	空白才補（≥ 3 字才填）
`industry`	行業	string	空白才補（≥ 2 字才填）
`jobtitle`	職稱	string	空白才補（≥ 2 字才填）
`address`	地址	string	空白才補；明確念出才填
`city`	城市	string	空白才補
`state`	縣市	string	空白才補
`zip`	郵遞區號	string	空白才補
`country`	國家	string	空白才補
`checkout_method`	結帳/配送方式	multi-select	空白才補；分號分隔

AI 永遠覆蓋（最新通話資訊）

內部名	顯示名	型別	內容
`latest_call_intent`	最近通話意圖	string	最近一通的 intent_label
`last_call_summary`	最近通話摘要	string（長文）	5 點摘要
`latest_call_followup`	最近通話待辦	string	條列字串
`latest_call_date`	最近通話時間	datetime	ISO 8601
`last_call_date`	最近通話日期	date	yyyy-mm-dd（Frank 手建欄位）
`latest_call_id`	最近 Call ID	string	可拼成 HubSpot 連結

系統自動填寫（不靠 AI）

內部名	內容	寫入時機
`phone`	主要電話	建 Contact 時
`mobilephone`	行動電話	若空白 → 用 phone 補
`hubspot_owner_id`	負責業務	從 Genesys agent 推導

`checkout_method` 選項清單

順序	選項	內部名
1	現金	`現金`
2	匯款	`匯款`
3	貨到付款	`貨到付款`
4	刷卡（v3.2 新增）	`刷卡`
5	店取	`店取`
6	宅配	`宅配`

multi-select 儲存格式：HubSpot 內部以分號分隔，例 刷卡;宅配。

`intent_label` 選項清單

選項	適用情境
詢價	客戶詢問價格、報價、優惠
售後	已購買產品的問題、退換、保固
抱怨	不滿意、客訴、要求改善
一般諮詢	上述以外的所有情況（含 fallback）

`transcribe_status` 狀態機

        ┌──────────┐
        │ pending  │ ← P2-A 建 Call 時
        └────┬─────┘
             │ P2-B 撈
             ▼
      ┌─────────────┐
      │ transcribing│
      └──────┬──────┘
             │ /transcribe 完成
             ▼
     ┌──────────────┐
     │ transcribed  │ ← P2-C 撈
     └──────┬───────┘
            │
            ▼
    ┌──────────────┐
    │ summarizing  │
    └──────┬───────┘
           │ OpenAI 完成
           ▼
   ┌──────────────┐
   │  summarized  │ ✅
   └──────────────┘

           失敗任一階段
           ↓
   ┌──────────────┐
   │   failed     │ → 看 transcribe_error
   └──────────────┘

手動重跑

業務改 transcribe_status：

改 pending → P2-B 隔天重抓 + 重新轉錄
改 transcribed → P2-C 隔天重新摘要

n8n 內部變數（Phase 1 維運參考）

變數	值	位置
`GENESYS_ORG`	`hualiteqintlcorp`	n8n credentials
`GENESYS_REGION`	`mypurecloud.jp`	n8n credentials
`N8N_WEBHOOK_URL`	（內部）	n8n credentials
`HUBSPOT_PORTAL_ID`	（甲方提供）	n8n credentials
VM `/transcribe` API key	（在 P2-B X-API-Key header）	n8n credentials
`AGENT_TO_OWNER` mapping	見上方 Owner 指派邏輯	P2-A Extract Call Info
`DEFAULT_OWNER_ID`	`163916104`	P2-A Extract Call Info
Cron P2-A	`0 19 * * *`	P2-A Schedule
Cron P2-B	`30 19 * * *`	P2-B Schedule
Cron P2-C	`0 10,14,18,22 * * *`	P2-C Schedule
時間窗 P2-A	1500 分鐘（25 小時）	P2-A Calculate Time Range
Search Pending limit	50	P2-B / P2-C
Whisper chunkSeconds	60	VM `/transcribe`