對話

client.conversations 管理聯絡人與您的團隊（或 AI 代理）之間的對話串。每個對話屬於一個 Channel 並連結到一個 Contact。

---

結構定義

Conversation

欄位	類型	說明
object_name	"conversation"	物件類型辨識符
id	string	唯一對話 ID
organization_id	string	所屬組織
business_unit_id	string	業務單位 ID
channel_id	string	此對話所屬的頻道
channel_type	string	頻道平台類型（參閱 Channel）
contact_id	string	連結的聯絡人 ID
status	string	對話狀態（例如 open、resolved）
name	string	對話顯示名稱
timestamp	string	最新訊息的 ISO 8601 時間戳
users	SimpleUser[]	目前在此對話中的團隊成員

---

方法

方法	TypeScript	Python	說明
列出	list	list	分頁的對話列表
取得	get	get	依內部 ID 取得對話
依對話 ID 取得	getByConversationId	—	依公開對話 ID 取得
搜尋	search	search	在業務單位內全文搜尋
取得檢視數量	getViewsCount	get_views_count	依檢視/狀態計算對話數量
建立	create	create	建立新對話
加入	join	join	以團隊成員身份加入對話
離開	leave	leave	離開對話
更新狀態	updateStatus	update_status	變更對話狀態
更新名稱	updateName	—	重新命名對話
發起視訊通話	initVideoCall	—	在對話中開始視訊通話
指派團隊成員	assignTeamMember	—	指派團隊成員到對話
移除團隊成員	removeTeamMember	—	移除團隊成員
取得可邀請的使用者	getInvitableUsers	—	列出可邀請的使用者

---

list / list

TypeScript

const page = await client.conversations.list({
  type: "open",
  q: "billing",
  limit: 20,
  skip: 0,
});
for (const conv of page.data) {
  console.log(conv.id, conv.name, conv.status);
}

Python

page = client.conversations.list(type="open", q="billing", limit=20, skip=0)
for conv in page.get("data", []):
    print(conv["id"], conv.get("name"), conv.get("status"))

---

search / search

TypeScript

const results = await client.conversations.search({
  businessUnitId: "bu_id",
  q: "refund request",
  limit: 10,
});

Python

results = client.conversations.search(
    business_unit_id="bu_id",
    q="refund request",
    limit=10,
)

---

create / create

TypeScript

const conversation = await client.conversations.create({
  channel_id: "channel_id",
  contact_id: "contact_id",
});
console.log(conversation.id);

Python

conversation = client.conversations.create()
print(conversation["id"])

---

join / join

TypeScript

await client.conversations.join({ conversation_id: "conversation_id" });

Python

client.conversations.join({"conversation_id": "conversation_id"})

---

updateStatus / update_status

TypeScript

await client.conversations.updateStatus({
  conversation_id: "conversation_id",
  status: "resolved",
});

Python

client.conversations.update_status({
    "conversation_id": "conversation_id",
    "status": "resolved",
})

---

assignTeamMember

TypeScript

await client.conversations.assignTeamMember({
  conversation_id: "conversation_id",
  user_id: "agent_user_id",
});

Python

# Python SDK 不提供

---

leave / leave

TypeScript

await client.conversations.leave({ conversation_id: "conversation_id" });

Python

client.conversations.leave({"conversation_id": "conversation_id"})

---

getByConversationId

TypeScript

const conversation = await client.conversations.getByConversationId("public_conversation_id");
console.log(conversation.id, conversation.status);

Python

# Python SDK 不提供

---

getViewsCount / get_views_count

TypeScript

const counts = await client.conversations.getViewsCount({ type: "open" });
console.log(counts);

Python

counts = client.conversations.get_views_count(type="open")
print(counts)

---

updateName

TypeScript

await client.conversations.updateName({
  conversation_id: "conversation_id",
  name: "VIP Support Thread",
});

Python

# Python SDK 不提供

---

removeTeamMember

TypeScript

await client.conversations.removeTeamMember({
  conversation_id: "conversation_id",
  user_id: "agent_user_id",
});

Python

# Python SDK 不提供

---

getInvitableUsers

TypeScript

const users = await client.conversations.getInvitableUsers("conversation_id");
for (const u of users) {
  console.log(u._id, u.name);
}

Python

# Python SDK 不提供

---

initVideoCall

TypeScript

const result = await client.conversations.initVideoCall({
  conversation_id: "conversation_id",
});
console.log(result.conversation);

Python

# Python SDK 不提供