跳转到主要内容

将本地部署的 WhatsApp Business API 迁移至 WhatsApp Cloud API

摘要

Meta 已停止提供 WhatsApp On-Premise API,转而支持 WhatsApp Cloud API。如果您仍在使用带有 Wati 的 On-Premise API,本文将说明您需要注意的变化以及为继续使用集成所需的必要技术更新。

说明

为什么要迁移到 WhatsApp Cloud API?

WhatsApp Cloud API 提供:

  • 更高的可靠性和可扩展性: Cloud API 使用 WhatsApp 的云基础设施,提供更稳定、更具扩展性的服务。

  • 获取最新功能: 您可以使用最新的 WhatsApp Business 功能和更新。请参阅 WhatsApp API 功能完整列表

  • 性能提升: Cloud API 使用经过优化的基础设施,实现更快、更高效的消息传递。

Cloud API 有哪些变化?

如果您仍在使用基于 WhatsApp On-Premise API 的集成,则需要注意 2 项重要的技术变更。

API 请求

通过 On-Premise 设置直接向 WhatsApp API 端点(例如 /v1/messages 和 /v1/contacts)发送的 API 请求将不再受支持。

您的 API 请求必须改由通过 Wati 进行路由。

Webhooks

通过 On-Premise 设置直接注册 WhatsApp 事件的 Webhook 不再受支持。

WhatsApp Webhook 事件现在由 Wati 处理并转发。

开发者计划 (Developer Plan) 发生了什么变化?

作为原始迁移的一部分,原先在开发者计划 (Developer Plan) 中的客户已免费迁移至增长计划 (Growth Plan),且订阅价格保持不变。

此计划迁移主要适用于在过渡期间使用开发者计划的客户。大多数客户目前使用的是较新的 Wati 计划,因此该信息仅供参考。

您需要做什么

如果您的 WhatsApp 集成仍在使用 On-Premise API,您的开发团队需要更新集成,以适配 Wati WhatsApp Cloud API。

1. 更新您的 API 集成

您现有的 On-Premise 服务器连接已不再受支持。您的开发团队必须创建新的集成,并更新您的 API 请求,使其通过 Wati 工作。

有关更多信息,请参阅 Wati API 文档。

2. 更新您的 Webhooks

如果您的集成使用了 WhatsApp Webhooks,请更新您的 Webhook 设置,以便通过 Wati 接收 WhatsApp 事件。

3. 准备并测试您的更改

Wati 可以提供用于开发和测试的试用环境。在对实时集成进行更改之前,您可以使用此环境来更新和测试您的 API 请求及 Webhooks。

如果您需要访问试用环境或在迁移过程中需要帮助,请联系 Wati 支持团队。

这是否解答了您的问题?