转换external_userid

POST

https://qyapi.weixin.qq.com/cgi-bin/externalcontact/get_new_external_userid

权限说明：

该企业授权了该服务商第三方应用
客户联系和家校场景中，external_userid对应的跟进人需要在应用可见范围内
微信客服场景中，仅支持48小时内客服会话的external_userid

如果传入了新的external_userid，则原样返回。

请求示例

Shell

JavaScript

Java

Swift

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]

必需

旧外部联系人id列表，建议200个，最多不超过1000个

示例

返回响应

🟢200成功

application/json

Body

errcode

integer

返回码

必需

errmsg

string

必需

对返回码的文本描述内容

items

array [object {2}]

必需

external_userid

string

必需

new_external_userid

string

新外部联系人id

必需

修改于 2022-12-05 08:33:24

同意授权转换external_userid事件

转换客户群成员external_userid