**使用 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 仅查询已批准模板列表并执行发送。

典型的集成流程包括：
1. 在 Papo 面板中生成 API 令牌。
2. 确定模板已同步到的 WhatsApp Cloud API 收件箱。
3. 获取该收件箱中已批准模板（HSM）的列表。
4. 使用必要参数准备请求：模板 ID、语言、带国家代码的收件人号码，以及变量值（如果模板包含 `{{1}}`、`{{2}}` 等）。
5. 发送请求——可以发送给单个联系人，也可以发送给一组号码，每个号码带有各自的自定义变量。

## 使用 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 政策。

## 另请参阅

- [如何通过 Webhook（outbound）实时接收 Papo 事件](/hc/papo/articles/receive-real-time-events-papo-webhook-outbound-zh)
- [如何使用 Papo API 批量创建和更新联系人](/hc/papo/articles/how-to-use-papo-api-create-update-contacts-bulk-zh)

---

**[立即开始自动化您的 HSM 发送 – 免费试用 →](https://papo.global/?utm_source=helpcenter&utm_medium=article&utm_campaign=papo-api-send-whatsapp-hsm-message-templates&utm_content=zh_CN)**

在 Papo 创建账户，首位用户免费发送已批准的消息模板。