> 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="https://1798155128-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FnDgiM1CWSLWRIbhORANO%2Fuploads%2FPOzJuZclHQ9ht21ebfhi%2FScreenshot%202026-05-19%20at%2012.32.43.png?alt=media&amp;token=0af2ba25-c752-4d94-9321-5c521e556175" alt=""><figcaption></figcaption></figure>

{% stepper %}
{% step %}

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

**你可以直接在 Sesami 中创建服务，也可以添加 Shopify 中已有的商品。**

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

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

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

<figure><img src="https://1798155128-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FnDgiM1CWSLWRIbhORANO%2Fuploads%2Fi8WFIIRFXECjiCk8G2oT%2FScreenshot%202026-05-19%20at%2013.37.41.png?alt=media&amp;token=51871ee8-eaea-4c5d-a8ae-0420dc556a38" alt=""><figcaption></figcaption></figure>

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

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

<figure><img src="https://1798155128-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FnDgiM1CWSLWRIbhORANO%2Fuploads%2FKoVL1Uvm6QHvzAJEzmoD%2FScreenshot%202026-05-19%20at%2013.35.29.png?alt=media&amp;token=25c95196-9a90-4b96-83a1-e8a21369ed4c" 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" %}
**须知：** 如果您还没有配置所有资源，也不必担心。您可以先为单个资源设置可用时间，稍后再创建其他资源，或更新现有资源的可用时间，操作入口位于 [**管理门户：资源**](https://help.sesami.co/zh-cn/guan-li/resources.md).
{% endhint %}

<figure><img src="https://1798155128-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FnDgiM1CWSLWRIbhORANO%2Fuploads%2FrRx0NMMOiOSmrfHMOggl%2FScreenshot%202026-05-19%20at%2017.08.58.png?alt=media&amp;token=53d42e8e-0196-4123-9c44-f93882601844" alt=""><figcaption></figcaption></figure>
{% endstep %}

{% step %}

### **将预约功能添加到您的店面**

让顾客能够通过您的在线商店访问预约日历

<figure><img src="https://1798155128-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FnDgiM1CWSLWRIbhORANO%2Fuploads%2F3izuy705a4B12sMY4pp8%2FScreenshot%202026-05-22%20at%2011.34.45.png?alt=media&amp;token=1bfc3440-9cf9-4385-b396-c45110428933" 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 预约应用** 并打开此开关，以便在主题中嵌入该应用。
4. **保存**

<div><figure><img src="https://1798155128-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FnDgiM1CWSLWRIbhORANO%2Fuploads%2F5IZDWEsFIoEA1zsWNOIA%2FScreenshot%202026-05-22%20at%2011.34.56.png?alt=media&amp;token=9e65bd06-2cc0-4e10-8d22-8068100088ce" alt=""><figcaption></figcaption></figure> <figure><img src="https://1798155128-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FnDgiM1CWSLWRIbhORANO%2Fuploads%2FJaRozYLGOsgaXbP4n4Wv%2FScreenshot%202026-05-22%20at%2012.30.06.png?alt=media&amp;token=40d823c3-e4a9-45e5-b40b-8ebbe9bddb91" alt=""><figcaption></figcaption></figure></div>

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

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

现在，预约小组件会显示在店面的产品页面上，方便客户选择可预约时段。

<div><figure><img src="https://1798155128-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FnDgiM1CWSLWRIbhORANO%2Fuploads%2F9vxmbQjJF6Do7CZirEZn%2FScreenshot%202026-05-22%20at%2011.36.23.png?alt=media&amp;token=fe4f7d85-dc75-4ee1-a6cf-f1ed32b66261" alt=""><figcaption></figcaption></figure> <figure><img src="https://1798155128-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FnDgiM1CWSLWRIbhORANO%2Fuploads%2FqkGvhl600ImCpipWkDfQ%2FScreenshot%202026-05-22%20at%2012.30.33.png?alt=media&amp;token=48acdafc-5195-4376-b7f5-6c8e41046668" alt=""><figcaption></figcaption></figure></div>

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

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

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

请参阅： [Shopify 在线商店设置](https://help.sesami.co/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. **产品带有 sesami-service 标签** （在 Shopify 中）
3. **Sesami 已启用** （在 Sesami 设置中）
4. 您正在查看 **已发布的主题** （而不是草稿或未发布的版本）
5. **服务已配置** ，并在 Sesami 中关联了产品

</details>

<details>

<summary>服务无法正常运行或显示错误</summary>

请检查：

1. **产品已添加为服务** （在 Sesami 中）
2. **资源已分配** 给该服务
3. **所需资源已启用** （未被禁用）
4. **时长变体格式** 正确（例如“30 Minutes”、“1 Hour”——使用英文，不含多余空格）
5. **“Product does not have a Duration option”——** 时长变体必须使用英文，且不得有拼写错误。

</details>

<details>

<summary>没有显示可预约的时间段</summary>

这是最常见的问题！请检查：

1. **资源已分配** 给该服务（步骤 2）
2. **已设置可用时间** （针对已分配的资源，步骤 2）
3. **预约时间范围** 允许预约未来的时间（请检查高级设置）
4. **没有屏蔽时间** 覆盖所有可用日期
5. **产品页面上的购买按钮已隐藏或移除**

参见： [没有可用时间](https://help.sesami.co/zh-cn/kai-shi-shi-yong/onboarding/troubleshooting/no-availability.md)

</details>

<details>

<summary>错误：“Something went wrong. Please reload the page and try again”</summary>

使用时长变体时，选项名称必须完全为 **`Duration`** ，使用英文，不得有拼写错误、额外单词、翻译或前后空格。

Sesami 使用此关键词识别预约时长。如果配置不正确，预约流程可能无法按预期运行。\
\
*\*Duration 可以在之后翻译。*

<figure><img src="https://1798155128-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FnDgiM1CWSLWRIbhORANO%2Fuploads%2Fx6BZKDk5nIQ8cNHvE58z%2FScreenshot%202026-11-13%20at%2013.03.52.png?alt=media&amp;token=6ef86b60-4eed-4c8d-95d3-f0a7db0be081" alt=""><figcaption></figcaption></figure>

</details>

<details>

<summary>时区看起来不正确</summary>

1. 前往 **Sesami > 设置 > 时区**
2. 确认店铺的时区与您的实际所在地一致
3. 检查资源的可用时间是否使用正确的时区设置
4. 清除浏览器缓存并在无痕模式下测试

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

</details>

<details>

<summary>结账行为与预期不符</summary>

如果结账流程未按预期跳过（或反之）：

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

请参阅： [即时预约](https://help.sesami.co/zh-cn/yu-ding/booking-features/instant-booking.md) | [订金](https://help.sesami.co/zh-cn/fu-kuan/deposits.md)

</details>

<details>

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

如果时段在结账期间变为不可用，就会出现这种情况：

1. 启用 **预订时段** （位于 Sesami 设置中）
2. 启用 **购物车验证** 以便在结账前检查可用性

请参阅： [“分配给：无人”问题排查](https://help.sesami.co/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. **缓存问题** - 清除浏览器缓存后重试

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

</details>

***

## 后续步骤

基本预约功能正常运行后，可以考虑：

* [**电子邮件通知**](https://help.sesami.co/zh-cn/tong-zhi/notification-emails.md) - 设置确认邮件和提醒邮件
* [**Google 日历同步**](https://help.sesami.co/zh-cn/apps-integrations/google-calendar.md) - 与团队成员的日历进行双向同步
* [**客户改期**](https://help.sesami.co/zh-cn/yu-ding/booking-features/cancellations-rescheduling.md) - 允许客户改期或取消
* [**团体预约**](https://help.sesami.co/zh-cn/yu-ding/booking-features/group-appointments.md) - 允许每个时段接受多个预约
* [**订金**](https://help.sesami.co/zh-cn/fu-kuan/deposits.md) - 预约时收取部分款项
* [**销售点**](https://help.sesami.co/zh-cn/apps-integrations/shopify/pos.md) - 现场接受预约

***

## 需要帮助？

* [**免费入门咨询**](https://help.sesami.co/zh-cn/kai-shi-shi-yong/onboarding/onboarding-call.md) - 预约与客户成功团队的咨询
* [**全程无忧设置服务**](https://help.sesami.co/zh-cn/kai-shi-shi-yong/onboarding/white-glove-setup.md) - 获取主题集成和设置方面的专业帮助
* [**专业服务**](https://help.sesami.co/zh-cn/kai-shi-shi-yong/onboarding/professional-services.md) - 针对独特需求进行定制开发
* [**支持**](mailto:help@sesami.co) - 如需帮助，请发送邮件至 <help@sesami.co>

## 相关内容

* [资源指南](https://help.sesami.co/zh-cn/guan-li/resources.md) - 详细的资源配置说明
* [可用性设置](https://help.sesami.co/zh-cn/yu-ding/availability/resource-availability.md) - 高级可用性选项
* [Sesami 管理门户](https://help.sesami.co/zh-cn/guan-li/sesami-admin-portal.md) - 管理界面概览
* [服务配置](https://help.sesami.co/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 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/kai-shi-shi-yong/quickstart.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.
