第三方应用开发 服务端API 账号ID ID转换接口 external_userid的转换
external_userid的转换
最后更新:2022/11/03
可联系渠道经理采购或代理智慧硬件接口已支持设备 联系渠道经理
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的关联