摘要
作为一家企业，保持对您WhatsApp商业账户（WABA）更改的掌控尤为重要，特别是当涉及WhatsApp政策违规时。通过与webhook集成，您可以接收到WABA更改的实时通知，从而可以快速调整行为，避免额外的警告和/或执法行动。
说明
开始前
要完成本指南，您需要：
注册为Meta开发者
设置一个商业经理账户
创建一个Meta for Developers应用，并选择商业类型，并将其链接到您的商业经理
将WhatsApp添加为您的应用程序的产品
确保您的应用程序已完成应用程序审查并请求whatsapp_business_management权限，要将WhatsApp添加为应用程序的产品，请按照以下步骤进行：
前往Facebook开发者门户，然后单击您的应用程序
在应用程序仪表板上，找到左侧面板中的产品，然后单击添加产品
找到WhatsApp，然后单击设置
步骤 1：设置端点并配置webhook
请按照我们的webhook入门指南，创建您的端点并配置您的webhook设置。
步骤 2：订阅您的应用程序以接收WABA webhook通知
您需要订阅您的应用程序以接收WABA的webhook通知。您可以通过以下两种方式进行：
步骤 3：注册账户更新
现在您的应用程序已订阅了webhook，您可以定义您想要接收的更新类型。要跟踪您的WABA状态，请选择account_update选项，这将在您的WABA违反WhatsApp策略时通知您。要选择此选项：
前往您的应用程序仪表板，找到设置选项
单击Webhooks，然后单击管理
将出现一个对话框，包含所有您可以订阅的字段。单击account_update的订阅按钮，当您的WABA违反策略时，您将接收到以下形式的通知：
{
"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限制
请密切关注您的webhook，以检查您的WABA是否因策略违规而受到限制。如果已实施限制，您将接收到包含restriction_info字段的webhook，该字段列出了对您的账户施加的所有限制以及这些限制何时过期。以下是报告限制的webhook示例：
限制添加新电话号码：
{
"field": "account_update",
"value": {
"phone_number": "PHONE_NUMBER",
"event": "ACCOUNT_RESTRICTION",
"restriction_info": [
{
"restriction_type": "RESTRICTION_ON_ADD_PHONE_NUMBER_ACTION",
"expiration": TIMESTAMP
}
]
}
}限制发送商业主动消息：
{
"field": "account_update",
"value": {
"phone_number": "PHONE_NUMBER",
"event": "ACCOUNT_RESTRICTION",
"restriction_info": [
{
"restriction_type": "RESTRICTED_BIZ_INITIATED_MESSAGING",
"expiration": TIMESTAMP
}
]
}
}限制响应用户主动消息：
{
"field": "account_update",
"value": {
"phone_number": "PHONE_NUMBER",
"event": "ACCOUNT_RESTRICTION",
"restriction_info": [
{
"restriction_type": "RESTRICTED_CUSTOMER_INITIATED_MESSAGING",
"expiration": TIMESTAMP
}
]
}
}
通过遵循以下步骤，您将能够设置WABA的webhook并接收有关账户更改的实时通知，帮助您遵守WhatsApp策略并避免任何潜在问题。
常见问题（FAQs）
入门
1. 设置WABA webhook前需要什么?
您需要注册为Meta开发者，设置一个业务经理账户，创建一个具有业务类型的Meta for Developers应用程序，将其链接到您的业务经理，并将WhatsApp添加为产品。您的应用程序还必须完成应用程序审查并请求whatsapp_business_management权限。
2. 如何将WhatsApp添加为应用程序的产品?
您可以通过前往Facebook开发者门户，打开您的应用程序，选择添加产品，找到WhatsApp并单击设置来添加WhatsApp。
配置webhook
3. 如何设置端点并配置webhook?
您可以遵循我们的webhook入门指南来创建您的端点并配置webhook设置。
4. 如何订阅我的应用程序以接收WABA webhook通知?
您可以通过使用API调用或通过图像API浏览器来订阅您的应用程序。
5. 可以订阅哪些类型的更新?
要跟踪WABA状态，您应该订阅account_update字段，它会在策略违规和账户相关事件时通知您。
策略违规通知
6. 如何知道我的WABA是否违反了策略?
您将接收到带有event字段的webhook通知，该字段设置为ACCOUNT_VIOLATION，以及有关违规类型的详细信息。
7. 策略违规通知中包含什么信息?
违规通知包括电话号码、事件类型以及一个显示特定策略违规的violation_info字段。
跟踪限制
8. 如何跟踪对我的WABA施加的限制?
您将接收到包含restriction_info字段的webhook通知，该字段列出了所有限制以及这些限制的过期时间。
9. 可能会收到什么类型的限制通知?
您可能会收到有关限制添加新电话号码、发送商业主动消息或响应用户主动消息的通知。
10. 收到限制通知后应该怎么办?
监控您的webhook以获取更新，并调整您的消息行为以遵守WhatsApp的策略并避免进一步的执行操作。