# 好友匹配(通过修改描述)

说明: 当成为好友回调(20001事件)中,无external_user_id时,可调用此接口,修改描述来匹配客户

请求方式:POST

请求地址:https://$basehost/gateway/qopen/MatchAccount

body参数

{
    "robot_id": "机器人id",
  	"account_id_list": ["客户openid", "客户openid2"]
}
字段 类型 必填 说明
robot_id string 机器人
account_id_list array 客户openid

返回值:

{
    "data": {
        "match_list": [
            {
                "account_id": "accIM6YQr3nKTLGH7TJK",
                "union_id": "oDE5puNtiu-SK3EDrQpf0Ypj8",
                "external_user_id": "wm7_KpDgAA061ieAHyjKCyxgtsm"
            }
        ],
        "fail_list": []
    },
    "errcode": 0,
    "errmsg": "",
    "hint": "vCSbRqQoVBhhxuT1ingA"
}
字段 类型 说明
errcode int 错误码
errmsg string 错误描述
match_list list 已经匹配成功的好友列表
match_list.account_id string open_id
match_list.union_id string union_id
match_list.external_user_id string 外部联系人id
fail_list list 匹配失败的好友列表
fail_list.account_id string open_id
fail_list.union_id string union_id
fail_list.external_user_id string 外部联系人id

完整请求示例:

curl -X POST \
  https://$basehost/gateway/qopen/MatchAccount \
  -H 'Content-Type: application/json; charset=UTF-8' \
  -H 'Token: c2NdxDHKXIJ5j1zrhJeq2eJEHjh9xxx' \
  -d '{
    "robot_id": "机器人id",
  	"account_id_list": ["客户openid", "客户openid2"]
}'
最后更新时间: 2025/9/4 17:23:08