要通过官方 API (云 API) 连接您的 WhatsApp 号码，您必须首先在 Papo 平台 (https://papo.global/) 上创建一个新的“WhatsApp – 云 API (Meta)”类型的收件箱来启动该过程。然后，您需要在 Meta 商务管理平台中配置一个应用和一个电话号码，以获取凭据（电话号码 ID、商务账号 ID 和访问令牌），这些凭据将被输入到 Papo 中以完成连接。
通过 WhatsApp 官方 API（也称为云 API）进行集成，是希望将渠道客户服务专业化的企业最强大、最具扩展性的解决方案。与 WhatsApp Business 应用程序不同，API 允许多个客服专员使用同一个号码，并支持通过 AI 进行高级自动化以及与其他系统（如 CRM 和 ERP）的集成。
Papo Global 简化了此连接过程，引导您完成整个流程，并将 WhatsApp 与您的其他通信渠道统一到一个收件箱中。
连接前的准备工作
在开始之前，请确保您拥有：
- 一个 Papo Global 账号： 您需要访问 Papo 面板才能开始配置。
- 一个 Meta 商务管理平台 (Facebook Business Manager) 账号： 您的公司必须在 Meta 平台上进行配置，并且最好已通过验证。
- 一个专属电话号码： 您要连接的号码不能在 WhatsApp 或 WhatsApp Business 应用程序账号中处于活跃状态。如果处于活跃状态，您需要先删除与该号码关联的 WhatsApp 账号，然后才能开始迁移到 API 的过程。
连接 WhatsApp API 的分步指南
该过程分为多个步骤，这些步骤在 Papo 平台和 Meta 环境中都会发生。
| 步骤 | 操作 | 平台 |
|---|---|---|
| 1 | 开始创建收件箱 | Papo Global |
| 2 | 创建和配置应用 | Meta (Meta 开发者平台) |
| 3 | 添加和验证电话号码 | Meta (WhatsApp 管理器) |
| 4 | 获取 API 凭据 | Meta (应用面板) |
| 5 | 输入凭据并完成 | Papo Global |
| 6 | 创建消息模板 | Meta (WhatsApp 管理器) |
步骤 1：在 Papo Global 中开始配置
第一步是在 Papo 中表明您希望通过官方 API 添加一个新的 WhatsApp 渠道。
- 访问 Papo 面板，然后前往 设置 → 收件箱。
- 点击 “添加新收件箱” 按钮。
- 在渠道列表中，选择 “WhatsApp – 云 API (Meta)” 选项。
- 您将被重定向到配置屏幕。请保持此标签页打开，因为在 Meta 中完成所有配置后您将需要它。
步骤 2：在 Meta 中创建和配置应用
现在，我们将进入 Meta 开发者环境来创建必要的结构。
- 访问 Meta 开发者平台。
- 点击 “创建应用”。
- 选择应用类型 “企业”，然后点击“下一步”。
- 为您的应用命名（例如：
Papo 客服 [公司名称]），并将其关联到您的 Meta 商务管理平台账号。 - 创建应用后，在主面板中向下滚动，找到 “WhatsApp” 产品。点击 “配置”。
步骤 3：添加和验证电话号码
在您的应用中配置 WhatsApp 产品时，您需要关联并验证将要使用的电话号码。
- 按照说明连接您的 Meta 账号。
- 在 API 配置部分，将有一个添加电话号码的步骤。
- 输入您希望使用的电话号码（请记住：它不能在其他 WhatsApp 应用中处于活跃状态）。
- 选择验证方法（短信或语音通话），并输入收到的代码以确认号码所有权。
步骤 4：获取 API 凭据
创建应用并验证号码后，您就可以访问集成所需的凭据了。它们位于 Meta 应用内 WhatsApp 配置面板中。
三个基本信息是：
- 电话号码 ID： 您的号码在 Meta 平台上的唯一标识符。
- WhatsApp 商务账号 ID (WABA ID)： 您的 WhatsApp 商务账号的标识符。
- 访问令牌： 授权 Papo 代表您的公司与 API 通信的密钥。
5：在 Papo Global 中完成连接
返回您在步骤 1 中打开的 Papo 标签页。
- 使用您从 Meta 获取的信息填写表单字段：
- 收件箱名称： 用于识别渠道的内部名称（例如：“官方 WhatsApp”）。
- 电话号码 ID。
- WhatsApp 商务账号 ID (WABA ID)。
- 访问令牌。
- 点击 “保存” 或 “创建收件箱”。
完成！保存后，Papo 将建立连接。很快，您的官方 WhatsApp 号码将连接成功，并准备好直接通过您的统一收件箱接收和发送消息。
步骤 6：创建消息模板 (Templates)
为了与客户发起对话或在他们最后一次互动 24 小时后发送通知，WhatsApp 要求使用消息模板（也称为 HSM）。
- 在您的 Meta 商务管理平台中，访问 WhatsApp 管理器。
- 前往 消息模板 部分。
- 点击 “创建模板”，并按照说明定义消息的类别、名称、语言和内容。
- 提交模板以供审批。通常，审批需要几分钟到几个小时。
常见问题 (FAQ)
### 我可以使用我当前的 WhatsApp Business 号码吗？
不能同时使用。要在官方 API 中使用某个号码，您需要首先删除与该号码关联的 WhatsApp Business 或个人账号。这将释放该号码以在 API 中注册。应用程序的聊天记录不会被迁移，因此如果您需要查阅旧消息，建议提前备份。
### 如果我不使用消息模板会怎样？
只有当客户发起对话或在过去 24 小时内回复了您的消息时，您才能发送自由格式的消息（不使用模板）。超出此“24 小时窗口期”，公司发起的任何消息都必须使用 Meta 预先批准的模板。
### 连接官方 API 是否有费用？
是的。Meta 根据对话模型收取官方 API 的使用费。每月前 1,000 次服务对话通常是免费的。此外，还有 Papo 平台的订阅费用，该平台提供界面、CRM、AI 和自动化功能。有关 Meta 定价的详细信息，请查阅他们的官方文档。
### 什么是 WABA ID？
WABA 代表“WhatsApp Business Account”（WhatsApp 商务账号）。WABA ID 是您的 WhatsApp 商务账号的唯一标识符。通过此账号，您可以管理您的电话号码、消息模板并查看使用指标。
### Meta 批准我的消息模板需要多长时间？
审批时间可能会有所不同。许多模板，尤其是交易型模板（如订单确认或预约提醒），通常会在几分钟内自动获得批准。促销型模板或内容更复杂的模板可能需要几个小时进行人工审核。
### 我在哪里管理可以访问此收件箱的客服专员？
在 Papo 中创建收件箱后，您可以进入收件箱设置中的“客服专员”标签页，添加哪些团队成员有权查看和回复通过该号码收到的对话。
第一个用户免费，并包含 AI 访问、完整的 CRM 和多渠道功能。