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

将应用获取的外部用户临时idtmp_external_userid,转换为external_userid。

支持将以下业务类型(business_type)对应接口获取到的tmp_external_userid进行转换:

业务类型描述相关接口
1会议获取会议详情
2收集表收集表的统计信息查询
读取收集表答案
3文档获取记录

 

支持对以下用户类型(user_type)进行转换:

用户类型描述转换范围
1客户应用可见范围内,配置了客户联系功能的企业成员所添加的外部联系人
2企业互联共享应用配置共享范围内的成员
3上下游共享应用配置共享范围内的成员
4互联企业(圈子)管理后台配置的应用可见范围内的成员

 

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

请求参数:

{
  "business_type": 1,
  "user_type": 1,
  "tmp_external_userid_list": [
    "ouXXX1",
    "ouXXX2",
    "ouXXX3"
  ]
}

参数说明:

参数类型必须说明
access_tokenstring调用接口凭证
business_typeuint32业务类型。1-会议 2-收集表
user_typeuint32转换的目标用户类型。1-客户 2-企业互联 3-上下游 4-互联企业(圈子)
详见上面关于user_type的说明
tmp_external_userid_liststring[]外部用户临时id,最多不超过100个

权限说明:

调用此接口的应用,和获取到tmp_external_userid的应用必须是同一个
支持自建应用、代开发自建应用和第三方应用调用
user_type为1(即客户类型),应用还需要具有「客户联系」权限

返回结果:

{
  "errcode": 0,
  "errmsg": "ok",
  "results": [
    {
      "tmp_external_userid": "ouXXX1",
      "external_userid": "EXTERNAL_USER_ID"
    },
    {
      "tmp_external_userid": "ouXXX2",
      "corpid": "CORPID",
      "userid": "USERID"
    }
  ],
  "invalid_tmp_external_userid_list": [
    "ouXXX3"
  ]
}

 

参数说明:

参数类型说明
errcodeint32返回码
errmsgstring对返回码的文本描述内容
resultsobj[]转换成功的结果列表
results[].tmp_external_useridstring输入的tmp_external_userid
results[].external_useridstring转换后的userid,user_type为1时返回
results[].corpidstringuserid对应的corpid,user_type为2、3、4时返回
results[].useridstring转换后的userid,user_type为2、3、4时返回
invalid_tmp_external_userid_liststring[]无法转换的tmp_external_userid。可能非法或没有权限

 

上一篇微信客服ID的转换
下一篇ID迁移完成状态的设置
    本节内容
服务端API
基础
数据与智能专区
应用接收专区通知
连接微信
客户联系
办公
小程序接入对外收款
客户端API
小程序
基础
连接微信
办公
WECOM-JSSDK
JS-SDK
基础
连接微信
办公
更新日志
联系我们