总结
作为企业,它很重要能够及时掌握您的WhatsApp商业账户(WABA)的任何变化,特别是针对WhatsApp政策违规行为。通过集成webhooks,您可以实时接收有关WABA的更改通知,从而能够迅速调整您的行为并避免额外的警告和/或强制执行行为。
说明
开始之前
要完成本指南,您需要:
注册为Meta开发者
设置商业主账户
创建一个类型为商业的Meta开发者应用程序并将其关联到您的商业主账户
为您的应用添加WhatsApp作为产品
确保您的应用已完成应用评审并请求了
whatsapp_business_management
权限。要将WhatsApp添加为产品,请按照以下步骤进行:转到Facebook开发者门户网站并点击您的应用
在应用仪表板中,找到左侧面板中的产品并点击 添加产品
找到WhatsApp并点击设置
步骤1:设置终端点并配置webhooks
请按照我们的Webhooks入门指南创建终端点并配置您的webhooks。
步骤2:订阅您的应用到您的WABA
您需要订阅有关WABA的webhook通知。您可以通过以下两种方式实现:
步骤3:注册账户更新
现在,您的应用已订阅webhooks,您可以定义希望接收的更新类型。要跟踪WABA的状态,请选择 account_update
选项。这将在您的WABA违反WhatsApp政策时通知您。要选择该选项:
转到您的应用仪表板并找到设置选项
点击Webhooks,然后点击管理
将显示一个对话框,其中包含您可以订阅的所有字段。为
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政策并避免潜在问题。
常见问题
开始
设置WhatsApp商业账户网钩子之前需要做什么? 您需要注册成为Meta开发者,设置商业经理账户,创建具有“业务”类型的Meta应用程序开发者账户并将其链接到您的商业经理账户。此外,您需要为您的应用添加WhatsApp作为产品,并确保您的应用已完成应用评审并请求了
whatsapp_business_management
权限。如何将WhatsApp添加为我的应用的产品? 您可以通过转到Meta开发者网站、单击您的应用,然后单击添加产品,即可将其添加到您的应用。然后,您可以找到并设置WhatsApp。
设置网钩子
如何为我的WhatsApp商业账户设置网钩子? 您可以通过遵循webhooks入门指南来设置webhooks,该指南将指导您完成创建端点和配置webhooks的过程。
我可以通过网钩子接收哪些类型的更新? 您可以接收有关账户更新的更新,包括对WhatsApp商业账户施加的违规和限制的更新。
接收通知
当我的WhatsApp商业账户被限制时,我将如何收到通知? 您将收到带有
restriction_info
字段的webhook通知,其中列出了对账户施加的所有限制以及这些限制到期的时间。当我的WhatsApp商业账户违反政策时,我将在webhook通知中收到什么信息? 您将收到带有
account_update
字段的通知,其中包含有关政策违规的信息,例如违规类型和与账户关联的电话号码。
故障排除
如果我没有收到webhook通知,我该怎么办? 检查您的webhooks是否设置正确,以及您的应用是否具有必要的权限。 您还可以查看Meta开发者文档获取故障排除技巧。
我如何确保我的WhatsApp商业账户符合WhatsApp政策? 您可以通过定期查看WhatsApp商业和商业政策并相应调整平台上的行为来确保符合性。您还可以使用webhooks接收通知,当您的账户被限制或违反政策时。