代开发应用external_userid转换

POST

/cgi-bin/externalcontact/to_service_external_userid

第三方应用开发服务端API

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

权限说明：

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

请求示例

Shell

JavaScript

Java

Swift

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

响应示例

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

请求参数

Query 参数

access_token

必需

代开发自建应用的调用接口凭证

示例值:

ACCESS_TOKEN

Body 参数application/json

external_userid

string

必需

代开发自建应用获取到的外部联系人ID

示例

返回响应

🟢200成功

application/json

Body

errcode

integer

返回码

必需

errmsg

string

必需

对返回码的文本描述内容

external_userid

string

必需

该服务商第三方应用下的企业的外部联系人ID

修改于 2023-01-31 09:17:39

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

说明