外部联系人unionid转换

POST

http://127.0.0.1/cgi-bin/externalcontact/unionid_to_external_userid

第三方应用开发/客户联系/客户管理

最后修改时间：2022-08-30 03:03:36

责任人：未设置

服务商为企业代开发微信小程序的场景，服务商可通过此接口，将微信客户的unionid转为external_userid。

服务商代开发小程序指企业使用的小程序为企业主体的，非服务商主体的小程序。
场景：企业客户在微信端从企业主体的小程序（非服务商应用）登录，同时企业在企业微信安装了服务商的第三方应用，服务商可以调用该接口将登录用户的unionid转换为服务商全局唯一的外部联系人id

权限说明：仅认证企业可调用 unionid（即微信开放平台账号主体）或者openid（即小程序账号主体）至少其中一个需要认证 unionid（unionid的主体为绑定了该小程序的微信开放平台账号主体）或者openid（即小程序账号主体）的主体需与当前企业的主体一致。若传了openid，openid与unionid必须是在同一个小程序获取到的该客户的跟进人必须在应用的可见范围之内

文档ID: 25017
原文档地址：
https://open.work.weixin.qq.com/api/doc/90001/90143/93274

请求参数

Query 参数

access_token

string

调用接口凭证

必需

示例值:

Body 参数application/json

unionid

string

必需

微信客户的unionid

openid

string

必需

微信客户的openid

示例

{
  "unionid": "string",
  "openid": "string"
}

示例代码

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

curl --location -g --request POST 'http://127.0.0.1/cgi-bin/externalcontact/unionid_to_external_userid?access_token={{accesstoken}}' \
--header 'Content-Type: application/json' \
--data-raw '{
    "unionid": "string",
    "openid": "string"
}'

返回响应

🟢200成功

application/json

Body

errcode

integer <int32>

返回码

可选

external_userid

string

可选

该企业的外部联系人ID

errmsg

string

可选

对返回码的文本描述内容

示例

{
  "errcode": 0,
  "external_userid": "string",
  "errmsg": "string"
}

批量获取客户详情

代开发应用external_userid转换