第三方应用开发
基础
数据与智能专区
应用接收专区通知
连接微信
客户联系
办公
小程序接入对外收款
第三方应用开发
服务端API
账号ID
ID转换接口
userid的转换
userid的转换
最后更新:2026/05/21

已明确企业身份场景

将企业主体下的明文userid转换为服务商主体下的密文userid。

请求方式:POST(HTTPS
请求地址:https://qyapi.weixin.qq.com/cgi-bin/batch/userid_to_openuserid?access_token=ACCESS_TOKEN

请求参数:

{
  "userid_list":["aaa", "bbb"]
}

参数说明:

参数必须说明
access_token代开发自建应用或第三方应用的接口凭证,服务商可通过“获取企业access_token”获得此调用凭证
userid_list获取到的成员ID列表,最多不超过1000个

权限说明:

仅代开发应用或第三方应用可调用
成员需要在应用的可见范围内
请确保传入userid的正确性,若出错的次数较多,会导致1天不可调用,(具体限制阈值由授权企业的员工规模决定)。

返回结果:

{
    "errcode": 0,
    "errmsg": "",
    "open_userid_list": [
        {
            "userid": "aaa",
            "open_userid": "xxxxx"
        }
    ],
    "invalid_userid_list":["bbb"]
}

参数说明:

参数说明
errcode返回码
errmsg对返回码的文本描述内容
open_userid_list该服务商主体下的密文userid
open_userid_list.userid转换成功的userid
open_userid_list.open_userid转换成功的userid对应的服务商主体下的密文userid

未明确企业身份场景

将企业主体下的加密userid转换成服务商主体下的open_userid。

请求方式:POST(HTTPS
请求地址:https://qyapi.weixin.qq.com/cgi-bin/service/batch/userid_to_openuserid?provider_access_token=PROVIDER_ACCESS_TOKEN
请求参数:

{
  "open_userid_list":["wojigengoegeojgoe","wosgjeiogng"],
  "source_botid":"BOTID"
}

参数说明:

参数必须说明
provider_access_token应用服务商的接口调用凭证,获取方法参见服务商的凭证
open_userid_list企业主体下的加密userid,最多不超过1000个
source_botid企业智能机器人ID

权限说明:

open_userid需要在智能机器人的可见范围内
智能机器人所在企业需要安装服务商的第三方应用或者代开发应用,且传入的open_userid需要在已安装的应用可见范围内

返回结果:

{
  "errcode": 0,
  "errmsg": "ok",
  "items": [
    {
      "userid": "woxxxx",
      "open_userid": "wonewxxxx"
    }
  ],
  "open_corpid": "wpxnigenogneg",
  "invalid_open_userid_list": [
    "userid",
    "userid1"
  ]
}

参数说明:

参数说明
errcode返回码
errmsg对返回码的文本描述内容
open_corpid智能机器人所在企业ID
itemsID转换结果
items.userid企业主体下的加密userid
items.open_userid服务商主体下的加密userid
invalid_open_userid_list无法转换的open_userid列表。如果传入的是明文userid,也会在这个列表中返回
上一篇corpid的转换
下一篇external_userid的转换
    本节内容
服务端API
基础
数据与智能专区
应用接收专区通知
连接微信
客户联系
办公
小程序接入对外收款
客户端API
小程序
基础
连接微信
办公
JS-SDK
基础
连接微信
办公
数据API
更新日志
联系我们