# Sesami Flows 和 Klaviyo
将 Sesami 与 Klaviyo 集成，为您的预约业务提供强大的电子邮件和短信营销能力。
## 什么是 Klaviyo？
Klaviyo 是一个营销自动化平台，主要用于电子邮件营销和短信营销。作为 Sesami 的战略合作伙伴，Klaviyo 为基于预约的业务提供强大的客户沟通工具。
## 为什么要将 Sesami 与 Klaviyo 集成？
通过将 Sesami 事件数据输入 Klaviyo，并通过 Klaviyo 触发所有通信（电子邮件或短信），您可以简化所有面向客户的互动。对于许多已经使用 Klaviyo 发送订单确认、短信营销消息和其他通信的企业来说，同时通过 Klaviyo 发送预约确认和预约提醒，可以打造统一的客户体验。
### 常见使用场景
**电子邮件和短信流程：**
* 预约确认流程
* 预约改期流程
* 预约取消流程
* 预约提醒流程（提前 24 小时，或自定义时间）
* 预约完成流程
**组合集成：**
* 通过评价平台（Okendo、Yotpo、Trustpilot 等）请求客户评价
* 在预约后邀请加入或跟踪忠诚度计划（LoyaltyLion、Swell 等）
* 个性化预约邮件（Limespot、Nosto 等）
## 工作原理
Sesami 使用 **Sesami Flows** 通过实时方式将预约事件发送到 Klaviyo。当预约被创建、改期、取消或完成时，Sesami 会将该事件数据作为自定义指标推送到 Klaviyo。然后，您可以在 Klaviyo 中创建基于这些指标触发电子邮件或短信的流程（Flows）。
### 数据流转过程
1. 客户在 Sesami 中预订预约
2. Sesami Flow 被触发，并通过 webhook 将事件数据发送到 Klaviyo
3. Klaviyo 将该事件作为自定义指标接收（例如，“Sesami Appointment Created”）
4. Klaviyo Flow 根据该指标触发
5. 客户收到包含预约详情的电子邮件或短信
## 设置说明
### 步骤 1：在 Sesami 中创建 Flow
1. 打开 **Sesami** 在你的 Shopify 后台中
2. 前往 **设置 > Flows**
3. 点击 **创建 Flow**
### 步骤 2：选择 Klaviyo 预设
从可用的 Klaviyo Flow 预设中选择：
* **Klaviyo 事件，预约已创建**
* **Klaviyo 事件，预约已改期**
* **Klaviyo 事件，预约已取消**
* **Klaviyo 事件，预约已完成**
* **Klaviyo 事件，预约提醒（提前 24 小时）**
{% hint style="info" %}
您可以通过复制提醒预设并更改触发时间，按需创建任意数量的提醒 Flow。
{% endhint %}
### 步骤 3：检查 Flow 设置
检查常规 Flow 设置，以了解触发条件和 webhook 配置。
### 步骤 4：获取您的 Klaviyo 私有 API 密钥
{% hint style="warning" %}
**重要**：截至 2024 年 6 月 12 日，Sesami Flows 使用的是 Klaviyo 的私有 API 密钥（而不是公钥）。请确保您创建的是私有密钥。
{% endhint %}
1. 登录您的 **Klaviyo 账户**
2. 前往 **设置 > API 密钥**
3. 点击 **创建私有 API 密钥**
4. 将其命名为“Sesami Integration”，并选择 **完全访问密钥**
5. 复制生成的私有 API 密钥
### 步骤 5：将您的 API 密钥添加到 Flow
1. 在您的 Sesami Flow 设置中，找到占位符 `KLAVIYO_PRIVATE_API_KEY`
2. 将其替换为您实际的 Klaviyo 私有 API 密钥
3. **保存** Flow
就这样！对您想发送到 Klaviyo 的每个 Klaviyo 事件重复这些步骤。
## 可用的事件属性
当 Sesami 将预约数据发送到 Klaviyo 时，会包含以下属性，并且可以在您的 Klaviyo 电子邮件或短信模板中使用：
| 属性 | 示例值 | 描述 |
| -------------------------------------- | ----------------------------- | ------------- |
| `{{ event.appointment_id }}` | 62e144124a6d0b9ed42ffb55 | 唯一的预约 ID |
| `{{ event.datetime }}` | 2022 年 7 月 29 日 下午 04:30 | 预约日期和时间 |
| `{{ event.order_id }}` | 4447608111157 | Shopify 订单 ID |
| `{{ event.quantity }}` | 1 | 预订数量 |
| `{{ event.service_name }}` | 激光去纹身 | 服务名称 |
| `{{ event.service_description }}` | 请提前 15 分钟到达 | 服务说明 |
| `{{ event.service_duration }}` | 30 | 时长（分钟） |
| `{{ event.service_price }}` | 149 | 服务价格 |
| `{{ event.service_location }}` | 100 Beverly Hills, LA | 服务地点 |
| `{{ event.service_image_url }}` | ... | 服务图片 URL |
| `{{ event.team_member }}` | David | 指定团队成员姓名 |
| `{{ event.team_member_description }}` | David 拥有十年经验 | 团队成员简介 |
| `{{ event.team_member_email }}` | | 团队成员邮箱 |
| `{{ event.team_member_phone }}` | 0000000000 | 团队成员电话 |
| `{{ event.variant_title }}` | 30 分钟 | 商品规格标题 |
| `{{ event.customer_management_link }}` | | 供客户管理预约的链接 |
| `{{ event.line_item_properties }}` | 问答对 | 自定义表单回复 |
## 在 Klaviyo 中设置 Flows
一旦 Sesami 开始向 Klaviyo 发送事件，您就需要在 Klaviyo 中创建 Flows 以向客户发送通信。
### 步骤 1：在 Klaviyo 中创建 Flow
1. 登录 **Klaviyo**
2. 前往 **Flows**
3. 点击 **创建 Flow**
### 步骤 2：选择指标触发器
1. 选择 **指标** 作为您的触发类型
2. 在指标下拉菜单中搜索“Sesami”
3. 选择相应的指标：
* **Sesami 预约已创建**
* **Sesami 预约已改期**
* **Sesami 预约已取消**
* **Sesami 预约已完成**
* **Sesami 预约提醒**
### 步骤 3：添加电子邮件或短信操作
1. 点击 **添加操作**
2. 选择 **电子邮件** 或 **短信**
3. 设计您的消息模板
### 步骤 4：在模板中使用事件属性
编辑电子邮件或短信内容时，您可以使用上表所示的语法访问所有与预约相关的属性。例如：
* `{{ event.datetime }}` - 显示预约日期和时间
* `{{ event.service_name }}` - 显示服务名称
* `{{ event.team_member }}` - 显示指定的团队成员
* `{{ event.customer_management_link }}` - 提供客户重新安排或取消的链接
### 步骤 5：将您的 Flow 设为上线
在您设计并测试好消息后，将您的 Flow 设置为 **上线** 以开始发送自动消息。
{% hint style="info" %}
**将您的 Klaviyo Flows 标记为事务性。** 预约确认、提醒、改期/取消通知以及类似的预约通信属于事务性消息，而非营销消息。在 Klaviyo 中将它们标记为事务性，可确保无论客户是否同意接收营销内容，都会发送给所有客户，并保持您的营销送达率整洁。
在 Klaviyo 中，打开 Flow 的消息操作，进入 **更多选项**，并将 **智能发送** 关闭，并将消息类型设置为 **事务性**.
{% endhint %}
## 测试您的集成
在正式上线之前，请测试集成：
1. 在 Sesami 中创建一个测试预约
2. 检查该事件是否出现在 Klaviyo 的 **活动动态** 或 **指标**
3. 验证所有预约属性是否正确填充
4. 测试您的 Klaviyo Flow，确保电子邮件/短信发送正常
5. 检查内容，确保所有动态属性都正确显示
{% hint style="success" %}
**专业提示**：创建一个测试客户电子邮件地址，并进行测试预订，以在为正式客户启用 Flows 之前验证完整的客户体验。
{% endhint %}
## 常见问题
如果我需要设置多个提醒 Flow 怎么办？
您可以通过使用 Klaviyo 提醒预设创建新的 Flows，并更改 Flow 配置中的触发时间，来构建任意数量的提醒 Flow。例如，您可以在以下时间发送提醒：
* 预约前 7 天
* 预约前 24 小时
* 预约前 2 小时
我可以将 Klaviyo 同时用于短信和电子邮件吗？
可以！Klaviyo 同时支持电子邮件和短信。只要您在 Klaviyo 账户中启用了短信，并且已在获得同意的情况下收集了客户电话号码，就可以在 Klaviyo Flows 中使用短信操作。
公钥要求发生了什么变化？
截至 2024 年 6 月 12 日，Sesami 已将所有 Flow 预设更新为使用 Klaviyo 的私有 API 密钥，而不是公钥，以符合 Klaviyo 更新后的 API 要求。在设置新的集成时，请始终使用私有密钥。
事件没有显示在 Klaviyo 中。我应该检查什么？
* 验证您的 Klaviyo 私有 API 密钥是否正确且具有完全访问权限
* 确保该 Flow 已在 Sesami 中启用
* 检查您是否在设置 Flow 后进行了测试预订
* 查看 Sesami Flow 日志，确认 webhook 是否已成功发送
* 检查 Klaviyo 的活动动态，查看事件是否已接收
## 相关
* [Sesami Flows](/zh-cn/zi-dong-hua/sesami-flows.md) - Sesami 自动化系统概览
* [电子邮件和 Webhook 操作](/zh-cn/zi-dong-hua/email-and-webhook-as-action-types.md) - 理解操作类型
* [Klaviyo 集成概览](/zh-cn/apps-integrations/klaviyo.md) - Klaviyo 常见模式
* [通知邮件](/zh-cn/tong-zhi/notification-emails.md) - 默认 Sesami 通知系统
---
# Agent Instructions: Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.
Perform an HTTP GET request on the current page URL with the `ask` query parameter:
```
GET https://help.sesami.co/zh-cn/zi-dong-hua/sesami-flows-and-klaviyo.md?ask=
```
The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.
Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.