
# Trafft

> **这是为谁准备的？** 此集成适用于已经在 Trafft 中管理日程的预约类业务——如沙龙、理发店、诊所、工作室、咨询公司和维修店。如果您不使用 Trafft，可以跳过此页面。
>
> 使用的是其他预约系统？任何带有 API 的系统都可以连接：请参阅 [连接未列出的工具](connecting-other-tools.md)，其中涵盖了自定义函数、API 和 Webhook。

Trafft 是一个为销售时间服务的企业提供的预约平台：您可以设置服务、员工和地点，客户则进行预约。将 Trafft 连接到 <span data-t="appName">Your AI Connector</span> 后，您的 AI 智能体可以在聊天中直接处理整个预约流程——查看真实的空闲时间、进行预订并确认时间——而无需将客户引导至预约链接并祈祷他们完成操作。

---

## Trafft 的功能

Trafft 为预约类业务提供：

- 具有各自时长和价格的服务
- 具有各自工作时间的员工
- 一个或多个地点
- 一个供您的团队使用的预约网站和日历

通过将 Trafft 连接到 <span data-t="appName">Your AI Connector</span>，同样的日程安排将成为您的 AI 在 WhatsApp、短信、Instagram 或网站聊天中可以调用的资源。AI 会读取您的服务和员工信息，在 Trafft 中查询真实的空闲时段，并将预约直接写入 Trafft——因此您的团队在 Trafft 中看到的内容始终是准确的。

---

## 连接 Trafft

> **开始之前：** 您需要 Trafft 的 API 访问权限，这是 Trafft 商业计划（Business plan）的一部分。打开您的 Trafft 管理面板，找到 **Features & Integrations（功能与集成） → API & Connectors（API 与连接器）**。如果该页面不存在，说明您的 Trafft 计划尚未包含此功能，因此无法建立连接。

1. 在左侧边栏中，点击 **Settings（设置）**（齿轮图标）。
2. 在“设置”侧边栏的 **Integrations（集成）** 组下，点击 **Booking & Calendar（预约与日历）**。
3. 找到 **Trafft** 卡片并点击 **Connect（连接）**。


4. 填写**公司地址**。这是您登录地址中 `.admin.trafft.com` 前面的部分——如果您在 `acme.admin.trafft.com` 登录，请输入 `acme`。粘贴完整地址也可以；我们会自动提取其中的正确部分。**白标 Trafft 账户？** 如果您的 Trafft 地址以 `.admin.wlbookings.com` 结尾（这是 Trafft 为代理商白标计划创建的账户提供的地址），请粘贴完整地址，例如 `acme.admin.wlbookings.com` ——这能告诉我们您的 Trafft 所在位置。仅输入 `acme` 会导致系统在标准 Trafft 地址上查找，而那是另一个账户。
5. 填写您的 **Client ID** 和 **Client Secret**。两者均可在您的 Trafft 管理面板的 **Features & Integrations → API & Connectors** 下找到。
6. （可选）添加一个**标签**——为您自己的列表命名，如果您管理多家企业，这会非常方便。
7. 点击 **Connect**。


### 凭据检查

在 Trafft 确认之前，不会保存任何内容。当您点击 **Connect（连接）** 时，我们会使用您输入的信息登录 Trafft 并读取您的设置。如果公司地址、客户端 ID 或密钥错误，或者 Trafft 计划没有 API 访问权限，系统会立即拒绝连接并在屏幕上显示原因——这样您就不会遇到那种看起来连接正常，但在客户第一次预约时却失败的情况。

当连接成功时，已连接的行会显示您的公司地址，以及我们在 Trafft 中找到的**服务**和**员工**数量。该计数是确认已连接正确账户的凭证：如果它显示两项服务而您实际提供二十项，说明您连接错了账户。

您的客户端密钥（Client Secret）已加密存储，且不会再次显示——无论是对您还是对您的团队。丢失了？请在 Trafft 中生成一个新的并重新连接。

### 暂停或断开连接

已连接的 Trafft 行在“预约与日历”（Booking & Calendar）页面上有其专属按钮：


