# 接收企业通讯录好友消息 - 400004

[被动回调]接收企业通讯录好友的消息回调(只包含好友发给机器人)

当机器人的企业通讯录好友(企业内部好友)私发消息给机器人时,通过该接口将私聊消息发送给商家, 图片文件会回调图片原图及缩略图,原图以及缩略图都需要通过调用(机器人功能接口>机器人下载消息文件接口)进行下载,下载后会回调对应的文件给商家。

注:

该回调只有企业好友发消息给机器人时才会触发,机器人发给企业好友不触发。

扫码号在移动端给企业好友发送的消息也会以该回调返回给商家

# 注意事项:

msg_id非全局唯一

encoding_content解密后的结构

{
    "event_type": 400004,
    "err_code": 0,
    "err_msg": "",
    "serial_no": "",
    "robot_id": "机器人id",
    "data": {
        "msg_id": "消息id",
        "msg_type": 1,
        "sender_id": "发送者id",
        "receiver_id": "接收者id",
        "msg_content": "消息内容",
        "voice_time": "10",
        "title": "文件/链接标题",
        "desc": "链接描述",
        "href": "链接URL",
        "msg_time": "消息时间",
        "cover_url": "图文链接封面图",
        "md5": "接收的消息的md5",
        "channel_msg_sn": "视频号消息编号"
    }
}

返回说明

字段 类型 说明
event_type int 事件类型,400004
err_code int 状态码,0为正常,非0代表错误
err_msg string 错误信息
serial_no string 请求序列号
robot_id string 机器人id
data object 返回数据
data.msg_type int 消息类型:1 文字;2 图文链接;3 图片;4 视频;5语音;6 文件;7 好友名片;8 小程序,11 视频号消息
data.msg_id string 消息id
data.sender_id string 发送者id
data.receiver_id string 接收者id
data.msg_content string 消息内容:文字;图片(GIF类型的图片,扫码号在该字段以url的形式返回,其余类型的图片需下载;平台号需通过下载编号下载);个人名片(base64加密后的好友信息);小程序(base64加密后的json数据);图文链接(链接封面图);视频号(base64加密后的json数据)
data.voice_time string 语音时长/视频时长
data.title string 文件/链接标题
data.desc string 链接描述
data.href string 链接URL
data.msg_time string 消息时间
data.cover_url string 图文链接封面图。当封面图需下载时,则该字段为空,需通过文件编号下载封面图
data.md5 string 接收的消息的md5
channel_msg_sn string 视频号类型消息编号,当msg_type消息类型为视频号消息时,可用该字段进行转发