> For the complete documentation index, see [llms.txt](https://help.sesami.co/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://help.sesami.co/zh-cn/zi-dong-hua/sesami-flows-and-klaviyo.md).

# Sesami 流程和 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 预约创建”）
4. Klaviyo Flow 根据该指标触发
5. 客户收到包含预约详情的电子邮件或短信

## 设置说明

### 第 1 步：在 Sesami 中创建 Flow

1. 打开 [Sesami 管理门户](https://help.sesami.co/admin/sesami-admin-portal)
2. 导航到 **Flows**
3. 点击 **创建 Flow**

### 第 2 步：选择 Klaviyo 预设

从可用的 Klaviyo Flow 预设中选择：

* **Klaviyo 事件，预约创建**
* **Klaviyo 事件，预约改期**
* **Klaviyo 事件，预约取消**
* **Klaviyo 事件，预约完成**
* **Klaviyo 事件，预约提前 24 小时提醒**

{% hint style="info" %}
你可以通过复制提醒预设并更改触发时间，创建所需数量的提醒 Flow。
{% endhint %}

<figure><img src="https://1798155128-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FnDgiM1CWSLWRIbhORANO%2Fuploads%2FuxdHvTIRYlwCWGpBwGIH%2FScreenshot%202026-08-27%20at%2013.33.08.png?alt=media&amp;token=2071f95d-dbf7-4dcf-a786-e0d1c0e5434d" alt=""><figcaption></figcaption></figure>

### 第 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 密钥**

<div><figure><img src="https://1798155128-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FnDgiM1CWSLWRIbhORANO%2Fuploads%2FJQQrLNJF0Wc1v55x5pw6%2FScreenshot%202026-08-27%20at%2013.37.52.png?alt=media&amp;token=2482f74f-2bd7-416a-b74c-e617cbd40076" alt=""><figcaption></figcaption></figure> <figure><img src="https://1798155128-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FnDgiM1CWSLWRIbhORANO%2Fuploads%2FtDaqzIIZt1JaRJaFN2Zo%2FScreenshot%202026-08-27%20at%2013.43.28.png?alt=media&amp;token=bdf7fd77-bbd9-4867-aa5c-dd62512056bf" alt=""><figcaption></figcaption></figure></div>

### 第 5 步：将你的 API 密钥添加到 Flow 中

1. 在你的 Sesami Flow 设置中，找到占位符 `KLAVIYO_PRIVATE_API_KEY`
2. 将其替换为你实际的 Klaviyo 私有 API 密钥
3. **保存** 该 Flow

<figure><img src="https://1798155128-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FnDgiM1CWSLWRIbhORANO%2Fuploads%2Fi5oTyjoqq0PXgNihjLCt%2FScreenshot%202026-08-27%20at%2013.46.46.png?alt=media&amp;token=cf59b1ba-62f8-4910-aef2-a545e114fd05" alt=""><figcaption></figcaption></figure>

### 第 6 步：创建并测试一次预约

1. 在 Sesami 中创建一个测试预约，以将 Sesami 与 Klaviyo 连接并发送事件数据。<br>
2. 测试完成后，相应事件及其属性将会在 Klaviyo 中可用。然后你可以继续进行 Klaviyo Flow 配置的下一步。

{% hint style="info" %}
**注意：** 必须创建一个测试预约，才能在新配置的 Sesami Flow 与 Klaviyo API 之间建立连接。

测试操作必须与 Flow 的触发条件匹配：

* 预约创建 → 创建一个新的测试预约。
* 预约改期 → 将现有预约重新安排。
* 客户签到 → 为客户的预约办理签到。
* 预约开始 → 等待预约开始。
* 预约取消 → 取消一个现有预约。
* 未到场 → 将预约标记为未到场。
  {% endhint %}

## 在 Klaviyo 中设置 Flows

一旦 Sesami 开始向 Klaviyo 发送事件，你就需要在 Klaviyo 中创建 Flows 来向客户发送沟通内容。

### 第 1 步：在 Klaviyo 中创建 Flow

1. 登录到 **Klaviyo**
2. 导航到 **Flows**
3. 点击 **创建 Flow** 然后 **自行构建**

<figure><img src="https://1798155128-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FnDgiM1CWSLWRIbhORANO%2Fuploads%2FgF1uw6IQslc07hlOzuBD%2FScreenshot%202026-08-27%20at%2014.23.17.png?alt=media&amp;token=daee427d-8831-4abc-979c-0f87e44b10ff" alt=""><figcaption></figcaption></figure>

### 第 2 步：选择指标触发器

1. 选择 **指标** 作为触发类型&#x20;
2. 点击 API
3. 找到“Sesami”并选择相应的指标。

<div><figure><img src="https://1798155128-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FnDgiM1CWSLWRIbhORANO%2Fuploads%2FdeylxlHLsqqiXcWoO3pb%2FScreenshot%202026-08-27%20at%2014.26.23.png?alt=media&amp;token=8c59d1a1-ec7f-413b-ae5c-b61baf23116c" alt=""><figcaption></figcaption></figure> <figure><img src="https://1798155128-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FnDgiM1CWSLWRIbhORANO%2Fuploads%2F5XGdGYX0ttyeANtcq58A%2FScreenshot%202026-08-27%20at%2014.30.23.png?alt=media&amp;token=c9c3fb06-9ad7-4f05-bc2b-9b6aa25f767f" alt=""><figcaption></figcaption></figure></div>

### 第 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 %}

## 可用事件属性

当 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 }}`             | Tattoo Removal                | 服务名称          |
| `{{ event.service_description }}`      | 请提前 15 分钟到达                   | 服务说明          |
| `{{ event.service_duration }}`         | 30                            | 时长（分钟）        |
| `{{ event.service_price }}`            | 149                           | 服务价格          |
| `{{ event.service_location }}`         | 100 Beverly Hills, LA         | 服务地点          |
| `{{ event.service_image_url }}`        | <https://cdn.shopify.com/>... | 服务图片 URL      |
| `{{ event.team_member }}`              | David                         | 分配的团队成员姓名     |
| `{{ event.team_member_description }}`  | David 有十年经验                   | 团队成员简介        |
| `{{ event.team_member_email }}`        | <david@email.com>             | 团队成员邮箱        |
| `{{ event.team_member_phone }}`        | 0000000000                    | 团队成员电话        |
| `{{ event.variant_title }}`            | 30 分钟                         | 产品规格标题        |
| `{{ event.customer_management_link }}` | <https://r.sesami.co/1234>    | 供客户管理预约的链接    |
| `{{ event.line_item_properties }}`     | 问题/答案对                        | 自定义表单回复       |

## 常见问题

<details>

<summary>如果我需要设置不止一个提醒流程怎么办？</summary>

你可以通过使用 Klaviyo 提醒预设创建新的 Flows，并在 Flow 配置中更改触发时间，来构建任意数量的提醒流程。例如，你可以在以下时间发送提醒：

* 预约前 7 天
* 预约前 24 小时
* 预约前 2 小时

</details>

<details>

<summary>我可以同时用 Klaviyo 发送短信和电子邮件吗？</summary>

可以！Klaviyo 同时支持电子邮件和短信。只要你在 Klaviyo 账户中启用了短信功能，并且已在获得同意的情况下收集了客户电话号码，就可以在 Klaviyo Flows 中使用短信操作。

</details>

<details>

<summary>公钥要求怎么变了？</summary>

截至 2024 年 6 月 12 日，Sesami 已将所有 Flow 预设更新为使用 Klaviyo 的私有 API 密钥，而不是公钥，以符合 Klaviyo 更新后的 API 要求。在设置新集成时，请始终使用私有密钥。

</details>

<details>

<summary>事件没有显示在 Klaviyo 中。我该检查什么？</summary>

* 确认你的 Klaviyo 私有 API 密钥正确且具有完全访问权限
* 确保 Flow 已在 Sesami 中启用
* 检查你在设置 Flow 后是否进行了测试预约
* 查看 Sesami Flow 日志，确认 webhook 是否已成功发送
* 检查 Klaviyo 的活动信息流，查看是否已接收到事件

</details>

## 相关

* [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
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## 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, and the optional `goal` query parameter:

```
GET https://help.sesami.co/zh-cn/zi-dong-hua/sesami-flows-and-klaviyo.md?ask=<question>&goal=<endgoal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.

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.