external_userid的转换-转换客户external_userid

将企业主体下的external_userid转换为服务商主体下的external_userid。

权限说明：

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

如果传入了服务商主体下的external_userid，则原样返回。

curl --location --request POST 'https://qyapi.weixin.qq.com/cgi-bin/externalcontact/get_new_external_userid' \ --header 'Content-Type: application/json' \ --data-raw '{ "external_userid_list":["xxxxx","yyyyyy"] }'

{ "errcode": 0, "errmsg": "ok", "items": [ { "external_userid": "xxxxx", "new_external_userid": "AAAA" }, { "external_userid": "yyyyy", "new_external_userid": "BBBB" } ] }

请求参数

Query 参数

access_token

string

可选

代开发自建应用或第三方应用的接口凭证，服务商可通过“获取企业access_token”获得此调用凭证

示例值:

ACCESS_TOKEN

Body 参数application/json

external_userid_list

array[string]

必需

企业主体下的external_userid列表，建议200个，最多不超过1000个

示例

application/json

Body

errcode

integer

返回码

必需

errmsg

string

必需

对返回码的文本描述内容

items

array [object {2}]

必需

external_userid

string

必需

new_external_userid

string

必需

服务商主体下的external_userid

external_userid的转换-转换客户external_userid

请求参数

返回响应