聯絡人

client.contacts 管理聯絡人 — 透過您的頻道進行通訊的潛在客戶、客戶或使用者。每個聯絡人可以有連結的對話、評論、檔案和活動歷史。

---

結構定義

Contact

欄位	類型	說明
object_name	string?	物件類型識別碼
id	string	唯一聯絡人 ID
organization_id	string	所屬組織
display_name	string?	聯絡人顯示名稱
email	string?	電子郵件地址
phone_number	string?	電話號碼
avatar_url	string?	個人資料圖片 URL
created_at	string	ISO 8601 建立時間戳
updated_at	string	ISO 8601 更新時間戳

UpdateContactInput

欄位	類型	必填	說明
name	string		更新顯示名稱
email	string		更新電子郵件地址
phone	string		更新電話號碼

ContactComment

欄位	類型	說明
_id	string	唯一評論 ID
text	string?	評論內容
created_at	string?	ISO 8601 建立時間戳

ContactFile

欄位	類型	說明
_id	string	唯一檔案 ID
name	string?	檔案名稱
url	string?	下載 URL
size	number?	檔案大小（位元組）

---

方法

方法	TypeScript	Python	說明
列出	list	list	分頁的聯絡人列表
取得	get	get	依 ID 取得聯絡人
更新	update	update	更新聯絡人欄位
搜尋	search	search	跨聯絡人全文搜尋
匯出 CSV	exportCsv	export_csv	以 CSV 下載所有聯絡人
取得對話	getConversations	get_conversations	列出聯絡人的對話
取得評論	getComments	get_comments	列出聯絡人的內部評論
取得檔案	getFiles	get_files	列出附加到聯絡人的檔案
取得活動紀錄	getActivities	get_activities	對話活動日誌
上傳頭像	uploadAvatar	upload_contacts	上傳檔案到聯絡人（頭像 / 檔案匯入）
列出通知	listNotifications	list_notifications	列出目前使用者的通知
將通知標為已讀	markNotificationsRead	mark_notifications_read	將通知標記為已讀
關閉通知	dismissNotification	dismiss_notification	關閉單一通知
關閉所有通知	dismissAllNotifications	dismiss_all_notifications	清除所有通知

---

list / list

TypeScript

const page = await client.contacts.list({ limit: 50, skip: 0 });
for (const contact of page.data) {
  console.log(contact.id, contact.display_name, contact.email);
}

Python

page = client.contacts.list(limit=50, skip=0)
for contact in page.get("data", []):
    print(contact["id"], contact.get("display_name"), contact.get("email"))

---

search / search

TypeScript

const results = await client.contacts.search({
  q: "alice@example.com",
  limit: 10,
});

Python

results = client.contacts.search("alice@example.com")

---

update / update

TypeScript

const contact = await client.contacts.update("contact_id", {
  name: "Alice Smith",
  email: "alice@example.com",
  phone: "+84912345678",
});

Python

contact = client.contacts.update("contact_id", {
    "name": "Alice Smith",
    "email": "alice@example.com",
    "phone": "+84912345678",
})

---

getConversations / get_conversations

TypeScript

const conversations = await client.contacts.getConversations("contact_id", {
  channelTypes: "whatsapp,web",
});

Python

conversations = client.contacts.get_conversations(
    "contact_id",
    channel_types="whatsapp,web",
)

---

getComments / get_comments

TypeScript

const comments = await client.contacts.getComments("contact_id", {
  limit: 20,
  skip: 0,
});

Python

comments = client.contacts.get_comments("contact_id", limit=20, skip=0)

---

getActivities / get_activities

傳回與此聯絡人關聯的對話活動日誌。

TypeScript

const activities = await client.contacts.getActivities("conversation_id");

Python

activities = client.contacts.get_activities("conversation_id")

---

listNotifications / list_notifications

TypeScript

const page = await client.contacts.listNotifications({ limit: 20, skip: 0 });
for (const n of page.data) {
  console.log(n);
}

Python

page = client.contacts.list_notifications(limit=20, skip=0)

---

markNotificationsRead / mark_notifications_read

TypeScript

await client.contacts.markNotificationsRead(["notif_id_1", "notif_id_2"]);

Python

client.contacts.mark_notifications_read()

---

uploadAvatar / upload_contacts

TypeScript

const formData = new FormData();
formData.append("file", avatarBlob, "avatar.png");
const result = await client.contacts.uploadAvatar(formData);
console.log(result.url);

Python

with open("avatar.png", "rb") as f:
    result = client.contacts.upload_contacts(files={"file": f})
print(result)