# Klaviyo 集成 Klaviyo 集成让您可以将Botpress 聊天机器人与领先的客户数据和营销自动化平台 Klaviyo 相连。有了这个集成，您的聊天机器人就可以创建潜在客户、更新客户信息、订阅 SMS 和电子邮件营销。 ## 可用操作 ### 创建档案 在 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"、"电话号"、"外部id"、"创建 "或 "更新 "中选择 - 筛选运算符：** 使用比较运算符，如`相等`、`包含`、`大于`、`小于`、`开始于`、`结束于`。 - 过滤器值：** 要搜索的值（支持字符串和日期） **分页和排序：** - 页面大小：** 要返回的配置文件数量（1-100，默认：20） - 排序：** 按任意字段排序，可选择降序（前缀为 `-`) **使用案例示例：** - 查找特定日期后创建的所有配置文件 - 搜索电子邮件地址包含域的配置文件 - 获取按创建日期排序的配置文件（最新的优先） **输出：** 返回符合条件的配置文件数组。 ### 订阅配置文件 将多个客户资料订阅到 Klaviyo 的电子邮件和/或短信营销列表。此操作以异步方式处理订阅，可同时处理多达 1,000 份资料。 **必填字段：** - 配置文件订阅：** 包含同意信息的配置文件数组 - 配置文件 ID**（或用于识别的电子邮件/电话） - 电子邮件同意：** 表示同意电子邮件营销的布尔值 - 短信同意：** 表示同意短信营销的布尔值 **可选字段：** - 列表 ID：** 要将订阅配置文件添加到的特定 Klaviyo 列表 - 历史导入：** 布尔值用于导入历史配置文件 **重要说明：** - 每个请求最多 1,000 个配置文件 - 至少需要一个配置文件 - 同意标志决定个人资料将订阅到哪些营销渠道 - 该操作由 Klaviyo 异步处理 **输出：** 返回成功布尔值，表示订阅任务是否成功安排。
