跳转到主要内容

为 WhatsApp 商业帐户通知设置 Web-hook

更新于今天

总结

作为企业,它很重要能够及时掌握您的WhatsApp商业账户(WABA)的任何变化,特别是针对WhatsApp政策违规行为。通过集成webhooks,您可以实时接收有关WABA的更改通知,从而能够迅速调整您的行为并避免额外的警告和/或强制执行行为。

说明

开始之前

要完成本指南,您需要:

步骤1:设置终端点并配置webhooks

请按照我们的Webhooks入门指南创建终端点并配置您的webhooks。

步骤2:订阅您的应用到您的WABA

您需要订阅有关WABA的webhook通知。您可以通过以下两种方式实现:

步骤3:注册账户更新

现在,您的应用已订阅webhooks,您可以定义希望接收的更新类型。要跟踪WABA的状态,请选择 account_update选项。这将在您的WABA违反WhatsApp政策时通知您。要选择该选项:

  1. 转到您的应用仪表板并找到设置选项

  2. 点击Webhooks,然后点击管理

  3. 将显示一个对话框,其中包含您可以订阅的所有字段。为account_update点击订阅。当您的WABA已违反一项政策时,您将收到以下通知:

json { "object": "whatsapp_business_account", "entry": [ { "id": "whatsapp-business-account-id", "time": 1604703058, "changes": [ { "field": "account_update", "value": { "phone_number": "16505551111", "event": "ACCOUNT_VIOLATION", "violation_info": { "violation_type": "ALCOHOL", } } } ] } ]}

步骤4:跟踪WABA限制

请注意检查webhooks以核实是否因政策违规而对WABA施加了限制。如果已施加限制,您将收到包含restriction_info字段的webhook,该字段列出了对账户施加的所有限制以及这些限制到期的时间。以下是报告限制的webhook示例:

  • 添加新电话号码的限制:

json { "field": "account_update", "value": { "phone_number": "PHONE_NUMBER", "event": "ACCOUNT_RESTRICTION", "restriction_info": [ { "restriction_type": "RESTRICTION_ON_ADD_PHONE_NUMBER_ACTION", "expiration": TIMESTAMP }, ] }}

json { "field": "account_update", "value": { "phone_number": "PHONE_NUMBER", "event": "ACCOUNT_RESTRICTION", "restriction_info": [ { "restriction_type": "RESTRICTED_BIZ_INITIATED_MESSAGING", "expiration": TIMESTAMP }, ] }}

json { "field": "account_update", "value": { "phone_number": "PHONE_NUMBER", "event": "ACCOUNT_RESTRICTION", "restriction_info": [{ "restriction_type": "RESTRICTED_CUSTOMER_INITIATED_MESSAGING", "expiration": TIMESTAMP } ] }}

遵循这些步骤,您将能够为WABA设置webhooks并在账户发生更改时接收实时通知,这有助于您保持一致遵守WhatsApp政策并避免潜在问题。

常见问题

开始

  1. 设置WhatsApp商业账户网钩子之前需要做什么? 您需要注册成为Meta开发者,设置商业经理账户,创建具有“业务”类型的Meta应用程序开发者账户并将其链接到您的商业经理账户。此外,您需要为您的应用添加WhatsApp作为产品,并确保您的应用已完成应用评审并请求了whatsapp_business_management权限。

  2. 如何将WhatsApp添加为我的应用的产品? 您可以通过转到Meta开发者网站、单击您的应用,然后单击添加产品,即可将其添加到您的应用。然后,您可以找到并设置WhatsApp。

设置网钩子

  1. 如何为我的WhatsApp商业账户设置网钩子? 您可以通过遵循webhooks入门指南来设置webhooks,该指南将指导您完成创建端点和配置webhooks的过程。

  2. 我可以通过网钩子接收哪些类型的更新? 您可以接收有关账户更新的更新,包括对WhatsApp商业账户施加的违规和限制的更新。

接收通知

  1. 当我的WhatsApp商业账户被限制时,我将如何收到通知? 您将收到带有restriction_info字段的webhook通知,其中列出了对账户施加的所有限制以及这些限制到期的时间。

  2. 当我的WhatsApp商业账户违反政策时,我将在webhook通知中收到什么信息? 您将收到带有account_update字段的通知,其中包含有关政策违规的信息,例如违规类型和与账户关联的电话号码。

故障排除

  1. 如果我没有收到webhook通知,我该怎么办? 检查您的webhooks是否设置正确,以及您的应用是否具有必要的权限。 您还可以查看Meta开发者文档获取故障排除技巧。

  2. 我如何确保我的WhatsApp商业账户符合WhatsApp政策? 您可以通过定期查看WhatsApp商业和商业政策并相应调整平台上的行为来确保符合性。您还可以使用webhooks接收通知,当您的账户被限制或违反政策时。

这是否解答了您的问题?