> 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-omnisend.md).

# Sesami 流程和 Omnisend

将 Sesami 与 Omnisend 集成，为您的预约业务提供高级电子邮件和 SMS 营销支持。

## 什么是 Omnisend？

Omnisend 是一个营销自动化平台，专注于电商企业的电子邮件和 SMS 营销。它提供一套工具和功能，旨在帮助电商企业与客户互动、提升销售并提高整体营销效率。

## 为什么要将 Sesami 与 Omnisend 集成？

你可以将 Sesami 事件数据传送到 Omnisend，并通过 Omnisend 触发所有通信（电子邮件或 SMS），从而简化面向客户的所有互动。对于许多已经使用 Omnisend 发送订单确认、SMS 营销消息和其他通信的企业来说，将预约确认和提醒也通过 Omnisend 发送，可以打造统一的客户体验。

### 常见用例

**电子邮件和 SMS 工作流：**

* 预约确认流程
* 预约改期流程
* 预约取消流程
* 预约提醒流程（提前 24 小时，或自定义时间）
* 预约完成流程

## 工作原理

Sesami 使用 **Sesami Flows** 将预约事件实时发送到 Omnisend。当预约被创建、改期、签到、开始、取消或标记为未到场时，Sesami 会通过 webhook 将该事件数据推送到你在 Omnisend 中创建的自定义事件。然后，你可以在 Omnisend 中创建工作流，根据这些自定义事件触发电子邮件或 SMS 消息。

### 数据流向

1. 客户在 Sesami 中预约
2. Sesami Flow 触发并通过 webhook 向 Omnisend 发送事件数据
3. Omnisend 将该事件作为自定义事件接收（例如“预约已创建”）
4. Omnisend 工作流基于该事件触发
5. 客户收到包含预约详情的电子邮件或 SMS

## 设置说明

### 第 1 部分：设置 Omnisend

#### 步骤 1：安装并连接 Omnisend

1. 安装 **Omnisend 应用** 来自 Shopify 应用商店
2. 按照应用的设置步骤连接你的商店
3. 完成 Omnisend 入门设置流程

#### 步骤 2：创建 API 密钥（KPI 密钥）

1. 在 Omnisend 中，点击你的 **个人资料选项卡**
2. 前往 **商店设置**
3. 点击 **API 密钥** 选项卡
4. 点击 **创建私有 API 密钥**
5. 将其命名为“Sesami Integration”（或类似名称）
6. 配置权限 - 选择以下内容：
   * **活动** - 允许下载报告、收件人列表
   * **联系人** - 允许创建、编辑、下载、删除订阅者
   * **订单** - 允许创建、编辑、下载、删除订单
   * **产品** - 允许创建、编辑、下载、删除产品
   * **购物车** - 允许创建、编辑、下载、删除购物车
   * **事件** - 允许获取并触发自定义事件（**必需**)
7. 复制生成的 API 密钥并妥善保存

{% hint style="warning" %}
**重要**：你需要为每一种独立的事件类型使用单独的 API 密钥（预约创建、改期、取消等）。
{% endhint %}

