使用 Papo（https://papo.global/），您可以通过 REST API 发送 WhatsApp 已批准的消息模板（HSM），无需访问界面即可自动化事务通知和营销活动。该 API 允许列出您账户的 Cloud API 收件箱、获取 Meta 已批准的模板，并将其发送给一个或多个联系人，前提是您拥有 API 令牌且模板已在平台中同步。
| API 操作 | 作用 | 使用示例 |
|---|---|---|
| 列出 WhatsApp 收件箱 | 返回与账户关联的 WhatsApp Cloud API 收件箱 | 发送前选择正确的收件箱 |
| 列出已批准模板 | 返回指定 inbox 中状态为“已批准”的消息模板（HSM） | 查看可用于发送的 HSM |
| 向单个联系人发送 HSM | 向单个电话号码发送已批准模板，并填充变量 | 订单通知、预约提醒 |
| 向多个联系人发送 HSM | 一次性将同一模板发送给联系人列表 | 营销活动、群发通知 |
API 发送 HSM 的工作原理
Papo API 与平台功能相对应。要发送 WhatsApp 消息模板，您无需通过代码创建新内容：模板直接在 Meta 商务管理平台中创建并提交，批准后会自动出现在您的 Papo 账户中。API 仅查询已批准模板列表并执行发送。
典型的集成流程包括：
- 在 Papo 面板中生成 API 令牌。
- 确定模板已同步到的 WhatsApp Cloud API 收件箱。
- 获取该收件箱中已批准模板（HSM）的列表。
- 使用必要参数准备请求：模板 ID、语言、带国家代码的收件人号码，以及变量值（如果模板包含
{{1}}、{{2}}等）。 - 发送请求——可以发送给单个联系人，也可以发送给一组号码，每个号码带有各自的自定义变量。
使用 API 的分步指南
1. 生成 API 令牌
在 Papo 账户的设置菜单中，进入 API 或访问令牌部分。创建一个具有管理对话和消息所需权限的令牌。请将令牌保存在安全位置；它将在所有请求的请求头中发送。
2. 列出可用的 WhatsApp 收件箱
在发送任何模板之前，您需要知道哪个收件箱（inbox）包含已批准模板。使用返回您账户 WhatsApp Cloud API 收件箱的端点。记下您打算使用的收件箱标识符——后续步骤中必须使用它。
3. 查询已批准模板（HSM）
拿到收件箱标识符后，调用列出状态为 APPROVED 的模板的端点。响应将包含每个模板的名称、可用语言、类别（营销、实用或身份验证）以及预期参数。此步骤很重要，可确认模板已获准使用，并了解需要填写哪些变量。
4. 构建发送请求
向单个联系人发送的操作基本需要：
- 模板 ID（或名称，取决于实现方式）。
- 模板语言（例如
pt_BR）。 - 联系人电话号码，包括国家代码（例如
5511999999999）。 - 如果模板包含占位符，则提供一个包含变量值的对象。
对于批量发送（多个联系人），该调用接受收件人列表，每个收件人包含自己的号码，并可选地带自己的变量。所有收件人使用同一模板。
5. 发送并检查响应
API 会返回同步确认，表示发送请求已被接受。要跟踪实际送达状态（已送达、已读、失败），您可以配置 outbound webhook——Papo 会实时通知对话事件。“另请参阅”中列出的实时事件接收文章说明了如何启用此功能。
谁应使用 API 发送 HSM
任何希望从外部系统自动化事务通信的企业都能从 API 中受益。无需为每条通知依赖 Papo 界面，您可以将发送直接集成到 ERP、CRM 或电商平台中。常见示例：
- 购买确认或订单状态更新。
- 提前 24 小时发送的问诊或预约提醒。
- 带支付链接的逾期账单催收。
- 航班变更或预订变更通知。
当决定何时发送模板的规则存在于其他软件中时，API 尤其有用——例如，物流系统在包裹发出运输时立即触发配送通知。
常见问题
Papo API 有额外费用吗？
API 包含在 Papo 套餐中。您可以根据所购套餐生成令牌并使用端点。有关限制和每次请求费用的详细信息，请参阅套餐页面和 API 文档。
我需要通过 API 创建消息模板吗？
不需要。模板必须在 Meta 商务管理平台中创建并提交审批。批准后，它们会自动同步到 Papo，并出现在 API 的模板列表中。
我可以向不在 Papo CRM 中的号码发送 HSM 吗？
可以。收件人无需事先在平台 CRM 中注册。只需在请求中提供 WhatsApp 号码（含国家代码和区号）。但是，您必须获得客户的同意（opt-in）才能接收通信，尤其是当模板属于营销类别时。
如何知道消息是否已送达？
API 的即时响应确认请求已被接受并发送到 WhatsApp。要实时监控失败、送达和已读情况，需要启用 Papo 的事件 webhook（outbound）。请参阅帮助中心中的 webhook 指南。
通过 API 发送有速率限制吗？
有。Papo 会应用速率限制以保护服务稳定性并遵守 WhatsApp 政策。建议保持适中速度——避免突然峰值有助于维护号码健康。具体数值请参阅 API 文档。
我可以使用 API 进行大规模营销活动吗？
可以，前提是您仅使用已批准的营销类别模板，并获得收件人的明确 opt-in。发送不受欢迎的消息可能导致举报，并使您的号码面临被封禁的风险。请通过节奏控制来规划发送，并始终遵守 WhatsApp 政策。
另请参阅
在 Papo 创建账户，首位用户免费发送已批准的消息模板。