自訂屬性

Voxsig 支援除標準數據屬性（關於您的對話/聯絡人的預設數據集，如姓名、電郵、位置等）之外的自訂屬性。自訂屬性跟踪有關您的聯絡人/對話的事實。自訂屬性可以是任何內容，例如：

• 訂閱計劃
• 訂閱日期
• 註冊日期
• 最常訂購的商品
• 訂購的商品鏈接
• 上次交易日期

自訂與標準屬性的唯一差異是標準數據屬性會自動更新。

自訂數據屬性是您附加到對話/客戶的資訊，例如他們訂購產品的次數、註冊時間或他們的計劃。因此，您可以設置您想要了解的屬性以更好地了解您的客戶/對話，並且它都會顯示在 Voxsig 中。

新增自訂屬性

要新增自訂屬性，請導航至設定 -> 自訂屬性。

在頁面的右上角點擊 新增自訂屬性 按鈕，將會打開如下的模態框。

這些是建立自訂屬性所需的輸入：

輸入	描述
適用於	屬性類型（對話/聯絡人）
顯示名稱	作為渲染自訂屬性時的標籤
描述	關於自訂屬性的描述
類型	它將存儲的數據類型。目前支援文字、數字、鏈接和日期
鍵	與自訂屬性相關的唯一識別符

您不能在賬戶中使用相同的鍵兩次創建自訂屬性。

輸入詳情後，點擊 創建 按鈕。如果請求成功，將顯示"成功添加自訂屬性"的消息。

對話自訂屬性

1. 通過 SDK 方法設置屬性

您可以使用 SDK 的 setConversationCustomAttributes 方法為每個對話設置自訂屬性，並使用 deleteConversationCustomAttribute 方法刪除屬性。您可以在此了解更多關於設置對話屬性的資訊。

2. 通過聯絡人側邊欄設置屬性

在創建對話自訂屬性後，您可以通過對話側邊欄添加這些屬性到對話。

它會打開一個屬性下拉選擇器，然後選擇您想要添加的屬性。

輸入有效值後點擊創建按鈕。如果請求成功，將顯示"成功添加屬性"的消息。

您還可以通過懸停在屬性上查看像編輯/刪除/複製這樣的操作。

聯絡人自訂屬性

有兩種方法可以為聯絡人設置自訂屬性

1. 通過 SDK 方法設置屬性

要設置聯絡人自訂屬性，請按照以下方式調用 setCustomAttributes 方法，

window.$chatwoot.setCustomAttributes({
  key: value,
  // 鍵是在創建自訂屬性時已經定義的唯一識別符
  // 值應基於類型（目前支援數字、日期、字符串和數字）
  // 使用此功能時，確保您的鍵始終具有 JSON 有效值
  // 您需要在使用此函數時展平嵌套的 JSON 結構
});

示例：

window.$chatwoot.setCustomAttributes({
  plan: "premium",
  signUpDate: new Date(),
});

您可以在聯絡人側邊欄查看這些屬性。

要刪除自訂屬性，請按照以下方式使用 deleteCustomAttribute。

window.$chatwoot.deleteCustomAttribute("attribute-key");

示例：

window.$chatwoot.deleteCustomAttribute("signUpDate");

在版本 v1.22 之前，所有屬性都呈現為文本。請創建新的定義以正確顯示值。

2. 通過聯絡人側邊欄設置屬性

在創建了聯絡人自訂屬性後，您可以通過對話/聯絡人側邊欄將這些屬性添加到聯絡人。

它將打開一個屬性下拉選擇器，然後選擇您想要添加的屬性。

輸入有效值後點擊創建按鈕。如果請求成功，將顯示"成功添加屬性"的消息。

您還可以通過懸停在屬性上查看像編輯/刪除/複製這樣的操作。