文档已更新。
中文(简体) 译文尚未完成。
英语更新时间:4月25日

支持

疑难解决

消息未送达

以下情景可能导致消息显示为“已发送”,而非“已送达”。出现这种情况的原因有很多,出于隐私和政策方面的考虑,我们不会披露该错误的根本原因

  • 在我们为离线客户保留消息的 30 天期限内,客户未曾上线。
  • 客户已封锁此 WhatsApp Business 电话号码,或此商家拥有的其他 WhatsApp Business 电话号码。

在一些情景中,该 API 会返回一个错误代码,其中包含描述该错误性质的错误消息。情景示例:

  • 无效的请求参数
  • 诚信错误
  • 客户尚未接受我们的新服务条款和隐私政策。请将链接 https://wa.me/tos/20210210 发送给您的最终用户,以便他们接受最新的服务条款。
  • 客户正在使用旧版 WhatsApp。客户应使用以下版本或更高版本:
    • Android:2.21.15.15
    • SMBA:2.21.15.15
    • iOS:2.21.170.4
    • SMBI:2.21.170.4
    • KaiOS:2.2130.10
    • 网页:2.2132.6
  • 客户位于试验组内。
  • 为了打造优质的用户体验,这条消息未被送达。请参阅每位用户的营销模板消息限制

合理解决方案

使用非 WhatsApp 联系方式,请 WhatsApp 用户执行以下操作:

  • 确认他们实际可以向您的 WhatsApp Business 电话号码发送消息
  • 确认您的所有 WhatsApp Business 电话号码都不在他们的已封锁号码清单中(设置 > 隐私 > 已封锁封锁的联系人
  • 确认他们已接受我们的最新服务条款(如果他们还未接受,在设置 > 帮助中,或在设置 > 应用程序信息中,系统会提示他们接受最新的条款或政策)
  • 更新到最新版 WhatsApp 客户端

国家/地区限制

位于古巴、伊朗、朝鲜、叙利亚和乌克兰三个制裁地区(克里米亚、顿涅茨克、卢甘斯克)内的企业不符合 WhatsApp Business 开放平台的使用资格。

位于古巴、伊朗、朝鲜、叙利亚和乌克兰三个制裁地区(克里米亚、顿涅茨克、卢甘斯克)内的 WhatsApp Messenger (WhatsApp) 和 WhatsApp Business 应用用户不符合通过 WhatsApp Business 开放平台接收消息的资格。

土耳其的商家可以使用此平台,但是土耳其的应用用户无法通过该 API 发送消息,也无法接收通过该 API 发送的消息。

Webhooks

相冲突的消息接收状态

在极少数情况下,同一条消息可能会同时触发成功和失败消息状态更新 Webhooks。例如,一条消息可能会触发包含 "status":"delivered" 的消息 Webhooks,以及另外一个包含 "status":"failed" 的 Webhooks。当客户在多台设备上登录 WhatsApp,并且消息成功送达其中一台设备,而未送达其他设备时,就会发生这种情况。触发 "delivered" 消息状态 Webhooks 的任何消息均已送达用户的至少一台设备。

错误代码 2 - API 服务

更新 API 时,您可能会经历长达 5 分钟的非正常运行时间。在此期间,该服务不可使用。我们尝试在减少尽量对企业干扰的前提下进行这类更新,但您仍然可能会受到影响

如何调试

建议您等待 5 分钟,然后尝试再次调用该 API。

身份验证和授权错误

如果您用于 API 调用的访问口令存在问题,系统就会返回这类错误。

如何调试

您可以直接将所用的访问口令粘贴到访问口令调试工具中。然后,检查您是否已经选择 whatsapp_business_managementwhatsapp_business_messaging 权限。

如果您的口令无法使用该权限,您需要生成一个新口令。在生成新口令期间,请务必选择:

  • 您用于 API 调用的 Meta 应用
  • 以下权限:whatsapp_business_managementwhatsapp_business_messaging

常见问题

一般常见问题

We expect Cloud API to provide the same key features as the On-Premises API soon, including user change notifications and sticker pack management. Our goal is for the Cloud API to become the preferred platform for new features.

We will release updates monthly with new features and improvements. There is no work required to access these features - the Cloud API updates automatically.

WhatsApp develops and operates the WhatsApp Business API, which enables businesses to communicate with WhatsApp consumer users on the WhatsApp network. When using the Cloud API, Meta will host the WhatsApp Business API for you and provide an endpoint for the WhatsApp service for your incoming and outgoing WhatsApp communications.

No, we will continue to provide the On-Premises API for now. See On-Premises API for information.

No, there is no difference in messaging prices between the Cloud API and the On-Premises API. Access to Cloud API is free, and we expect it to generate additional cost savings for developers. The two types of cost savings for the Cloud API are 1) set up cost (including server or external cloud provider cost), 2) ongoing cost of maintenance (including engineering time for API upgrades).

