Skip to content

template webhook

GiuFLim edited this page Oct 24, 2025 · 1 revision

模板相关回执

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

  • message_template_status_update 模板状态更新事件

  • message_template_quality_update 模板质量更新事件

  • template_category_update 模板类型更新事件

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

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

验签说明

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

模板状态更新

模板已批准

{
    "field": "message_template_status_update",
    "value": {
        "business_phone": "xxx",
        "event": "APPROVED",
        "message_template_id": "1246121xxx3981",
        "message_template_language": "en",
        "message_template_name": "ok_ok",
        "reason": "NONE",
        "time": 1761291192,
        "wabaId": "xxx"
    }
}

模板被拒绝

{
    "field": "message_template_status_update",
    "value": {
        "business_phone": "xxx",
        "event": "REJECTED",
        "message_template_id": "14639xx35113",
        "message_template_language": "en",
        "message_template_name": "ok_re",
        "reason": "INCORRECT_CATEGORY",
        "time": 1761207280,
        "wabaId": "xxx"
    }
}

模板已暂停

{
    "field": "message_template_status_update",
    "value": {
        "business_phone": "xxx",
        "event": "PAUSED",
        "message_template_id": "132693xxx507429",
        "message_template_language": "en_US",
        "message_template_name": "ok_name",
        "reason": "NONE",
        "time": 1761238848,
        "wabaId": "xxx"
    }
}

模板待删除

{
    "field": "message_template_status_update",
    "value": {
        "business_phone": "xxx",
        "event": "PENDING_DELETION",
        "message_template_id": "125634xxx002056",
        "message_template_language": "en",
        "message_template_name": "testest",
        "reason": "NONE",
        "time": 1761289179,
        "wabaId": "xxx"
    }
}

模板质量变更

{
    "field": "message_template_quality_update",
    "value": {
        "business_phone": "xxx",
        "message_template_id": "78683xxx77751",
        "message_template_language": "en_US",
        "message_template_name": "neww",
        "new_quality_score": "GREEN",
        "previous_quality_score": "UNKNOWN",
        "time": 1761291623,
        "wabaId": "xxx"
    }
}

模板类型变更

{
	"field": "template_category_update",
	"value": {
		"message_template_id": "138641xxx878",
		"message_template_language": "zh_CN",
		"message_template_name": "test_service_1",
		"new_category": "MARKETING",
		"time": 1745385279,
		"wabaId": "xxx"
	}
}
{
    "field": "template_category_update",
    "value": {
        "message_template_id": "138641xxx879",
        "message_template_language": "zh_CN",
        "message_template_name": "test_service_2",
        "new_category": "MARKETING",
        "previous_category": "UTILITY",
        "time": 1745385279,
        "wabaId": "xxx"
    }
}

简介

短信

语音

云呼叫中心(NXLink)

云呼叫中心(AI自动外呼)

Flash Call

短链

邮件验证码

DID号码

通用

号码检测

WhatsApp

Viber

Zalo ZNS

Super Message API

隐私号(旧)

PNS

坐席(旧版)

AI Agent

Clone this wiki locally