参考地址:
企业微信帐号ID安全性全面升级 - 接口文档 - 企业微信开发者中心
涉及的ID有corpid、userid、external_userid与unionid,标签ID、客户群成员、微信客户ID
一、corpid转换
https://qyapi.weixin.qq.com/cgi-bin/service/corpid_to_opencorpid?provider_access_token=ACCESS_TOKEN
{
"corpid":"xxxxx"
}
二、userid转换
https://qyapi.weixin.qq.com/cgi-bin/batch/userid_to_openuserid?access_token=ACCESS_TOKEN
{
"userid_list":["aaa", "bbb"]
}
三、external_userid转换
https://qyapi.weixin.qq.com/cgi-bin/externalcontact/get_new_external_userid?access_token=ACCESS_TOKEN
{
"external_userid_list":["xxxxx","yyyyyy"]
}
四、客户群成员转换
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"]
}
五、设置迁移完成
https://qyapi.weixin.qq.com/cgi-bin/service/externalcontact/finish_external_userid_migration?provider_access_token=ACCESS_TOKEN
{
"corpid":"xxxxx"
}
六、unionid查询external_userid
https://qyapi.weixin.qq.com/cgi-bin/service/externalcontact/unionid_to_external_userid_3rd?suite_access_token=ACCESS_TOKEN
{
"unionid":"xxxxx",
"openid":"xxxxx",
"corpid":"xxxxx", //建议尽可能传入corpid参数,可获得更好的性能
}
7、客户标签ID转换
https://qyapi.weixin.qq.com/cgi-bin/idconvert/external_tagid?access_token=ACCESS_TOKEN
{
"external_tagid_list":["TAG_ID1","TAG_ID2","TAG_ID3","TAG_ID4"]
}
8、微信客服ID转换
https://qyapi.weixin.qq.com/cgi-bin/idconvert/open_kfid?access_token=ACCESS_TOKEN
{
"open_kfid_list":["KFID1","KFID2","KFID3","KFID4"]
}