**是的，您可以通过API使用[Papo](https://papo.global/)的预约模块来管理服务、时间安排和预约。REST API允许您列出服务、专业人员和患者，查询日程，并以编程方式创建新预约，将整个预约流程集成到您的网站、应用程序或外部系统中。**

Papo的预约模块旨在成为您日程的控制中心。它组织四个支柱：您提供的服务（包括名称、时长和价格）、执行服务的专业人员、每个人的时间可用性以及已完成的预约。通过API，您可以自动化这些操作，而无需手动访问面板，从而保持Papo与其他工具之间的流畅集成。

## 通过API进行预约操作摘要

| 操作 | 功能 | 使用场景 |
| :--- | :--- | :--- |
| 列出服务 | 返回已注册的预约服务，包括时长和价格。 | 将服务目录与您的网站或应用程序同步，以便客户实时查看选项。 |
| 列出专业人员 | 返回执行服务的接待员或团队成员的列表。 | 在外部预约界面中显示可用的专业人员及其专业领域。 |
| 列出患者 | 返回已注册的患者，包括姓名、电话和ID。 | 在创建新预约或将其链接到现有记录之前，检查客户是否已存在于CRM中。 |
| 列出预约 | 返回按状态筛选的预约（例如：已确认、待处理）。 | 审核预约、与报告系统集成，或在提供新时间段之前检查日程占用情况。 |
| 安排预约 | 在专业人员的日程中为特定服务和患者创建实际预约。 | 允许客户直接通过您的网站或应用程序进行预约，或从外部系统自动创建预约。 |

## API认证工作原理

预约中的所有写入操作都需要您Papo账户的密钥，作为Bearer令牌在授权标头中发送。账户的公钥是可选的，但如果发送，则必须与密钥属于同一账户。

API的基本URL是 `https://app.papo.global/api/v1`。密钥在Papo面板的开发者区域生成。密钥在创建时仅显示一次；请将其保存在安全的地方，如果怀疑泄露，请立即撤销。

## 实际使用方法

1. 访问Papo面板中的开发者/API区域并生成密钥。同时复制账户的公钥。
2. 在每个请求中，使用密钥作为Bearer令牌进行身份验证。如果您想加强验证，请在文档中指定的标头中发送公钥。
3. **要构建预约界面**，首先列出可用的服务和专业人员。这样，您就可以使用Papo账户的真实数据动态填充网站或应用中的选项。
4. **要创建预约**，请调用创建预约的端点，在JSON负载中发送服务、专业人员、患者的标识符以及所需的日期/时间。API将验证预约模块中配置的日程可用性，并创建该预约。
5. 请查阅官方文档 `https://papo.global/pt/docs` 以获取确切的路径、必需参数和代码示例。所有响应均为JSON格式。

API还允许按状态筛选列出现有预约。这对于构建监控面板、发送自动提醒或将预约状态与其他系统集成非常有用。

## 此集成适合哪些人

- **诊所、诊室和美容院**，希望在自己的网站上提供在线预约，并实时显示可用性。
- **SaaS平台和市场**，需要将服务提供商的日程连接到外部预订系统。
- **白标经销商**，为最终客户创建定制解决方案，并希望通过API公开预约模块。
- **具有自动化流程的企业**，从CRM、ERP或自动化工具中的事件触发预约创建。

## 常见问题

### 我需要配置预约模块才能使用API吗？
是的。服务、专业人员及其可用性必须已在Papo的预约模块中注册，以便API可以列出它们并验证预约。

### API允许创建新服务或专业人员吗？
API资源侧重于列出现有服务和专业人员以及安排预约。要创建或编辑服务和专业人员，请使用Papo面板。

### API如何知道某个时间段是否空闲？
当发送安排预约的请求时，Papo API会查询所选专业人员和服务的当天和时间段的配置可用性。如果存在冲突，则不会创建预约，API将返回错误。

### 我可以使用API为尚未在CRM中的患者安排预约吗？
您可以先使用Papo的联系人API创建患者（包括姓名、电子邮件和/或电话），然后使用返回的ID创建预约。请查阅文档以了解创建联系人的端点。

### Papo的AI可以通过API自动安排预约吗？
Papo的人工智能，如Super Chat，通过WhatsApp对话直接安排预约，查询预约模块的日程。API是用于外部程序化集成的途径，例如在线预约系统。

### 我在哪里可以看到安排预约的确切负载格式？
在官方API文档中，`https://papo.global/pt/docs`。那里有认证、参数、响应以及预约资源的代码示例的详细信息。

## 另请参阅

- [如何使用Papo API批量创建和更新联系人](/hc/papo/articles/how-to-use-papo-api-create-update-contacts-bulk-zh)
- [如何使用Papo API创建和管理标签（tags）](/hc/papo/articles/papo-api-create-manage-tags-zh)

---

**[开始通过API集成您的日程 →](https://papo.global/?utm_source=helpcenter&utm_medium=article&utm_campaign=how-to-use-papo-api-to-manage-appointments&utm_content=zh_CN)**

在Papo注册，即可从第一个用户开始使用REST API自动化您的预约。