借助 Papo REST API（https://papo.global/），您可以自动创建、列出和取消 WhatsApp 与 SMS 定时消息，将通信定时直接集成到您的系统、CRM 或自动化流程中——无需手动访问面板。
Papo 平台已经提供集中管理计划消息的区域，但当定时量很大，或您需要由其他软件触发发送时，API 就是理想选择。通过它，您可以以编程方式创建提醒、跟进和通知，同时保持与可视化界面相同的控制力。
通过 API 管理定时消息的操作概览
| 操作 | 作用 | 使用场景 |
|---|---|---|
| 创建定时 | 为联系人在指定日期和时间安排一条 WhatsApp 或 SMS 消息。 | 从外部系统安排预约提醒、销售跟进或收款通知。 |
| 列出定时 | 返回所有定时消息，并可按状态筛选（待处理、已发送、已取消、失败）。 | 将发送计划同步到仪表盘，在创建新定时前检查待处理项，或审计计划通信。 |
| 取消定时 | 在触发时间之前取消已安排发送。 | 中断不再相关的消息，例如已取消活动的提醒或已失去意义的跟进。 |
集成如何工作
Papo API 遵循 REST 标准，并使用 Bearer 令牌认证。所有写入操作（创建和取消）都需要您账户的密钥，该密钥在面板的开发者区域生成。基础 URL 是 https://app.papo.global/api/v1。
要使用定时消息功能：
- 在 Papo 面板（开发者/API 区域）生成密钥。将其保存在安全位置——它只显示一次。
- 在每个请求中，包含标头
Authorization: Bearer {sua_chave_secreta}。 - 按照官方文档 https://papo.global/pt/docs 使用定时消息专用端点。在那里您可以找到确切路径、必填参数（如联系人 ID、渠道、内容、日期/时间）以及 JSON 格式的 payload 示例。
- 要列出定时消息，您可以按状态应用筛选，从而只查询待处理或已完成的发送。
API 反映平台 定时消息 模块的行为：通过 API 创建的定时会出现在面板列表中，任何通过 API 执行的取消都会立即更新状态。
这种自动化适合谁
- 开发者和 IT 团队，需要将消息定时集成到自有系统，如 ERP、CRM 或预约平台。
- 白标经销商，希望让客户能够通过 API 安排发送，从而提升解决方案的价值。
- 有大量跟进操作的团队（销售、收款、出席确认），希望无需人工干预即可自动创建提醒。
- 使用自动化流程的企业，从其他工具中的事件触发创建定时。
常见问题
使用 API 是否需要启用定时消息模块？
是。API 操作的功能与面板中的功能相同。如果您的套餐包含该模块，相应的端点也可用。
API 是否允许安排带附件或媒体的消息？
官方文档详细说明了支持的内容类型。目前，通过平台定时主要面向文本消息。请查阅 API 参考，以确认在您集成时是否支持媒体。
如何认证请求？
将您的 Papo 账户密钥作为 Bearer 令牌放在 Authorization 标头中。该密钥在面板的开发者区域生成。
我可以一次为多个联系人安排消息吗？
API 允许每个请求创建一个定时。对于多个联系人，您可以进行顺序调用。请查看文档，确认是否有适合您用例的批量端点。
如果我尝试取消已发送的消息会怎样？
API 将返回错误，因为只有状态为待处理的定时才能取消。触发后，消息无法再更改。
在哪里可以找到 API 密钥？
在 Papo 面板中，访问开发者区域或 API 设置。密钥在创建时显示；如果丢失，需要生成新的。
另请参阅
使用 Papo，您可以将 WhatsApp、CRM 和 AI 集成在一个地方，无需初始费用。