短信回执抄送
更新时间: 2024/08/09 16:25:32
网易云信 IM 提供短信回执抄送功能,即在调用接口发送短信后,云信 IM 服务器会将短信发送结果或用户回复的短信内容同步至您指定的本地服务器,帮助您掌握短信的发送成功率或其他业务。短信回执抄送服务的技术逻辑请参考 抄送服务概述。
短信回执消息类型
目前云信提供以下两种短信回执,您可根据业务需要自行选择。
短信回执类型(eventType) | 说明 |
---|---|
11 | 短信回执下行消息,即运营商发送给用户的 消息体 |
12 | 短信回执上行消息,即用户回复给运营商的 消息体 |
配置回执消息抄送地址
如果您需要接收回执消息,必须先在云信控制台上配置消息抄送地址,并选择需要的短信回执类型。
前提条件
-
已 开通短信服务。
-
已准备接收抄送消息的服务器地址。
为保证服务器地址的正确性,建议配置前通过以下命令校验。
curl -H 'User-Agent: Apache-HttpClient/4.5.9 (Java/1.8.0_151)' -H 'appkey: 0eb**********************' -H 'CurTime: 1608110108512' -H 'MD5: 99914b932bd37a5**********' -H 'CheckSum: ea9e0af4****************' -X POST -d '{}' -i ${YourServerAddress}
-
已在本地服务器实现消息抄送的处理逻辑。
消息抄送的流程及注意事项请参考 消息抄送服务概述。
操作步骤
-
登录 网易云信控制台。
-
在控制台首页 应用管理 中选择应用进入应用配置页面。
-
在顶部选择 消息抄送 页签,编辑 消息抄送地址,单击 确定,消息抄送状态自动开启。
-
在 消息抄送类型 中选择需要接收的 短信回执消息类型,然后单击 确认。
示例
短信回执下行消息
11. "eventType"="11"
HTTP 示例:
POST /receiveMsg.action HTTP/1.1
Host: yunxinservice.com.cn
Content-Type: application/json
CurTime: 1440570500855 //当前UTC时间戳,从1970年1月1日0点0 分0 秒开始到现在的毫秒数(String)
MD5: xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx //根据请求中的request body计算出来的MD5值
CheckSum: 001511b8435e0b28044ca50a78e8f983026c5e01
{ "eventType": "11", "objects": [ { "mobile": "12345678945", "sendid": "1490", "result": "DELIVRD", "sendTime": "2017-06-02 14:40:45", "reportTime": "2017-06-06 10:40:30", "spliced": "1","templateId":1234 }, { "mobile": "12345678945", "sendid": "1491", "result": "DELIVRD", "sendTime": "2017-06-02 14:41:00", "reportTime": "2017-06-02 10:41:20", "spliced": "2" ,"templateId":1234} ]}
cURL 示例:
curl -X POST -H "Content-Type: application/json" -H "CurTime: 1440570500855" -H "MD5: xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx" -H "CheckSum: 001511b8435e0b28044ca50a78e8f983026c5e01" -d '{ "eventType": "11", "objects": [ { "mobile": "12345678945", "sendid": "1490", "result": "DELIVRD", "sendTime": "2017-06-02 14:40:45", "reportTime": "2017-06-06 10:40:30", "spliced": "1" ,"templateId":1234}, { "mobile": "12345678945", "sendid": "1491", "result": "DELIVRD", "sendTime": "2017-06-02 14:41:00", "reportTime": "2017-06-02 10:41:20", "spliced": "2","templateId":1234 } ]}' 'http://yunxinservice.com.cn/receiveMsg.action'
上述示例均假设您指定的接收抄送的服务器地址为 http://yunxinservice.com.cn/receiveMsg.action
。
消息体中的JSON字段说明:
名称 | 类型 | 说明 |
---|---|---|
mobile | String | 手机号码 |
sendid | String | 短信发送接口返回的sendid |
result | String | 运营商返回的短信发送状态码 |
sendTime | String | 短信发送时间,调用sms-api接口发送短信的时间 |
reportTime | String | 运营商返回的短信送达时间 |
spliced | String | 短信计费条数 |
templateId | Long | 短信对应的模版ID |
短信回执上行消息
12. "eventType"="12"
HTTP 示例:
POST /receiveMsg.action HTTP/1.1
Host: yunxinservice.com.cn
Content-Type: application/json
CurTime: 1440570500855 //当前UTC时间戳,从1970年1月1日0点0 分0 秒开始到现在的毫秒数(String)
MD5: xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx //根据请求中的request body计算出来的MD5值
CheckSum: 001511b8435e0b28044ca50a78e8f983026c5e01
{"eventType":"12","objects":"[{ \"mobile\": \"18605818212\", \"content\": \"TD\", \"replytime\": \"2017-09-20 10:40:30\"},{ \"mobile\": \"18605818213\", \"content\": \"TD\", \"replytime\": \"2017-09-20 10:40:30\" }]"}
cURL 示例:
curl -X POST -H "Content-Type: application/json" -H "CurTime: 1440570500855" -H "MD5: xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx" -H "CheckSum: 001511b8435e0b28044ca50a78e8f983026c5e01" -d '{"eventType":"12","objects":"[{ \"mobile\": \"18605818***\", \"content\": \"TD\", \"replytime\": \"2017-09-20 10:40:30\"},{ \"mobile\": \"18605818***\", \"content\": \"TD\", \"replytime\": \"2017-09-20 10:40:30\" }]"}' 'http://yunxinservice.com.cn/receiveMsg.action'
上述示例均假设您指定的接收抄送的服务器地址为 http://yunxinservice.com.cn/receiveMsg.action
。
消息体中的JSON字段说明:
名称 | 类型 | 说明 |
---|---|---|
mobile | String | 手机号码 |
content | String | 上行短信内容 |
replytime | String | 短信回复时间 |
此文档是否对你有帮助?