每段對話和每通電話都歸在一個客戶名下,同一個人在各個渠道都是同一個客戶。客戶只按別人冒充不了的資訊合併,例如來電號碼、你的網站為已登入訪客簽名的使用者 ID;訪客自己填的電子郵件或電話會記在資料上,由你的團隊在工作台裡合併。你的系統可以讀取客戶庫、保持資料最新,並把 EvaSay 之外發生的事寫進來。
| 方法 | 路徑 | 作用 |
|---|---|---|
| GET | /api/v1/voice/contacts | 客戶列表,最近聯絡的在前:q 搜尋姓名、電子郵件、電話、公司和標籤,segment_id 只看一個分組,limit(最多 100)和 offset 翻頁 |
| GET | /api/v1/voice/contacts/{id} | 一個客戶的資料、標籤、同意狀態和你自己的欄位 |
| PATCH | /api/v1/voice/contacts/{id} | 修改 name、email、phone、company、city、country、language、timezone、tags 或 attributes |
| GET | /api/v1/voice/contact-fields | 你自己的客戶欄位:每個的 key、label、type 和 options |
| GET | /api/v1/voice/contacts/{id}/events | 客戶的時間軸,最新的在前 |
| POST | /api/v1/voice/contacts/{id}/events | 從你自己的系統寫入一個事件 |
| GET | /api/v1/voice/contacts/{id}/consent | 每一次同意變化,附來源和證據 |
| POST | /api/v1/voice/contacts/{id}/consent | 記錄一次同意變化 |
| GET | /api/v1/voice/segments | 客戶分組;counts=true 時附上每組現在有多少客戶 |
curl https://evasay.com/api/v1/voice/contacts/CONTACT_ID \
-X PATCH \
-H "Authorization: Bearer sk-your-key" \
-H "Content-Type: application/json" \
-d '{ "company": "Acme Dental", "tags": ["vip"], "attributes": { "plan": "Gold" } }'
tags 會取代客戶的全部標籤。attributes 用你自己欄位的 key(在「客戶」頁新增,GET /api/v1/voice/contact-fields 可以列出),值要符合欄位類型;傳空字串就是清空。團隊成員在工作台裡填的值會保留:API 不會覆蓋它,Agent 也不會。修改電子郵件或電話不會把這個客戶和另一個有同樣資料的客戶合併。標準資料(name、email、phone 等)則按傳入的值直接取代。
把你自己系統裡發生的事(下單、到店、續約等)寫進來,它會出現在客戶的時間軸上:
curl https://evasay.com/api/v1/voice/contacts/CONTACT_ID/events \
-X POST \
-H "Authorization: Bearer sk-your-key" \
-H "Content-Type: application/json" \
-d '{ "event_id": "order-1042", "name": "order_paid", "subject": "Order 1042", "values": { "total": "89.00" } }'
name 只能用小寫字母、數字、_ 和 .。event_id 是你自己的 ID:同一個客戶上同一個 event_id 只記一次,所以可以放心重試,重複的那次 accepted 是 false。values 放文字,flags 放 true 或 false,appointment_at 是 Unix 毫秒時間。
EvaSay 把四種同意分開記錄:marketing_email、marketing_sms、marketing_calls 和 service_calls(兩種電話都包括 AI 聲音的來電)。每種是 granted、withdrawn,還沒有任何記錄時是 unknown。同意記錄只追加、不修改,每條附來源和證據:
{ "kind": "marketing_calls", "status": "granted", "note": "Ticked 'Call me about offers' on order 1042" }
只有擁有者和管理員的金鑰能記錄同意,而且必須帶上 note(你的證據)。
分組是客戶庫上儲存好的篩選條件:每個工作區都有的(全部客戶、VIP、最近 7 天新增等)、你所在產業的,以及你在「客戶」頁自己建的。GET /api/v1/voice/segments 列出分組和它們的 id;把它作為 segment_id 傳入,就能列出這個分組的客戶。
你的系統也可以在變化發生時收到通知:contact.created、contact.updated、contact.consent_changed 和 contact.merged 都是 Webhook 事件。