新版本模板审核结果回调--短信服务-火山引擎

文档中心

立即注册

导航

新版本模板审核结果回调

最近更新时间：2025.10.14 11:15:54首次发布时间：2025.10.14 11:15:54

您可以在短信服务控制台的回执配置中设置回调 URL，用于接收模版的审核结果。

注意事项

回调地址需要符合以下条件，才可以成功接收短信服务模版的审核结果。

使用 HTTP/HTTPS URL。
短信服务可以直接访问回调地址，即回调地址具备公网访问能力。
如果回调地址所在服务器设置了防火墙，请放行来自短信服务的请求。

准备工作

在您接收短信服务的回调消息之前，需要登录短信服务控制台配置用于接收回调消息的 URL。

登录短信服务控制台。
在左侧导航栏，选择通用管理 > 回执配置。
在回执配置页面，编辑模板审核状态回调地址。
设置您用于接收回调消息的 URL。URL 格式为http(s)://<您的回调地址>。

回调请求说明

参数	取值	描述
Content-Type	application/json;charset=utf-8	定义网络文件的类型和网页的编码。
Accept-Encoding	gzip, deflate	采用指定的压缩格式传输数据。
Accept	/	指定客户端希望接收的数据类型。

Body

请求体整体是一个 JSON 数组。

参数	数据类型	描述
audit_time	string	审核时间
second_template_audit_result	list	二级模板审核结果

second_template_audit_result

参数	数据类型	描述
account	string	主账号信息
sub_account	string	消息组
template_id	string	一级模板ID
second_template_id	string	二级模板ID
audit_result	bool	二级模板审核结果 true：审核通过 false：未通过
audit_opinion	string	二级模板审核失败原因
signature	string	二级模板绑定的签名
content	string	二级模板的完整内容
industry	string	行业信息
channel_type	string	短信的发送类型 CN_NTC：通知短信 CN_OTP：验证码短信 CN_MKT：营销短信

回调结果示例

审核通过示例

{
  "audit_time": "2025-10-13 20:21:02",
  "second_template_audit_result": [
    {
      "template_id": "S1T_1y*****qa",
      "second_template_id": "S2T_1y*****xe",
      "signature": "测试签名",
      "content": "【测试签名】你好，模版${XXX},链接${XX} 拒收请回复R",
      "industry": "通用",
      "sub_account": "86****0a",
      "account": "21****7",
      "channel_type": "CN_MKT",
      "audit_result": true,
      "audit_opinion": "",
      "audit_time": "2025-10-13 20:21:02"
    }
  ]
}

审核驳回示例

{
  "audit_time": "2025-10-13 20:21:02",
  "second_template_audit_result": [
    {
      "template_id": "S1T_1y*****qa",
      "second_template_id": "S2T_1y*****xe",
      "signature": "测试签名",
      "content": "【测试签名】你好，模版${XXX},链接${XX} 拒收请回复R",
      "industry": "通用",
      "sub_account": "86****0a",
      "account": "21****7",
      "channel_type": "CN_MKT",
      "audit_result": false,
      "audit_opinion": "签名和模板内容，一级发送类型不符合，审核驳回",
      "audit_time": "2025-10-13 20:21:02"
    }
  ]
}

返回值

要求用户侧接收成功后，返回 httpStatus为200，否则火山侧会认为回调失败。
回调失败不重推。

短信服务