# 添加同事共享的客户为好友

[异步回调] 添加同事共享的客户为好友

温馨提示：可通过该接口向同事分享的客户好友发起好友请求。该接口回调成功，仅代表好友请求发起成功，不代表已成为好友

请求方式：POST

请求地址：https://$basehost/gateway/qopen/AddShareFriend

body参数：

{
    "robot_id":"机器人id",
    "share_sn":"分享编号，可以从 收到同事共享的客户回调 - 703007 中获取",
    "message":"加好友验证语（不填写则使用企微系统默认验证语）",
}

字段	类型	必填	说明
robot_id	string	是	机器人id
share_sn	string	是	分享编号，可以从收到同事共享的客户回调 - 703007 中获取
message	string	是	加好友验证语（不填写则使用企微系统默认验证语）

返回值：

{
    "errcode": 0,
    "errmsg": "",
    "hint": ""
}

返回说明

字段	类型	说明
errcode	int	状态码，0为正常，非0代表错误
errmsg	string	错误信息
hint	string	请求日志ID

处理结果，异步返回值 encoding_content解密后的结构：

{
  "event_type": 703063,
  "err_code": 0,
  "err_msg": "success",
  "data": {
    "alias": "",
    "base64_alias": "",
    "base64_name": "Li4uxx",
    "gender": 1,
    "is_verified": false,
    "name": ".s.",
    "profile_photo": "http: //wx.qlogo.cn/mmhead/eTBFF2uBk4hufSucInCf15CDmFibGx18wpUdaTKnxeFFEnoQ9XNw/0",
    "real_name": "",
    "share_sn": "m6n0gNsGhLgevBjhOvQM+8Ga+V+QqrWxr1ZpuWIDFW2UUo9woyx/3wQaor1FhPcoskUKD5M="
  },
  "robot_id":"accTRnQaYWpqq5PsfLSk",
  "hint":"wxV1BqsyyBchiso0HuLBn"
}

字段	类型	说明
event_type	int	事件类型，703063
hint	string	请求日志ID，定位问题时需用到
err_code	int	状态码，0为正常，非0代表错误
err_msg	string	错误信息
robot_id	string	机器人id
data.profile_photo	string	头像url
data.gender	int	性别：1男 2女
data.is_verified	bool	是否可加客户好友：true可加；false不可加（非实名账号，无法加客户为好友）
data.real_name	string	实名姓名
data.alias	string	别名
data.base64_alias	string	BASE64编码过后的用户别名
data.name	string	姓名
data.base64_name	string	BASE64编码过后的用户姓名
data.share_sn	string	分享编号

完整请求示例：

curl -X POST \
  https://$basehost/gateway/qopen/AddShareFriend \
  -H 'Content-Type: application/json; charset=UTF-8' \
  -H 'Token: c2NdxDHKXIJ5j1zrhJeq2eJEHjh9xxx' \
  -d '{   
        "robot_id":"机器人id",
        "share_sn":"客户id",
        "message":"你好"
}'

← 收到同事共享的客户回调 - 703007 获取机器人状态 →