
# Trafft

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

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

---

## Trafft 的功能

Trafft 为预约类业务提供：

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

通过将 Trafft 连接到 <span data-t="appName">DM Champ</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（连接）**。

::: master-only
<figure><img src="../.gitbook/assets/v2-settings-booking-calendar.png" alt="“预约与日历”设置屏幕，显示了 Google Calendar、Zenchef、Formitable 和 Trafft 卡片，每张卡片都有一个“连接”按钮"><figcaption><p>“预约与日历”显示了 Trafft 与 Google Calendar、Zenchef 和 Formitable 并列的实时连接状态，并可分别进行连接。</p></figcaption></figure>
:::

4. 填写 **Company address（公司地址）**。这是您登录地址中 `.admin.trafft.com` 之前的部分——如果您在 `acme.admin.trafft.com` 登录，请输入 `acme`。粘贴完整地址也可以；我们会自动提取正确的部分。
5. 填写您的 **Client ID（客户端 ID）** 和 **Client Secret（客户端密钥）**。两者均可在您的 Trafft 管理面板的 **Features & Integrations（功能与集成） → API & Connectors（API 与连接器）** 下找到。
6. （可选）添加一个 **Label（标签）**——为您自己的列表命名，如果您管理多家企业，这会很有用。
7. 点击 **Connect（连接）**。

::: master-only
<figure><img src="../.gitbook/assets/v2-trafft-connect-modal.png" alt="“连接 Trafft”对话框，包含公司地址、客户端 ID、客户端密钥和可选标签的字段"><figcaption><p>连接所需的一切都在一个屏幕上：您的公司地址（.admin.trafft.com 之前的部分）、来自 Trafft“API 与连接器”页面的客户端 ID 和客户端密钥，以及您自选的标签。</p></figcaption></figure>
:::

### 凭据检查

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

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

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

### 暂停或断开连接

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

- **暂停**（Pause）会停止您的 AI 向 Trafft 进行预约，但保留连接设置。**激活**（Activate）则会重新开启。当您正在重组服务或处于闭店期间时，可以使用此功能。
- **断开连接**（Disconnect）会彻底移除连接。已经存在于 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）。

::: master-only
<figure><img src="../.gitbook/assets/v2-agent-bookings-provider-picker.png" alt="AI 智能体的 AI 能力步骤中的预约卡片，预约功能已开启，提供商选择器已打开，显示内置日历、Zenchef、Formitable 和 Trafft"><figcaption><p>智能体预约卡片上的预约提供商选择器——选择 Trafft，让该智能体针对您的 Trafft 服务、员工和营业时间进行预约。</p></figcaption></figure>
:::

---

## AI 能做什么

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

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

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

---

## 值得了解的信息

- **取消操作会移除 Trafft 中的预约。** Trafft 的 API 会直接删除该预约，而不是将其标记为已取消，因此从聊天中取消的预约不会在您的 Trafft 日历中留下“已取消”的行。如果您需要保留取消记录，请在其他地方记录。
- **AI 保持在自己的范围内。** 它只能查看和更改在该对话中预订的预约，或者属于它正在交谈的联系人的预约。它无法读取或移动其他人的预约。
- **预约需要电子邮件地址和姓名。** Trafft 通过电子邮件识别客户，因此 AI 会在预订前询问尚未获取的必要信息。
- **暂不支持团体预约。** 目前每个预约仅限一人——额外的客人或团体人数暂时无法发送给 Trafft。
- **每个 <span data-t="appName">DM Champ</span> 账户对应一个 Trafft 账户。** 如果您在不同的 Trafft 账户中经营多家企业，请连接您的智能体应该预订的那个账户。

---

## 后续步骤

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