网易云信 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}
  

• 已在本地服务器实现消息抄送的处理逻辑。

  消息抄送的流程及注意事项请参考消息抄送服务概述。

操作步骤

1. 登录网易云信控制台。

2. 在控制台首页应用管理中选择应用进入应用配置页面。

3. 在顶部选择消息抄送页签，编辑消息抄送地址，单击确定，消息抄送状态自动开启。

   

4. 在消息抄送类型中选择需要接收的短信回执消息类型，然后单击确认。

   

示例

短信回执下行消息

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	短信回复时间