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

目录

  • 转换客户external_userid
  • 转换客户群成员external_userid
  • 将企业主体下的external_userid转换为服务商主体下的external_userid。

    转换客户external_userid

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

    请求参数:

    {
      "external_userid_list":["xxxxx","yyyyyy"]
    }

    参数说明:

    参数必须说明
    access_token代开发自建应用或第三方应用的接口凭证,服务商可通过“获取企业access_token”获得此调用凭证
    external_userid_list企业主体下的external_userid列表,建议200个,最多不超过1000个

    权限说明:

    仅代开发自建应用或第三方应用可调用
    客户联系和家校场景中,external_userid对应的跟进人需要在应用可见范围内
    微信客服场景中,仅支持48小时内客服会话的external_userid
    若是第三方应用且已设置externaluserid迁移完成,禁止调用本接口

    返回结果:

    
     "errcode":0,
     "errmsg":"ok",
     "items":[
     	{
     		"external_userid":"xxxxx",
     		"new_external_userid":"AAAA"
     	},
     	{
     		"external_userid":"yyyyy",
     		"new_external_userid":"BBBB"
     	}
     ]
    
    如果传入了服务商主体下的external_userid,则原样返回。

    参数说明:

    参数说明
    errcode返回码
    errmsg对返回码的文本描述内容
    new_external_userid服务商主体下的external_userid

    转换客户群成员external_userid

    转换客户external_userid接口不支持客户群的场景,如果需要转换客户群中无好友关系的群成员external_userid,需要调用本接口,调用时需要传入客户群的chat_id。

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

    请求参数:

    {
      "chat_id":"wrOgQhDgAAMYQiS5ol9G7gK9JVAAAA",
      "external_userid_list":["xxxxx","yyyyyy"]
    }

    参数说明:

    参数必须说明
    access_token代开发自建应用或第三方应用的接口凭证,服务商可通过“获取企业access_token”获得此调用凭证
    chat_id客户群ID
    external_userid_list企业主体下的external_userid列表,建议200个,最多不超过1000个

    权限说明:

    仅代开发自建应用或第三方应用可调用
    客户群的群主需要在应用可见范围内
    若是第三方应用且已设置externaluserid迁移完成,禁止调用本接口

    返回结果:

    
     "errcode":0,
     "errmsg":"ok",
     "items":[
     	{
     		"external_userid":"xxxxx",
     		"new_external_userid":"AAAA"
     	},
     	{
     		"external_userid":"yyyyy",
     		"new_external_userid":"BBBB"
     	}
     ]
    
    如果传入了新的external_userid,则原样返回。

    参数说明:

    参数说明
    errcode返回码
    errmsg对返回码的文本描述内容
    new_external_userid服务商主体下的external_userid
    上一篇userid的转换
    下一篇unionid与external_userid的关联
      本节内容
    服务端API
    基础
    数据与智能专区
    应用接收专区通知
    连接微信
    客户联系
    办公
    小程序接入对外收款
    客户端API
    小程序
    基础
    连接微信
    办公
    WECOM-JSSDK
    JS-SDK
    基础
    连接微信
    办公
    更新日志
    联系我们