客戶檔案和工單
查詢和同步客戶檔案，從你的系統建立工單。
4.4 客戶檔案
同一個顧客的會話歸到一份客戶檔案，會話裡的 contact_id 指向它。識別規則：你簽名的會員 ID（user_token 或 API 傳的 user.id）> 渠道使用者（如微信 openid）> 網頁訪客。匿名訪客登入後併入會員的檔案；兩個不同會員不會自動合併，電子郵件、手機相同的只在後台提示，由客服手動合併。
| 方法 | 路徑 | 說明 |
|---|---|---|
| GET | /v1/contacts?user_id= 或 ?email= | 按你的會員 ID 或電子郵件查客戶檔案 |
| GET | /v1/contacts/{id} | 客戶檔案：姓名、電子郵件、手機、標籤 tags、備註 notes、自訂欄位 attributes、會話數、最近來訪時間、會員 ID user_ids |
| PATCH | /v1/contacts/{id} | 從你的系統同步資料：name、phone、tags（最多 30 個）、notes、attributes（整體替換，最多 30 個欄位）。只傳要改的欄位 |
4.5 工單
| 方法 | 路徑 | 說明 |
|---|---|---|
| POST | /v1/tickets | 建工單，比如網站的「聯絡我們」表單：subject、description、priority（urgent / high / normal / low）、顧客的 name / email / phone，可選關聯 conversation_id 或 contact_id。有電子郵件時客服的回覆會發郵件給顧客 |
| GET | /v1/tickets/{id} | 工單和時間軸（顧客留言、客服回覆、狀態變化；不含內部備註） |
工單狀態：open 待處理、pending 等待顧客、resolved 已解決、closed 已關閉。處理時限按優先級在「機器人設定」裡設定。
這頁對你有幫助嗎？
最後更新:
