> 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/kai-shi-shi-yong/quickstart.md).

# 快速入门

## 你将设置的内容

* **服务** - 代表可预订服务的 Shopify 产品
* **资源** - 提供服务所需的团队成员、房间、设备或其他资产
* **可用性** - 资源的工作时间和排班规则
* **店面集成** - 在线商店中的预订按钮和日历

{% hint style="info" %}
**预计时间**：基础设置仅需 15-30 分钟，包含一项服务和一位团队成员。
{% endhint %}

### 开始之前 <a href="#before-you-start" id="before-you-start"></a>

请确保你已具备：

* **管理员访问权限** 在你的 Shopify 商店中
* **一份服务列表** 你想提供的：
  * 服务名称（例如“60 分钟按摩”“宠物美容”）
  * 时长（例如 30 分钟、1 小时、2 小时）
  * 价格
* **资源信息**:
  * 团队成员姓名及其工作时间
  * 房间或设备要求（如适用）

<figure><img src="/files/cb174c23642c75f1e978a6c25db96203078d21f7" alt=""><figcaption></figcaption></figure>

{% stepper %}
{% step %}

### **将服务添加到 Sesami**

**你可以直接在 Sesami 中创建服务，或从 Shopify 添加现有产品。**

#### **- 在 Sesami 中**&#x20;

1. 输入一个清晰的 **标题** （例如“理发”“按摩”“咨询”）

   保持标题简洁——它会显示在预订确认和日历中
2. 添加 **描述**
3. 添加 **变体“时长”、单位，** 以及 **价格**\
   创建如“30 分钟”“1 小时”“90 分钟”的变体
4. 点击以 **创建服务**

<figure><img src="/files/0319cfefb3140bd18c1a231289cbe24a7290603f" alt=""><figcaption></figcaption></figure>

#### **- 在 Shopify 中**

1. 在你的 Shopify 管理后台中，前往 **产品 > 添加产品**
2. 输入一个清晰的产品标题来描述该服务，例如 *理发*, *按摩*，或 *咨询*
3. 点击 **添加变体** 并创建“**时长”变体** 及其选项，例如 *30 分钟*, *1 小时*，或 *90 分钟*
4. 为每个时长选项设置价格
5. 点击 **保存** 以创建产品

<figure><img src="/files/2c2069cc713dfe4c4d0c1367e2766039d17ec778" alt=""><figcaption></figcaption></figure>

对你想提供的每种服务重复此操作。

{% hint style="success" %}
**最佳实践**：使用变体来表示同一服务的不同持续时间。例如，一个名为“按摩”的产品，包含“30 分钟”“1 小时”和“90 分钟”变体，而不是三个单独的产品。
{% endhint %}
{% endstep %}

{% step %}

### **创建资源并设置可用性**

资源是你的服务得以进行所需的内容——团队成员、房间、设备等。你将创建它们并设置其可用性。

{% hint style="info" %}
**注意**：在当前的 Shopify 管理界面中，资源被标记为“团队成员”。这将在即将发布的版本中更新为“资源”。
{% endhint %}

1. 添加 **资源** 名称和 **资源类型**
   * 对于员工：按姓名添加每位团队成员（例如“Sarah”“Alex”“Jamie”）
   * 对于房间/设备：暂时将它们作为团队成员添加（例如“房间 1”“摄像设备套装 A”）
2. 设置其 **工作时间** 并添加可用性规则（例如周一至周五，上午 9:00 - 下午 5:00）
3. **点击以创建资源**&#x20;

**设置示例：**

* 团队成员“Sarah”→ 周一至周五可用，上午 9 点 - 下午 5 点
* 房间“治疗室 1”→ 周一至周六可用，上午 8 点 - 晚上 8 点

{% hint style="info" %}
**补充说明：** 如果你还没有配置好所有资源，也不用担心。你可以现在先为一个资源设置可用性，然后在后续的 [**管理门户：资源**](/zh-cn/guan-li/resources.md).
{% endhint %}

