代开发应用external_userid转换

POST

/cgi-bin/externalcontact/to_service_external_userid

企业同时授权了服务商的第三方应用与代开发应用，服务商可使用该接口将代开发应用获取到的external_userid转换为第三方应用的external_userid，从而进行关联映射。若代开发自建应用已升级（升级说明见代开发应用安全性升级），则获取到的external_userid与第三方应用一致，故无须调用该接口。

权限说明：

该企业授权了该服务商第三方应用,且授权的第三方应用具备“企业客户权限->客户基础信息”权限
相应客户的跟进人至少有一个在应用可见范围内或相应客户所属客户群群主至少有一个在应用可见范围内
应用需具备“企业客户权限->客户基础信息”权限

请求参数

Query 参数

Body 参数application/json

示例

{
  "external_userid":"wmAAAAAAA"
}

请求示例代码

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

curl --location --request POST '/cgi-bin/externalcontact/to_service_external_userid?access_token=ACCESS_TOKEN' \
--header 'Content-Type: application/json' \
--data-raw '{
  "external_userid":"wmAAAAAAA"
}'

返回响应

🟢200成功

application/json

Body

示例

{
    "errcode": 0,
    "errmsg": "ok",
    "external_userid": "ooAAAAAAAAAAA"
}

修改于 2025-03-26 09:11:31

第三方主体unionid转换为第三方external_userid

说明