# 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 以非同步方式處理 **輸出:** 傳回一個成功的布林值,表示訂閱工作是否排程成功。