是的，您可以通过API使用Papo的预约模块来管理服务、时间安排和预约。REST API允许您列出服务、专业人员和患者，查询日程，并以编程方式创建新预约，将整个预约流程集成到您的网站、应用程序或外部系统中。
Papo的预约模块旨在成为您日程的控制中心。它组织四个支柱：您提供的服务（包括名称、时长和价格）、执行服务的专业人员、每个人的时间可用性以及已完成的预约。通过API，您可以自动化这些操作，而无需手动访问面板，从而保持Papo与其他工具之间的流畅集成。
通过API进行预约操作摘要
| 操作 | 功能 | 使用场景 |
|---|---|---|
| 列出服务 | 返回已注册的预约服务，包括时长和价格。 | 将服务目录与您的网站或应用程序同步，以便客户实时查看选项。 |
| 列出专业人员 | 返回执行服务的接待员或团队成员的列表。 | 在外部预约界面中显示可用的专业人员及其专业领域。 |
| 列出患者 | 返回已注册的患者，包括姓名、电话和ID。 | 在创建新预约或将其链接到现有记录之前，检查客户是否已存在于CRM中。 |
| 列出预约 | 返回按状态筛选的预约（例如：已确认、待处理）。 | 审核预约、与报告系统集成，或在提供新时间段之前检查日程占用情况。 |
| 安排预约 | 在专业人员的日程中为特定服务和患者创建实际预约。 | 允许客户直接通过您的网站或应用程序进行预约，或从外部系统自动创建预约。 |
API认证工作原理
预约中的所有写入操作都需要您Papo账户的密钥，作为Bearer令牌在授权标头中发送。账户的公钥是可选的，但如果发送，则必须与密钥属于同一账户。
API的基本URL是 https://app.papo.global/api/v1。密钥在Papo面板的开发者区域生成。密钥在创建时仅显示一次；请将其保存在安全的地方，如果怀疑泄露，请立即撤销。
实际使用方法
- 访问Papo面板中的开发者/API区域并生成密钥。同时复制账户的公钥。
- 在每个请求中，使用密钥作为Bearer令牌进行身份验证。如果您想加强验证，请在文档中指定的标头中发送公钥。
- 要构建预约界面，首先列出可用的服务和专业人员。这样，您就可以使用Papo账户的真实数据动态填充网站或应用中的选项。
- 要创建预约，请调用创建预约的端点，在JSON负载中发送服务、专业人员、患者的标识符以及所需的日期/时间。API将验证预约模块中配置的日程可用性，并创建该预约。
- 请查阅官方文档
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注册，即可从第一个用户开始使用REST API自动化您的预约。