tboss_oa_module/docs/wecom/server/自建应用与智能机器人的对接.md

自建应用与智能机器人的对接

最后更新：2026/05/20

将智能机器人获取的密文open_userid转换为明文userid。
请求方式：POST（HTTPS）
请求地址：https://qyapi.weixin.qq.com/cgi-bin/batch/openuserid_to_userid?access_token=ACCESS_TOKEN

请求参数：

{
  "open_userid_list":["xxx", "yyy"]
}

参数说明：

参数	必须	说明
access_token	是	企业自建应用的调用接口凭证。获取方法查看“获取access_token”
open_userid_list	是	企业主体下加密的userid列表，最多不超过1000个。

权限说明：

需要使用自建应用的access_token
成员需要在access_token所对应应用的可见范围内

返回结果：

{
    "errcode": 0,
    "errmsg": "ok",
    "userid_list": [
        {
            "open_userid": "xxx",
            "userid": "aaa"
        }
    ],
    "invalid_open_userid_list":["yyy"]
}

参数说明：

参数	说明
errcode	返回码
errmsg	对返回码的文本描述内容
userid_list	明文userid
userid_list.open_userid	转换成功的open_userid
userid_list.userid	转换成功的open_userid对应的userid
invalid_open_userid_list	不合法的open_userid列表。如果传入的已是明文的userid，也会在该列表返回