A Solution Partner can select which setup a given client should use. We recommend that the majority of clients use the Cloud API for ease of implementation and maintenance. Solution Partners can also continue to maintain integration with the On-Premises API.

We want to make it clear what it means to message with a business on WhatsApp. Some businesses may choose to use Meta or another company to help them manage and store their messages. When a business chooses to manage their messages with another company, we will let consumers know by showing a different system message. Learn more.

技术实施常见问题

The Cloud API architecture significantly simplifies the Solution Partner's operational and infrastructure requirements to integrate with WhatsApp Business Platform. First, it removes the infrastructure requirements to run Business API docker containers (CAPEX savings). Second, it obviates the need of operational responsibilities to manage the deployment (OPEX savings). For details, refer to the architecture diagram comparing the On-Premises and Cloud API deployments.

Solution Partners and direct clients do not need the WebApp and CoreApp containers that are used in the On-Premises API. Meta will manage all database data and media data on behalf of the Solution Partner or direct client.

As your on-premises performance depends heavily on your hardware, software, and connectivity to WhatsApp servers, if you wish to understand these differences, you can perform your own load tests on Cloud API as you might have done for your own on-premises installation. You can also refer to our performance comparison to understand more details around how the on-premise and Cloud APIs compare.

Migrating between the on-premises and Cloud APIs is seamless, and can be done bidirectionally. See migration details for more information.

可靠性常见问题

在某些情况下,某些用户错误可能会被自动错误计入非正常运行时间。在这些情况下,在经过一周时间内的详细分析之后,我们会覆盖非正常运行时间,将其计入正常运行时间。

可能存在一些不影响我们全球可用性的问题。在这种情况下,WhatsApp Business API 状态页面将显示一个状态,反映可能存在一些不影响全球可用性的干扰。请提交 站内支持 工单,以便开展深入调查。

在以下情况下,系统不会自动追踪可用性当中的非正常运行时间:

  • 存在网络问题,导致请求在到达图谱 API 层(第一层)之前失败。
  • 存在网络问题,导致出站 Webhooks 无法到达企业的 Webhooks 端点。

进入系统之前出现的任何问题,在此之后,此类问题将显示为错误或与成功失之交臂。还有在首次尝试发出 Webhooks 后遇到的问题,但系统会继续尝试发出,直至成功送达 Webhooks 端点。

在进行人工检测后,可用性面板中反映的其他情况包括(非系统错误):

  • 确定了 Meta 身份验证问题,如身份验证口令(安全库)问题,无论是合格请求未能验证身份还是未能进行授权。
  • 拒绝合法请求的验证。

在这两种情况下,WhatsApp 将在事后近乎实时(并非实时)地检测并解释这些问题。

针对正常运行时间和/或延迟时间,我们目前不提供商用产品服务水平协议。

We will have disaster recovery and data replication across multiple regions. The expected downtime would be within our SLA and usually in the order of less than a minute to less than five minutes.