# 机器人扫码入群(平台号)

[异步回调] 机器人扫码入群

请求方式:POST

请求地址:https://api.aquanliang.com/gateway/qopen/JoinGroupByScanQRCode

body参数

{
    "robot_id": "机器人id",
    "group_qr_code": "群聊二维码",
    "group_qr_code_base64":"群聊二维码base64值"
}
字段 类型 必填 说明
robot_id string 机器人id
group_qr_code string 群聊二维码
group_qr_code_base64 string 群聊二维码base64值,如果group_qr_code,group_qr_code_base64都传,默认使用group_qr_code

返回值:

{
    "data": {
        "serial_no": "操作序列号"
    },
    "errcode": 0,
    "errmsg": ""
}

返回说明

字段 类型 说明
errcode int 状态码,0为正常,非0代表错误
errmsg string 错误信息
serial_no string 操作序列号

处理结果,异步返回值:

{
    "event_type": 300018,
    "serial_no": "操作序列号",
    "err_code": 0,
    "err_msg": "success",
    "robot_id": "机器人id",
    "data": {
        "group_id" : "成功入群的群编号",
        "group_qr_code": "群聊二维码",
        "group_type": 1
    }
}

返回说明

字段 类型 说明
event_type int 事件类型,300018
serial_no string 操作序列号
err_code int 状态码,0为正常,非0代表错误
err_msg string 错误信息
robot_id string 机器人id
data object 返回数据
data.group_id string 成功入群的群编号
data.group_qr_code string 群聊二维码
data.group_type int 群聊类型:0外部群,1内部群(扫码号暂无无法获取该字段)

完整请求示例:

curl -X POST \
  https://api.aquanliang.com/gateway/qopen/JoinGroupByScanQRCode \
  -H 'Content-Type: application/json; charset=UTF-8' \
  -H 'Token: c2NdxDHKXIJ5j1zrhJeq2eJEHjh9xxx' \
  -d '{
    "robot_id": "机器人id",
    "group_qr_code": "xx",
    "group_qr_code_base64":"xxx"
}'