<figure><img src="/files/7dd6dd802d2286f3d6f108d326ce52f17ac0542f" alt=""><figcaption></figcaption></figure>
{% endstep %}

{% step %}

### **在你的店面添加预订**

让在线商店中的客户能够访问预订日历

<figure><img src="/files/0ef1cd44170a3ade8cba0661a2608e8ce65bc480" alt=""><figcaption></figcaption></figure>

**主题应用嵌入（推荐 - 现代主题） - 大多数 Shopify 2.0 主题都支持应用嵌入**

{% hint style="info" %}
**可选：** 如果你使用的是较旧的 Shopify 主题、无头店面（如 Hydrogen）或自定义网站，可以跳过此步骤，并参考我们的 [开发文档](https://sesami.dev/docs/sesami-experience/shopify-integration/intro/) 获取集成说明。
{% endhint %}

#### **步骤 1：启用应用嵌入**

1. 在 Sesami 仪表板中，点击 **自定义主题** 中的 **嵌入预订体验** 部分。
2. 它将打开主题编辑器，并显示 **应用嵌入** 面板（通常位于左侧边栏或主题设置中）
3. 找到 **Sesami Booking App** 并打开切换开关，以启用将应用嵌入到你的主题中。
4. **保存**

<div><figure><img src="/files/547c063c0982fb41af4005e7d5a709c94e467779" alt=""><figcaption></figcaption></figure> <figure><img src="/files/cec972ee0c29f05272390e7be7f745313c3b5fdf" alt=""><figcaption></figcaption></figure></div>

#### **步骤 2：添加到产品**

1. 接下来，打开一个产品模板，将 Sesami 预订区块添加到你的产品模板中
2. 在 **产品信息** 部分，点击 **添加区块** 并选择 **Sesami 预订按钮**
3. 将该区块放在购买按钮上方
4. **保存** 你的主题更改。

现在，预订小组件将显示在你店面的产品页面上，让客户选择可用的预订时间。

<div><figure><img src="/files/225919c43b15c0cb31393e38380283ca57e75495" alt=""><figcaption></figcaption></figure> <figure><img src="/files/a9b35c13c99862358b21cf25d44af895109dcdf9" alt=""><figcaption></figcaption></figure></div>

{% hint style="info" %}
**手动集成（旧主题）**

对于不支持应用嵌入的旧主题：

1. 在主题编辑器中，为产品页面添加一个按钮或链接
2. 链接到启用了 Sesami 日历的产品页面
3. 或者联系支持团队以获取针对主题的集成帮助

参见： [Shopify 在线商店设置](/zh-cn/apps-integrations/shopify/online-store.md)
{% endhint %}

{% hint style="success" %}
**专业提示**：在主菜单中添加一个“立即预订”导航链接，指向所有可预订服务的集合。
{% endhint %}
{% endstep %}

{% step %}
**端到端测试**

上线前，请测试完整的预订流程：

1. **打开你的商店** 在隐身/私人浏览器窗口中（以查看客户视图）
2. **进入某个服务产品页面**
3. **检查是否显示预订日历** 及可用时间段
4. **选择日期和时间**
5. **加入购物车** 并继续完成结账
6. **完成购买** （使用 Shopify 的测试模式或进行真实预订）
7. **确认预订是否显示** 在 Sesami 管理后台的“预订”中
8. **在移动设备上检查** - 在移动设备上测试相同流程

**需要确认的内容：**

* 可用时间段与资源可用性一致
* 显示了正确的时区
* 预订已分配到正确的资源
* 如果你预订多个预约，时间不会重叠

{% hint style="warning" %}
**如果没有显示时间段**，请参见下面的故障排除部分。
{% endhint %}
{% endstep %}
{% endstepper %}

***

## 故障排除

<details>

<summary>产品页面上没有显示日历</summary>

检查：

1. **Sesami 应用嵌入已启用** 在主题设置中
2. **产品在 Shopify 中带有 sesami-service 标签** 在 Shopify 中
3. **Sesami 已启用** 在 Sesami 设置中
4. 你正在查看 **已发布主题** （不是草稿/未发布版本）
5. **服务已配置** 在 Sesami 中并已链接产品

</details>

<details>

<summary>服务无法使用或显示错误</summary>

检查：

1. **该产品已在 Sesami 中添加为服务** 在 Sesami 中
2. **已分配资源** 给该服务
3. **所需资源已启用** （未禁用）
4. **时长变体格式** 正确（例如“30 分钟”“1 小时”——没有多余空格，且为英文）

</details>

<details>

<summary>没有显示可用时间段</summary>

最常见的问题！检查：

1. **已分配资源** 到该服务（步骤 2）
2. **可用性已设置** 针对已分配资源（步骤 2）
3. **预订窗口** 允许未来预订（检查高级设置）
4. **没有阻止规则** 覆盖了所有可用日期
5. **产品页面上的购买按钮已隐藏或移除**

参见： [无可用性](/zh-cn/kai-shi-shi-yong/onboarding/troubleshooting/no-availability.md)

</details>

<details>

<summary>时区看起来不对</summary>

1. 前往 **Sesami > 设置 > 时区**
2. 确认你商店的时区与实际位置一致
3. 检查资源可用性是否设置在正确的时区
4. 清除浏览器缓存并在隐身模式下测试

参见： [时区不匹配](/zh-cn/kai-shi-shi-yong/onboarding/troubleshooting/timezone-mismatch.md)

</details>

<details>

<summary>结账行为异常</summary>

如果你预期跳过结账，但它没有跳过（或相反）：

1. 检查是否 **即时预订** 已启用（会跳过结账）
2. 确认 **定金设置** （可能会更改结账流程）
3. 查看产品 **定价** （免费产品可能会跳过结账）

参见： [即时预订](/zh-cn/yu-yue/booking-features/instant-booking.md) | [定金](/zh-cn/zhi-fu/deposits.md)

</details>

<details>

<summary>预订显示“分配给：无人”</summary>

当结账过程中时间段变为不可用时就会发生这种情况：

1. 启用 **保留期** 在 Sesami 设置中
2. 启用 **购物车验证** 在结账前检查可用性

参见： [“分配给无人”故障排除](/zh-cn/kai-shi-shi-yong/onboarding/troubleshooting/troubleshooting-assigned-to-no-one-caused-by-invalid-order.md)

</details>

<details>

<summary>客户看到“会话已过期”或“无效链接”错误</summary>

常见原因：

1. **链接已过期** - 客户在截止时间后尝试重新安排/取消
2. **浏览器 Cookie 被阻止** - 检查浏览器设置，尤其是 Safari
3. **缓存问题** - 清除浏览器缓存后重试

参见： [会话已过期](/zh-cn/kai-shi-shi-yong/onboarding/troubleshooting/session-expired.md) | [Safari Cookie](/zh-cn/kai-shi-shi-yong/onboarding/troubleshooting/safari-cookies.md) | [无效链接错误](/zh-cn/kai-shi-shi-yong/onboarding/troubleshooting/as-a-customer-why-am-i-seeing-an-invalid-link-error-page.md)

</details>

***

## 下一步

一旦基本预订功能正常运行，可以考虑：

* [**电子邮件通知**](/zh-cn/tong-zhi/notification-emails.md) - 设置确认和提醒邮件
* [**Google 日历同步**](/zh-cn/apps-integrations/google-calendar.md) - 与团队成员日历双向同步
* [**客户改期**](/zh-cn/yu-yue/booking-features/cancellations-rescheduling.md) - 允许客户重新安排或取消
* [**团体预约**](/zh-cn/yu-yue/booking-features/group-appointments.md) - 启用同一时间段的多笔预订
* [**定金**](/zh-cn/zhi-fu/deposits.md) - 在预订时收取部分付款
* [**销售点**](/zh-cn/apps-integrations/shopify/pos.md) - 现场接单预订

***

## 需要帮助？

* [**免费入门指导电话**](/zh-cn/kai-shi-shi-yong/onboarding/onboarding-call.md) - 与我们的客户成功团队预约一次会议
* [**白手套设置服务**](/zh-cn/kai-shi-shi-yong/onboarding/white-glove-setup.md) - 获得主题集成和设置方面的专业帮助
* [**专业服务**](/zh-cn/kai-shi-shi-yong/onboarding/professional-services.md) - 针对独特需求进行定制开发
* [**支持**](mailto:help@sesami.co) - 发送邮件至 <help@sesami.co> 获取帮助

## 相关

* [资源指南](/zh-cn/guan-li/resources.md) - 详细的资源配置
* [可用性设置](/zh-cn/yu-yue/availability/resource-availability.md) - 高级可用性选项
* [Sesami 管理门户](/zh-cn/guan-li/sesami-admin-portal.md) - 管理界面概览
* [服务配置](/zh-cn/guan-li/services.md) - 高级服务设置

**在 Shopify 中创建服务产品**

为每个可预订服务创建一个 Shopify 产品：

1. 在 Shopify 管理后台中，前往 **产品 > 添加产品**
2. 输入一个清晰的 **产品标题** 不包含时长（例如“理发”“按摩”“咨询”）
   * 保持标题简洁——它会显示在预订确认和日历中
3. 添加 **不同持续时间的变体**:
   * 点击 **添加变体**
   * 创建如“30 分钟”“1 小时”“90 分钟”的变体
   * 为每个时长变体设置价格
4. 根据需要添加描述、图片和其他产品详情
5. **保存** 该产品

对你想提供的每种服务重复此操作。

{% hint style="success" %}
**最佳实践**：使用变体来表示同一服务的不同持续时间。例如，一个名为“按摩”的产品，包含“30 分钟”“1 小时”和“90 分钟”变体，而不是三个单独的产品。
{% endhint %}

{% stepper %}
{% step %}
**创建资源并设置可用性**

资源是你的服务得以进行所需的内容——团队成员、房间、设备等。你将创建它们并设置其可用性。

{% hint style="info" %}
**注意**：在当前的 Shopify 管理界面中，资源被标记为“团队成员”。这将在即将发布的版本中更新为“资源”。
{% endhint %}

1. 打开 **Sesami** 在你的 Shopify 管理后台中
2. 导航到 **团队成员** （资源）
3. 点击 **添加团队成员** 并创建你的资源：
   * 对于员工：按姓名添加每位团队成员（例如“Sarah”“Alex”“Jamie”）
   * 对于房间/设备：暂时将它们作为团队成员添加（例如“房间 1”“摄像设备套装 A”）
4. 为每个资源设置其 **可用性**:
   * 点击资源名称
   * 前往 **可用性** 选项卡
   * 添加可用性规则（例如周一至周五，上午 9:00 - 下午 5:00）
   * **保存** 日程

**设置示例：**

* 团队成员“Sarah”→ 周一至周五可用，上午 9 点 - 下午 5 点
* 房间“治疗室 1”→ 周一至周六可用，上午 8 点 - 晚上 8 点

参见： [资源指南](/zh-cn/guan-li/resources.md) | [可用性设置](/zh-cn/yu-yue/availability/resource-availability.md)
{% endstep %}

{% step %}
**将服务链接到资源**

告诉 Sesami 每项服务需要哪些资源：

1. 打开 **Sesami** 在你的 Shopify 管理后台中
2. 导航到 **服务**
3. 选择一个服务产品
4. 前往 **资源** 部分
5. 选择所需的资源类型：
   * 选择 **团队成员** 如果服务需要员工
   * 选择 **房间** 如果服务需要一个物理空间
   * 选择 **设备** 如果需要特定工具
6. 可选地，分配特定资源：
   * 勾选 **仅特定资源** 以将该服务限制给某些团队成员或房间
   * 取消勾选则允许该类型的任何可用资源
7. **保存**

**配置示例：**

* **理发**：需要“造型师”（任何造型师都可执行）
* **面部护理**：需要“美容师” + “护理室”（两者都需要）
* **私人训练**：仅需要特定资源“私人教练 - Sarah”

{% hint style="warning" %}
**常见错误**：如果你没有链接任何资源，就不会显示任何可用时间段！每项服务至少必须分配一种资源类型。
{% endhint %}
{% endstep %}

{% step %}
**在你的店面添加预订**

让在线商店中的客户能够访问预订日历：

**选项 1：主题应用嵌入（推荐 - 现代主题）**

大多数 Shopify 2.0 主题都支持应用嵌入：

1. 在 Shopify 管理后台中，前往 **在线商店 > 主题**
2. 点击 **自定义** 在你当前启用的主题上
3. 点击 **应用嵌入** （通常在左侧边栏或主题设置中）
4. 启用 **Sesami** 应用嵌入
5. **保存**

预订日历现在将自动显示在您的服务产品页面上。

{% hint style="warning" %}
**重要提示：** “购买按钮”无法在产品模板中隐藏或移除。\
显示日历上的预订可用性需要“购买按钮”。\
如果您不希望向客户显示“购买按钮”，可以启用“自动加入购物车 / 跳过购物车”选项。这样会从预订流程中移除该按钮。
{% endhint %}

**选项 2：手动集成（旧版主题）**

对于不支持应用嵌入的旧主题：

1. 在主题编辑器中，为产品页面添加一个按钮或链接
2. 链接到启用了 Sesami 日历的产品页面
3. 或者联系支持团队以获取针对主题的集成帮助

参见： [Shopify 在线商店设置](/zh-cn/apps-integrations/shopify/online-store.md)

{% hint style="success" %}
**专业提示**：在主菜单中添加一个“立即预订”导航链接，指向所有可预订服务的集合。
{% endhint %}
{% endstep %}

{% step %}
**端到端测试**

上线前，请测试完整的预订流程：

1. **打开你的商店** 在隐身/私人浏览器窗口中（以查看客户视图）
2. **进入某个服务产品页面**
3. **检查是否显示预订日历** 及可用时间段
4. **选择日期和时间**
5. **加入购物车** 并继续完成结账
6. **完成购买** （使用 Shopify 的测试模式或进行真实预订）
7. **确认预订是否显示** 在 Sesami 管理后台的“预订”中
8. **在移动设备上检查** - 在移动设备上测试相同流程

**需要确认的内容：**

* 可用时间段与资源可用性一致
* 已显示正确的时区
* 预订已分配到正确的资源
* 如果你预订多个预约，时间不会重叠

{% hint style="warning" %}
**如果没有显示时间段**，请参见下面的故障排除部分。
{% endhint %}
{% endstep %}
{% endstepper %}

***

## 故障排除

<details>

<summary>产品页面上没有显示日历</summary>

检查：

1. **Sesami 应用嵌入已启用** 在主题设置中
2. **产品在 Shopify 中带有 sesami-service 标签** 在 Shopify 中
3. **Sesami 已启用** 在 Sesami 设置中
4. 你正在查看 **已发布主题** （不是草稿/未发布版本）
5. **服务已配置** 在 Sesami 中并已链接产品

</details>

<details>

<summary>服务无法使用或显示错误</summary>

检查：

1. **该产品已在 Sesami 中添加为服务** 在 Sesami 中
2. **已分配资源** 给该服务
3. **所需资源已启用** （未禁用）
4. **时长变体格式** 正确（例如“30 分钟”“1 小时”——没有多余空格，且为英文）

</details>

<details>

<summary>没有显示可用时间段</summary>

最常见的问题！检查：

1. **已分配资源** 到该服务（步骤 2）
2. **可用性已设置** 针对已分配资源（步骤 2）
3. **预订窗口** 允许未来预订（检查高级设置）
4. **没有阻止规则** 覆盖了所有可用日期
5. **产品页面上的购买按钮已隐藏或移除**

参见： [无可用性](/zh-cn/kai-shi-shi-yong/onboarding/troubleshooting/no-availability.md)

</details>

<details>

<summary>时区看起来不对</summary>

1. 前往 **Sesami > 设置 > 时区**
2. 确认你商店的时区与实际位置一致
3. 检查资源可用性是否设置在正确的时区
4. 清除浏览器缓存并在隐身模式下测试

参见： [时区不匹配](/zh-cn/kai-shi-shi-yong/onboarding/troubleshooting/timezone-mismatch.md)

</details>

<details>

<summary>结账行为异常</summary>

如果你预期跳过结账，但它没有跳过（或相反）：

1. 检查是否 **即时预订** 已启用（会跳过结账）
2. 确认 **定金设置** （可能会更改结账流程）
3. 查看产品 **定价** （免费产品可能会跳过结账）

参见： [即时预订](/zh-cn/yu-yue/booking-features/instant-booking.md) | [定金](/zh-cn/zhi-fu/deposits.md)

</details>

<details>

<summary>预订显示“分配给：无人”</summary>

当结账过程中时间段变为不可用时就会发生这种情况：

1. 启用 **保留期** 在 Sesami 设置中
2. 启用 **购物车验证** 在结账前检查可用性

参见： [“分配给无人”故障排除](/zh-cn/kai-shi-shi-yong/onboarding/troubleshooting/troubleshooting-assigned-to-no-one-caused-by-invalid-order.md)

</details>

<details>

<summary>客户看到“会话已过期”或“无效链接”错误</summary>

常见原因：

1. **链接已过期** - 客户在截止时间后尝试重新安排/取消
2. **浏览器 Cookie 被阻止** - 检查浏览器设置，尤其是 Safari
3. **缓存问题** - 清除浏览器缓存后重试

参见： [会话已过期](/zh-cn/kai-shi-shi-yong/onboarding/troubleshooting/session-expired.md) | [Safari Cookie](/zh-cn/kai-shi-shi-yong/onboarding/troubleshooting/safari-cookies.md) | [无效链接错误](/zh-cn/kai-shi-shi-yong/onboarding/troubleshooting/as-a-customer-why-am-i-seeing-an-invalid-link-error-page.md)

</details>

***

## 下一步

一旦基本预订功能正常运行，可以考虑：

* [**电子邮件通知**](/zh-cn/tong-zhi/notification-emails.md) - 设置确认和提醒邮件
* [**Google 日历同步**](/zh-cn/apps-integrations/google-calendar.md) - 与团队成员日历双向同步
* [**客户改期**](/zh-cn/yu-yue/booking-features/cancellations-rescheduling.md) - 允许客户重新安排或取消
* [**团体预约**](/zh-cn/yu-yue/booking-features/group-appointments.md) - 启用同一时间段的多笔预订
* [**定金**](/zh-cn/zhi-fu/deposits.md) - 在预订时收取部分付款
* [**销售点**](/zh-cn/apps-integrations/shopify/pos.md) - 现场接单预订

***

## 需要帮助？

* [**免费入门指导电话**](/zh-cn/kai-shi-shi-yong/onboarding/onboarding-call.md) - 与我们的客户成功团队预约一次会议
* [**白手套设置服务**](/zh-cn/kai-shi-shi-yong/onboarding/white-glove-setup.md) - 获得主题集成和设置方面的专业帮助
* [**专业服务**](/zh-cn/kai-shi-shi-yong/onboarding/professional-services.md) - 针对独特需求进行定制开发
* [**支持**](mailto:help@sesami.co) - 发送邮件至 <help@sesami.co> 获取帮助

## 相关

* [资源指南](/zh-cn/guan-li/resources.md) - 详细的资源配置
* [可用性设置](/zh-cn/yu-yue/availability/resource-availability.md) - 高级可用性选项
* [Sesami 管理门户](/zh-cn/guan-li/sesami-admin-portal.md) - 管理界面概览
* [服务配置](/zh-cn/guan-li/services.md) - 高级服务设置


---

# 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/kai-shi-shi-yong/quickstart.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.