# 从 Acuity Scheduling 迁移：服务、客户与预约

> 想从 Acuity Scheduling 迁移，又不想重新录入数据？Pilotiko 以只读方式读取您的服务、客户和预约，再按顺序导入，每一步都可以随时撤销，迁移更安心又省力。

更新于 2026年11月8日 · https://app.pilotiko.com/zh/integrations/acuity-scheduling

凭您的 Acuity 用户 ID 和 API 密钥，Pilotiko 读取您的预约类型、客户和历史记录，不会修改 Acuity 中的任何内容，然后按服务、客户、预约的顺序导入。状态：可用。

## 要点
- 只读：Pilotiko 绝不会向 Acuity 写入任何内容。
- 分三步导入：先服务，再客户，最后预约。
- 每一步都会通过重新读取数据库进行验证，并可单独撤销。
- 如果撤销，导入的档案会被归档，绝不会被删除。

## Acuity Scheduling 连接有什么作用？

它只做一件事：把您的数据从 Acuity 搬到 Pilotiko，让您的时段、客户和历史记录从第一天起就位。

Acuity Scheduling 提供使用 HTTP Basic 认证的 API：您的数字用户 ID 作为用户名，API 密钥作为密码；Acuity 明确指出，这些请求必须从服务器发出，以保护凭据安全 [1]。Pilotiko 正是这样做的：密钥一旦保存，就不会再经过您的浏览器。

连接器读取三类内容：您的账户（/me）、您的预约类型，以及在 minDate 和 maxDate 限定的时间段内的预约。Acuity 默认每次请求最多返回 100 个预约 [2]；因此 Pilotiko 会连续发送多次请求，以涵盖全部历史记录。Acuity 返回的每个预约都包含客户、联系方式、日期、时长、价格和类型等信息 [2]。

这些数据随后进入与任何文件相同的处理流程：发现、匹配、导入、标准化、去重、核对、验证。电子邮件和电话号码会被标准化，以便识别以两种不同写法录入的同一位客户。

- **所需凭据**：Acuity 用户 ID（仅数字）和 API 密钥（至少 8 个字符）。
- **读取内容**：预约类型（名称、价格、时长、说明）、客户（姓名、电子邮件、电话）、预约（客户、服务、日期、时长、价格、状态、员工、备注）。
- **写入 Acuity**：无，永远不会。
- **写入 Pilotiko**：服务、客户档案和预约，在您点击“全部导入”之后。

## 如何从 Acuity Scheduling 迁移到 Pilotiko？

1. **找到您的凭据** — 在 Acuity 的 Integrations 部分，找到您的用户 ID 和 API 密钥。
2. **在 Pilotiko 中点击“连接”** — 粘贴这两个值。Pilotiko 会验证访问权限，然后读取全部数据，不做任何修改。
3. **关联日历** — 每个 Acuity 日历都会关联到一名 Pilotiko 员工，可以是现有员工，也可以是为此新建的员工。
4. **检查准备结果** — Pilotiko 会显示已就绪的内容、发现的重复项，以及需要您做决定的事项。
5. **点击“全部导入”** — 先服务，再客户，最后预约：预约需要有对应的客户和服务。每一步完成后都会显示一份报告。

## 哪些功能已可用，哪些即将推出？

| 功能 | 状态 | 详情 |
|---|---|---|
| 文件导入（CSV、Excel、.ics、.vcf） | 可用 | 通用迁移，无需连接 Acuity |
| 通过 API 读取服务、客户和预约 | 可用 | 依据 Acuity API v1 |
| 有序导入，并通过重新读取进行验证 | 可用 | 每一步都有报告 |
| 撤销某一步 | 可用 | 档案被归档，绝不删除 |
| 与 Acuity 持续同步 | 即将推出 | 尚未构建：该连接仅用于迁移 |
| 写入 Acuity | 即将推出 | 此连接器中暂无规划 |

## 一次迁移能省下多少重新录入的时间？

**示例：特鲁瓦-里维耶尔的一位美容师，Acuity 中有两年历史记录**

该账户有 6 种预约类型、412 位客户，以及 2,350 个过往和未来的预约，分布在 2 个日历上。

