# Klaviyo 整合 Klaviyo 整合可讓您將Botpress 聊天機與領先的客戶資料和行銷自動化平台 Klaviyo 連線。透過此整合，您的聊天機器人可以建立線索、更新客戶資訊，以及將檔案訂閱至簡訊和電子郵件行銷。 ## 可用的動作 ### 建立檔案 在 Klaviyo 建立新的客戶檔案。此動作可讓您在 Klaviyo 資料庫中加入新的聯絡人，並提供完整的個人檔案資訊。 **必填欄位：** - ** 電子郵件地址** 或 ** 電話號碼** (E.164格式，如 +15005550006) **可選欄位：** - 名字**和**姓氏** - 組織名稱**和職稱** - ** 地區** (IETF BCP 47 格式，如 en-US、fr-FR) - 位置**（地址詳細資訊，包括地址線、城市、國家、地區、郵遞區號） - 自訂屬性**（用於儲存附加設定檔資料的鍵值對） ** 輸出：** 將已建立的個人資料連同其唯一的 Klaviyo ID 傳回。 ### 更新檔案 使用個人資料的唯一ID更新Klaviyo現有的客戶個人資料。這個動作允許您在建立後修改任何設定檔資訊。 **必填欄位：** - ** 個人資料 ID** (要更新的個人資料的唯一 Klaviyo 識別碼) **可選欄位：** - ** 電子郵件地址** (更新檔案的電子郵件) - 電話號碼** (E.164格式) - 名字**和**姓氏** - 組織**和 **職稱** - 地點** (IETF BCP 47 格式) - 位置**（完整的地址資訊） - 自訂屬性**（鍵值對） **輸出：** 傳回包含所有目前資訊的更新設定檔。 ### 取得檔案 使用獨特的 ID 從 Klaviyo 擷取特定的客戶資料。這個動作對於查詢個別客戶資訊非常有用。 **必填欄位：** - ** 個人資料 ID** (要擷取的個人資料的唯一 Klaviyo 識別碼) ** 輸出：** 回傳完整的檔案資訊，包括 ID、電子郵件、電話、姓名和所有其他儲存的資料。 ### 取得個人檔案 使用篩選器和排序選項從 Klaviyo 搜尋並取得多個客戶檔案。此動作非常適合根據特定條件尋找客戶群組。 **篩選選項：** - 篩選欄位：** `id`、`email`、`phone_number`、`external_id`、`created`或`updated`中選擇。 - 篩選運算符號：** 使用比較運算符號，例如 `equals`, `contains`, `greater-than`, `less-than`, `starts-with`, `ends-with` 等。 - 篩選值：** 要搜尋的值 (支援字串和日期) **分頁與排序：** - 頁面大小：** 要返回的檔案數量 (1-100, 預設：20) - 排序：** 以任何欄位排序，可選擇降序（前綴為 `-`）。 **使用範例：** - 尋找在特定日期後建立的所有設定檔 - 搜尋電子郵件地址包含網域的設定檔 - 取得依建立日期排序的設定檔 (最新的先) ** 輸出：** 傳回符合您條件的設定檔陣列。 ### 訂閱檔案 在 Klaviyo 訂閱多個客戶資料到電子郵件和/或簡訊行銷清單。此動作以非同步方式處理訂閱，一次可處理多達1,000筆資料。 **必填欄位：** - ** 個人檔案訂閱：** 包含同意資訊的個人檔案陣列 - ** 設定檔 ID**（或電子郵件/電話，用於識別） - 電子郵件同意：** 表示同意電子郵件行銷的布林值 - 同意使用簡訊行銷：** 表示同意使用簡訊行銷的布林值 **可選欄位：** - 清單 ID：** 特定 Klaviyo 清單，以將訂閱的檔案新增至該清單 - 歷史匯入：** 布林來匯入歷史檔案 **重要注意事項：** - 每個要求最多 1,000 個設定檔 - 至少需要一個設定檔 - 同意標誌決定設定檔將訂閱哪些行銷管道 - 此作業由 Klaviyo 以非同步方式處理 **輸出：** 傳回一個成功的布林值，表示訂閱工作是否排程成功。