更多详情，请参阅 [Omnisend API 文档](https://api-docs.omnisend.com/).

#### 步骤 3：在 Omnisend 中创建自定义事件

对于你想跟踪的每种预约事件类型，创建一个自定义事件：

1. 在 Omnisend 中，前往 **商店设置 > 自定义事件**
2. 点击 **创建自定义事件**
3. 配置事件：
   * **事件名称**：选择一个描述性名称（例如“预约已创建”、“预约已改期”）
   * **系统名称**：这将根据事件名称自动生成
   * **事件自定义字段**：定义你想在电子邮件/SMS 中使用的预约属性：
     * `CustomerName` - 客户姓名
     * `ServiceName` - 所预订服务的名称
     * `DateTimeInCustomerTimezone` - 预约日期/时间
     * `CustomerManagementLink` - 客户管理预约的链接
     * `AppointmentID` - 预约唯一标识符
     * `TeamMember` - 分配的员工姓名
     * 按需添加其他字段
4. 添加客户 **电子邮件** 和 **电话** 字段（发送消息所必需）
5. 保存自定义事件
6. **复制事件 ID** - 你在 Sesami Flow webhook URL 中会用到它

{% hint style="info" %}
对你想跟踪的每种事件类型（创建、改期、取消、完成、提醒）重复此流程。
{% endhint %}

如需详细说明，请参阅 [Omnisend 的自定义事件文档](https://support.omnisend.com/en/articles/6791819-custom-events).

### 第 2 部分：配置 Sesami Flows

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

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

#### 步骤 2：配置 Flow 触发器

1. 选择你的触发事件：
   * 预约已创建
   * 预约已改期
   * 客户已签到
   * 预约已开始
   * 预约已取消
   * 未到场
2. 设置 **当** 为 **立即**，或设置为事件之前或之后的某个时间（例如预约前 24 小时发送提醒）
3. 如有需要，配置任何附加条件

#### 步骤 3：添加 Webhook 操作

1. 设置 **操作** 类型为 **Webhook**
2. 配置 webhook：
   * **目标 URL**: `https://api.omnisend.com/v3/events/[EVENT_ID]`
     * 将 `[EVENT_ID]` 替换为你从 Omnisend 复制的事件 ID
   * **当**：设置为“立即”（或为提醒配置时间）

#### 步骤 4：配置 webhook 标头

在 webhook 标头部分，添加：

```json
{
  "Content-Type": "application/json",
  "X-API-KEY": "YOUR_OMNISEND_API_KEY"
}
```

将 `YOUR_OMNISEND_API_KEY` 替换为你在 Omnisend 中创建的实际 API 密钥。

#### 步骤 5：配置 webhook 正文

在 webhook 正文部分，将 Sesami 预约数据映射到你的 Omnisend 自定义字段：

```json
{
  "fields": {
    "CustomerName": "{{CustomerName}}",
    "ServiceName": "{{ServiceName}}",
    "DateTimeInCustomerTimezone": "{{DateTimeInCustomerTimezone}}",
    "CustomerManagementLink": "{{CustomerManagementLink}}",
    "AppointmentID": "{{AppointmentID}}",
    "TeamMember": "{{TeamMember}}"
  },
  "email": "{{CustomerEmail}}",
  "phone": "{{CustomerPhone}}"
}
```

{% hint style="info" %}
在 `"fields"` 中的字段名称必须与你在 Omnisend 自定义事件中定义的自定义字段完全一致。
{% endhint %}

#### 步骤 6：保存并启用 Flow

1. 为你的 Flow 起一个描述性名称（例如“Omnisend - 预约已创建”）
2. **保存** 该 Flow
3. 启用 Flow

对你想发送到 Omnisend 的每种事件类型重复步骤 1-6。

### 第 3 部分：在 Omnisend 中创建工作流

#### 步骤 1：创建自定义工作流

1. 登录 **Omnisend**
2. 前往 **自动化 > 工作流**
3. 点击 **新工作流**
4. 选择 **创建自定义工作流**

#### 步骤 2：配置触发器

1. 对于触发器，选择你的自定义事件（例如“预约已创建”）
2. 每当 Sesami 向此事件发送数据时，工作流都会触发

#### 步骤 3：添加电子邮件或 SMS 操作

1. 点击 **添加操作** 在工作流中
2. 选择 **电子邮件** 或 **SMS**
3. 设计你的消息模板

#### 步骤 4：在模板中使用自定义字段

编辑电子邮件或 SMS 内容时，你可以使用自定义字段语法访问预约属性：

* `[[custom_event.CustomerName]]` - 客户姓名
* `[[custom_event.ServiceName]]` - 服务名称
* `[[custom_event.DateTimeInCustomerTimezone]]` - 预约日期/时间
* `[[custom_event.CustomerManagementLink]]` - 预约管理链接
* `[[custom_event.TeamMember]]` - 分配的团队成员

#### 步骤 5：配置其他工作流设置

1. 设置 **频率** 规则（例如，“不要为已进入过此自动化流程的联系人重新触发工作流”）
2. 添加 **退出条件** 如果需要
3. 配置任何时间延迟或条件分支

#### 步骤 6：激活工作流

当你设计并测试好工作流后，点击 **启用** 使其上线。

## 测试你的集成

在正式上线前，请测试集成：

1. 在 Sesami 中创建一个测试预约
2. 检查该事件是否出现在 Omnisend 的 **商店设置 > 自定义事件** （查看事件活动）
3. 验证所有预约属性是否正确填充
4. 测试你的 Omnisend 工作流，确保电子邮件/SMS 正常发送
5. 检查内容，确保所有自定义字段都正确显示

{% hint style="success" %}
**专业提示**：创建一个测试客户邮箱地址和电话号码，然后进行测试预约，以在为真实客户启用工作流之前验证完整的客户体验。
{% endhint %}

## 常见问题

<details>

<summary>每种事件类型都需要单独的 API 密钥吗？</summary>

是的，Omnisend 要求你为创建的每个自定义事件使用唯一的 API 密钥。这意味着如果你跟踪预约创建、改期和取消事件，你将需要三个独立的 API 密钥。

</details>

<details>

<summary>我可以同时使用 Omnisend 发送 SMS 和电子邮件吗？</summary>

可以！Omnisend 同时支持电子邮件和 SMS。请确保：

* 在你的 webhook 正文中包含 `电话` 字段
* 已在你的 Omnisend 账户中启用 SMS
* 已获得客户同意并收集了客户电话号码
* 在你的 Omnisend 工作流中配置 SMS 操作

更多详情，请参阅 [Omnisend 的 SMS 文档](https://support.omnisend.com/en/articles/1061873-sms-in-campaigns).

</details>

<details>

<summary>如果我需要多个提醒工作流怎么办？</summary>

你可以在 Sesami 中创建多个提醒 Flow，每个 Flow 的时间不同：

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

每个都可以发送到同一个 Omnisend 自定义事件，或者你也可以为不同的提醒时间创建单独的自定义事件。

</details>

<details>

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

* 确认你的 Omnisend API 密钥正确，并且已启用“事件”权限
* 确保 webhook URL 中的事件 ID 与你的自定义事件匹配
* 检查 Sesami 中的 Flow 是否已启用
* 确认你在设置 Flow 后已进行测试预约
* 查看 Sesami Flow 日志，确认 webhook 是否发送成功
* 检查 Omnisend 中的自定义事件活动（商店设置 > 自定义事件）
* 确保 webhook 正文中包含所有必需字段（电子邮件或电话）

</details>

<details>

<summary>我可以针对不同语言使用翻译吗？</summary>

可以！Omnisend 支持活动和自动邮件的翻译。你可以根据客户语言偏好创建本地化版本的工作流。请参阅 [Omnisend 的翻译文档](https://support.omnisend.com/en/articles/1061898-translations-for-campaigns-and-automated-emails).

</details>

## 相关

* [Sesami Flows](https://help.sesami.co/zh-cn/zi-dong-hua/sesami-flows.md) - Sesami 自动化系统概览
* [电子邮件和 Webhook 操作](https://help.sesami.co/zh-cn/zi-dong-hua/email-and-webhook-as-action-types.md) - 理解操作类型
* [Sesami Flows 和 Klaviyo](https://help.sesami.co/zh-cn/zi-dong-hua/sesami-flows-and-klaviyo.md) - 替代 ESP 集成
* [通知邮件](https://help.sesami.co/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 by asking a question.

Perform an HTTP GET request on the following URL with the `ask` and `goal` query parameters:

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

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is what the user is ultimately trying to achieve, the reason they need the answer. Sharing it helps GitBook give you a better, more relevant answer. A goal is most helpful when it describes the outcome the user wants rather than restating the question. For example, with `ask=how do I create an API token`, a goal like `automate deployments from our CI pipeline` lets GitBook tailor the answer to that use case.

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.
