导航
智慧短信解析回调
最近更新时间：2024.05.15 17:51:07首次发布时间：2024.05.15 17:51:07
您可以在短信服务控制台的回执配置中设置回智慧短信的解析回调的URL，接收智慧短信服务异步返回的解析状态报告，以确认智慧短信在终端是否完成了解析。
注意事项
回调地址需要符合以下条件，才可以成功接收智慧短信的解析状态报告。
使用 HTTP/HTTPS URL。
短信服务可以直接访问回调地址，即回调地址具备公网访问能力。
如果回调地址所在服务器设置了防火墙，请放行来自短信服务的请求。
准备工作
在您接收智慧短信的解析回调消息之前，需要登录短信服务控制台配置用于接收回调消息的 URL。
登录短信服务控制台。
在左侧导航栏，选择通用管理 回执配置。
在回执配置页面，编辑智慧短信发送回调地址。
设置您用于接收回调消息的 URL。URL 格式为
http(s)://<您的回调地址>。
在短信服务控制台设置智慧短信发送回调地址后，如果您调用 SendAim - 发送智慧短信接口发送智慧短信后，则智慧短信服务会异步向回调地址返回智慧短信解析回调。
回调结果示例：
[ { "account": "200****", "sub_account": "1504****", "signature": "短信服务", "mobile": "188******", "channel_type": "CN_5G_AIM", "service_id": "106966940****", "send_time": 1669171012444, "template_id": "5G_0fa7****", "ext": "123456", "message_id": "bde1b10d-19cf-460f-abcd-26231a82****", "recv_time": 1669171015941, "status_code": "0", "description": "解析成功", "msg_count": 1, "mccmnc": "46002", "iso_code": "CN", "aim_brand": "HuaWei" } ]
回调请求说明：
Header
| 参数 | 取值 | 描述 |
|---|---|---|
| Content-Type | application/json;charset=utf-8 | 定义网络文件的类型和网页的编码。 |
| Accept-Encoding | gzip, deflate | 采用指定的压缩格式传输数据。 |
| Accept | */* | 指定客户端希望接收的数据类型。 |
Body
请求体整体是一个 JSON 数组。
| 参数 | 类型 | 描述 |
|---|---|---|
| account | string | 火山引擎账号 |
| sub_account | string | 消息组ID |
| status_code | string | 解析状态，"0"代表成功 |
| description | string | 状态描述 |
| signature | string | 签名 |
| template_id | string | 模板ID |
| mobile | string | 手机号 |
| channel_type | string | 短信类型，可能值：CN_OTP |
| message_id | string | 发送时返回的message_id字段 |
| msg_count | int | 拆分条数 |
| service_id | string | 发送通道，非必传，国际/港澳台短信没有该字段 |
| ext | string | 发送时传递的Tag字段 |
| send_time | int64 | 短信发送时间，milliseconds时间戳 |
| recv_time | int64 | 短信接收时间，milliseconds时间戳 |
| mccmnc | string | 移动网络提供者唯一代码 |
| iso_code | string | ISO 3166-1 国家代码 |
| aim_brand | string | 解析品牌，枚举为（HuaWei、XiaoMi、OPPO、VIVO） |
Status_code及说明
| Code | 描述 | 处理建议 |
|---|---|---|
| 0 | 解析成功 | 智慧短信只有解析成功才有回执，code只有0 |