- **刷新**：再次从 Trafft 读取您的服务和员工数量（请参阅[稍后添加或更改服务](#adding-or-changing-services-later)）。
- **暂停**：停止您的 AI 预订到 Trafft，同时保留连接设置。**激活**可将其重新开启。在您重新组织服务或在闭店期间使用此功能。
- **暂停**：完全移除连接。已存在于 Trafft 中的预约将保持原样——断开连接绝不会取消或删除您 Trafft 日历中的任何内容。您可以稍后使用相同的详细信息重新连接。

---

## 指示您的 AI 智能体使用 Trafft 进行预约

连接 Trafft 尚不会改变 AI 的行为。请将智能体指向它：

1. 在侧边栏点击 **AI 智能体**（AI Agents）并打开该智能体。
2. 进入 **AI 能力**（AI Abilities）步骤，找到 **预约**（Bookings）卡片。
3. 开启 **允许此智能体预约**（Let this agent book appointments）。
4. 点击服务提供商选择器并选择 **Trafft**（提供商选项会出现在开关下方）。
5. 点击 **保存更改**（Save changes）。


---

## AI 能做什么

选择 Trafft 作为提供商后，您的智能体可以在正常对话中完成以下所有操作：

- **告知人们您提供的服务。** 它会列出您的 Trafft 服务、每项服务所需时长及费用，并能说出您的员工姓名。
- **检查实际空闲时间。** 它会向 Trafft 查询某项服务所需的开放时间，如果客户有要求，还可以将其缩小到特定的员工或特定的地点。它一次最多查看一周的时间，因此它会询问您指的是哪一天或哪一周，而不是读出您的整个日历。
- **进行预约。** 预约会立即在 Trafft 中创建，作为已批准的预约，AI 会告知客户确认的时间。客户会被添加到您的 Trafft 客户列表中，或者通过其电子邮件地址与已有的记录匹配。
- **查询已预约内容。** AI 可以告知客户他们即将到来的 Trafft 预约。
- **取消预约。** 只需一条消息（“有事耽搁了，能帮我取消周四的预约吗？”），该预约就会从您的 Trafft 日历中消失。
- **更改预约时间。** AI 会先预订新的时间，然后再移除旧的时间，因此如果新的时间被占用，客户仍保留其原始时段。

通过这种方式进行的每一次预约也会出现在您的 **预约**（Appointments）页面上，并显示 Trafft 为提供商，因此它与其他预约一样进行统计：您的 **预约已创建** [webhook](webhooks.md) 会触发，从新预约开始的自动化流程也会照常运行。Trafft 本身发送的任何提醒或确认邮件仍会由 Trafft 发出，与您在 Trafft 网站上进行的预约完全一致。

---

## 稍后添加或更改服务

在 Trafft 中添加服务、更改价格、停用某项服务或增加新员工时，无需在此处开启任何开关。您的 AI 会在**每次预订对话中实时**读取您的 Trafft 目录，因此它依据的是 Trafft 当下的实时数据，而非连接时获取的副本。您今天上午添加的服务，下午即可进行预订。

有两点值得注意：

- **已连接行上的计数是连接时的数值。** 在“预订与日历”页面 Trafft 行上显示的各项服务和员工数量，是我们验证您的凭据时获取的数据，因此它们不会随着您 Trafft 菜单的增长而自动更新。点击该行上的“刷新”即可重新读取。这只会更新这些数字——无论如何，AI 始终读取的是您的实时目录。
- **如果您的助手提示某项服务不存在，请让它列出您的服务。** 这会促使它重新获取目录，并根据最新的列表进行回答。如果该服务仍然不存在，说明它确实不在您连接的 Trafft 账户中——请检查您是否连接了正确的账户（查看该行上的计数是最快捷的确认方式）。

---

## 值得了解的信息

- **取消操作会移除 Trafft 中的预约。** Trafft 的 API 会直接删除该预约，而不是将其标记为已取消，因此从聊天中取消的预订不会在您的 Trafft 日历中留下“已取消”的记录。如果您需要保留取消记录，请在其他地方进行备注。
- **AI 仅限于其职责范围。** 它只能查看和更改在该对话中预订的预约，或属于其正在交谈的联系人的预约。它无法读取或移动其他人的预订。
- **预订需要电子邮件地址和姓名。** Trafft 通过电子邮件识别客户，因此 AI 会在预订前询问尚未提供的必要信息。
- **暂不支持团体预订。** 目前每次预约仅限一人，无法将额外客人或团体人数发送至 Trafft。
- **付款在 Trafft 中进行。** AI 会报价但从不处理付款，也无法发送付款链接：Trafft 的 API 不公开账单或付款链接，因此它无法获取这些信息。如果某项服务必须预付或需要定金，请在 Trafft 中开启在线支付方式，并将 Trafft 的付款链接占位符（“电子邮件/短信通知设置” → “预约”下拉菜单）添加到“预约已批准”通知中。这样，AI 每次完成预订后，Trafft 发送的确认信息中就会包含支付全额或定金的链接。预订本身在创建时不会包含付款步骤，因此无论是否已付款，预订都会被批准。希望在聊天中直接提供链接？请将您的付款链接（Stripe、PayPal 或任何结账页面）添加到代理的知识库或说明中，并备注发送时机，AI 便会在客户需要付款时将其发送给客户。
- **每个 <span data-t="appName">Your AI Connector</span> 账户对应一个 Trafft 账户。** 如果您在不同的 Trafft 账户中经营多家企业，请连接您的代理需要进行预订的那一个。
- **白标 Trafft 账户的工作方式相同。** 地址以 `.admin.wlbookings.com` 结尾的账户（Trafft 的白标计划）连接方式与标准账户完全相同——只需粘贴完整地址作为公司地址即可。客户端 ID (Client ID) 和客户端密钥 (Client Secret) 仍然来自该账户自己的 **功能与集成 → API 与连接器** 页面，因此它仍然需要在其 Trafft 计划中具备 API 访问权限。

---

## 后续步骤

- [AI 智能体](../ai-agents/ai-agents.md) — 设置将进行预约的智能体。
- [预约系统](../appointments/booking-system.md) — 预约如何在整个应用程序中运作，以及它们显示在哪里。
- [知识库](../ai-automation/faq-management.md) — 添加您的价格、政策、停车和取消规则，以便 AI 也能回答与预约相关的问题。
