phone webhook

WABA账号&号码相关回执

应用上配置的webhook值【需要订阅 如下事件】

• account_update waba账号更新事件
• account_review_update 账号审核事件
• phone_number_name_update 号码显示名称更新事件
• phone_number_quality_update 号码质量更新事件
• user_preferences 用户订阅/取消订阅营销消息事件

对提供的webhook地址，进行推送信息

• URL：webhook_url
• Method：POST
• Content-Type：application/json

验签说明

对于客户应用配置了回执加签算法，所有的回执请求服务端都会进行加签处理，客户端可自行对回执请求进行验签处理，验签算法请参照签名算法

WABA账号更新

WhatsApp 企业帐户被禁止

{
    "field": "account_update",
    "value": {
        "ban_info": {
            "waba_ban_date": "October 22, 2025",
            "waba_ban_state": "DISABLE"
        },
        "business_phone": "xxx",
        "event": "DISABLED_UPDATE",
        "time": 1761200607,
        "wabaId": "xxx"
    }
}

WhatsApp 企业帐户被解封

{
    "field": "account_update",
    "value": {
        "ban_info": {
            "waba_ban_date": "October 21, 2025",
            "waba_ban_state": "REINSTATE"
        },
        "business_phone": "15557902885",
        "event": "DISABLED_UPDATE",
        "time": 1761045171,
        "wabaId": "1618074075500491"
    }
}

WhatsApp 企业帐户违反政策

{
    "field": "account_update",
    "value": {
        "business_phone": "xxx",
        "event": "ACCOUNT_VIOLATION",
        "time": 1761265095,
        "wabaId": "xxx"
    }
}

WhatsApp 企业帐户因违反政策而受到限制

{
    "field": "account_update",
    "value": {
        "business_phone": "xxx",
        "event": "ACCOUNT_RESTRICTION",
        "time": 1758943996,
        "wabaId": "xxx"
    }
}

WhatsApp 企业帐户审核已通过

{
    "field": "account_review_update",
    "value": {
        "business_phone": "xxx",
        "decision": "APPROVED",
        "time": 1739321024,
        "wabaId": "xxx"
    }
}

WhatsApp 企业帐户已删除

{
    "field": "account_update",
    "value": {
        "business_phone": "xxx",
        "event": "ACCOUNT_DELETED",
        "time": 1757450905,
        "wabaId": "xxx"
    }
}

WhatsApp 企业帐户已从合作伙伴中删除

{
    "field": "account_update",
    "value": {
        "business_phone": "xxx",
        "event": "PARTNER_REMOVED",
        "time": 1761096554,
        "wabaId": "xxx",
        "waba_info": {
            "owner_business_id": "xxx",
            "waba_id": "xxx"
        }
    }
}

WhatsApp企业账户开通MM Lite terms of service

{
    "field": "account_update",
    "value": {
        "business_phone": "5215662159749",
        "event": "MM_LITE_TERMS_SIGNED",
        "time": 1761240707,
        "wabaId": "659621850177641",
        "waba_info": {
            "owner_business_id": "1743928369740624",
            "waba_id": "659621850177641"
        }
    }
}

号码添加

{
    "field": "account_update",
    "value": {
        "business_phone": "xxx",
        "event": "PHONE_NUMBER_ADDED",
        "phone_number": "xxx",
        "time": 1760607591,
        "wabaId": "xxx"
    }
}

号码移除

{
    "field": "account_update",
    "value": {
        "business_phone": "xxx",
        "event": "PHONE_NUMBER_REMOVED",
        "phone_number": "xxx",
        "time": 1761238854,
        "wabaId": "xxx"
    }
}

号码显示名称审核通过

{
    "field": "phone_number_name_update",
    "value": {
        "business_phone": "xxx",
        "decision": "APPROVED",
        "display_phone_number": "xxx",
        "rejection_reason": "NONE",
        "requested_verified_name": "ok ok",
        "time": 1761202562,
        "wabaId": "xxx"
    }
}

号码显示名称审核被拒绝

{
    "field": "phone_number_name_update",
    "value": {
        "business_phone": "xxx",
        "decision": "REJECTED",
        "display_phone_number": "xxx",
        "rejection_reason": "BIZ_COMMERCE_VIOLATION_OTHER",
        "requested_verified_name": "ok ok",
        "time": 1761241282,
        "wabaId": "xxx"
    }
}

号码质量更新

• TIER_1K

{
    "field": "phone_number_quality_update",
    "value": {
        "business_phone": "xxx",
        "current_limit": "TIER_1K",
        "display_phone_number": "xxx",
        "event": "FLAGGED",
        "time": 1761103022,
        "wabaId": "xxx"
    }
}

• TIER_UNLIMITED

{
    "field": "phone_number_quality_update",
    "value": {
        "business_phone": "xxx",
        "current_limit": "TIER_UNLIMITED",
        "display_phone_number": "xxx",
        "event": "UPGRADE",
        "time": 1761051398,
        "wabaId": "xxx"
    }
}

用户恢复接收营销消息

{
    "value": {
        "messaging_product": "whatsapp",
        "metadata": {
            "display_phone_number": "xxx",
            "phone_number_id": "xxx"
        },
        "contacts": [
            {
                "wa_id": "xxx"
            }
        ],
        "user_preferences": [
            {
                "wa_id": "xxx",
                "detail": "User requested to resume marketing messages",
                "category": "marketing_messages",
                "value": "resume",
                "timestamp": 1753865209
            }
        ]
    },
    "field": "user_preferences"
}

用户关闭接收营销消息

{
    "value": {
        "messaging_product": "whatsapp",
        "metadata": {
            "display_phone_number": "xxx",
            "phone_number_id": "xxx"
        },
        "contacts": [
            {
                "wa_id": "xxx"
            }
        ],
        "user_preferences": [
            {
                "wa_id": "xxx",
                "detail": "User requested to stop marketing messages",
                "category": "marketing_messages",
                "value": "stop",
                "timestamp": 1753407219
            }
        ]
    },
    "field": "user_preferences"
}