# 快速入门

## 你将设置的内容

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

{% hint style="info" %}
**预计时间**：基础设置（一个服务和一名团队成员）需要 15-30 分钟。
{% endhint %}

## 开始之前

请确保你有：

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

***

{% stepper %}
{% step %}
**在 Shopify 中创建服务产品**

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

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

对你想提供的每种服务类型重复以上步骤。

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

{% 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-yuan/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 应用嵌入已启用** 在主题设置中（第 5 步）
2. **产品在 Shopify 中带有 sesami-service 标签** 在 Shopify 中
3. **Sesami 已启用** 在 Sesami 设置中
4. 你查看的是 **已发布主题** （不是草稿/未发布版本）
5. **服务已配置** 在 Sesami 中，并已链接产品

</details>

<details>

<summary>服务无法正常工作或显示错误</summary>

检查：

1. **产品已作为服务添加** 在 Sesami 中
2. **资源已分配** 到该服务（第 3 步）
3. **所需资源已启用** （未禁用）
4. **时长变体格式** 正确（例如，“30 Minutes”、“1 Hour”——无额外空格，英文）

</details>

<details>

<summary>未显示可用时间段</summary>

最常见的问题！检查：

1. **资源已分配** 到该服务（第 3 步）
2. **已设置可用性** 适用于已分配的资源（第 2 步）
3. **时区正确** 在 Sesami 设置中
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-yuan/resources.md) - 详细的资源配置
* [可用性设置](/zh-cn/yu-yue/availability/resource-availability.md) - 高级可用性选项
* [Sesami 管理门户](/zh-cn/guan-li-yuan/sesami-admin-portal.md) - 管理界面概览
* [服务配置](/zh-cn/guan-li-yuan/services.md) - 高级服务设置


---

# 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/kai-shi-shi-yong/quickstart.md?ask=<question>
```

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.