- 预约请求（每次请求 100 个） : 24
- 导入的服务 : 6
- 去重后导入的客户 : 398（合并了 14 个重复项）
- 导入的预约 : 2 350
- 已关联员工的日历 : 2
- 按每个预约 1 分钟计算，避免的重新录入 : 约 39 小时
- **= 约省去 39 小时的录入时间。**

## 您的客户数据如何处理？如何关闭访问权限？

迁移会转移个人信息：姓名、电子邮件、电话、预约备注。魁北克法律要求企业对其持有的个人信息负责（第 3.1 条），并要求告知当事人收集目的及其撤回同意的权利（第 8 条）[3]。同意仅在为其所征求的目的所必需的期限内有效（第 14 条）[3]。魁北克信息获取委员会（Commission d'accès à l'information）还介绍了数据可携权，该权利自 2024 年 9 月 22 日起生效 [4]。

API 密钥经 AES-256-GCM 加密，并保存在 Pilotiko 的服务器上。迁移完成后，请选择“断开连接”：密钥会被清除，该操作会记入审计日志。在 Acuity 一侧，请回到存放密钥的 Integrations 部分来更换密钥。如需向 Pilotiko 行使您的权利：[您的权利](/vos-droits)。

## Acuity 迁移有哪些限制？

迁移后，您的可预约时间可以来自您的日历：请参阅 [Google Agenda](https://app.pilotiko.com/zh/integrations/google-calendar) 或 [Outlook et Microsoft 365](https://app.pilotiko.com/zh/integrations/outlook-microsoft-365)。关于视频会议，请参阅 [Zoom](https://app.pilotiko.com/zh/integrations/zoom)。您旧网站的内容由 [WordPress](https://app.pilotiko.com/zh/integrations/wordpress) 读取。完整列表：[集成](https://app.pilotiko.com/zh/integrations)。

- 此版本不会导入 Acuity 的入门表单和标签。
- Acuity 中记录的付款不会转移；仅转移预约的价格。
- 撤销某一步会将已创建的档案归档；它们仍可查看，不会被销毁。

## 常见问题

### Pilotiko 会修改我的 Acuity 账户吗？

不会。该连接器是只读的：它绝不会向 Acuity 写入任何内容。过渡期间，您可以继续使用 Acuity。

### 在哪里可以找到我的 Acuity API 密钥？

Acuity 说明，可在您账户的 Integrations 部分找到它，同时也能看到您的用户 ID。这两个值都是必需的。

### 如果客户已经存在于 Pilotiko 中，会怎样？

Pilotiko 会标准化电子邮件和电话号码以识别重复项。重复的档案会被合并，而不是创建两次，报告中也会统计这些合并。

### 我可以撤销导入吗？

可以，逐步撤销。创建的档案会被归档，绝不会被删除，这样您就能核对当初导入了什么。

### 我的完整历史记录会被导入吗？

Pilotiko 按时间段读取预约，并连续发送每次 100 个的请求，从而涵盖通过 API 可获取的全部历史记录。确切数量会显示在报告中。

### 如果我无法使用 Acuity 的 API 怎么办？

请将您的数据导出为 CSV 或 .ics 文件，再通过 Pilotiko 的通用迁移导入。匹配和去重流程完全相同。

## 资料来源

1. Acuity Scheduling Developers, « Quick Start (Acuity Scheduling API) », https://developers.acuityscheduling.com/reference/quick-start (查阅于 2026-10-15)
2. Acuity Scheduling Developers, « GET /appointments », https://developers.acuityscheduling.com/reference/get-appointments (查阅于 2026-10-15)
3. LégisQuébec, « Loi sur la protection des renseignements personnels dans le secteur privé (RLRQ, c. P-39.1) », https://www.legisquebec.gouv.qc.ca/fr/document/lc/P-39.1 (查阅于 2026-10-15)
4. Commission d'accès à l'information du Québec, « Principaux changements apportés par la Loi 25 », https://www.cai.gouv.qc.ca/protection-renseignements-personnels/sujets-et-domaines-dinteret/principaux-changements-loi-25 (查阅于 2026-10-15)
