API接口文档

系统wxid转换企业微信外部联系人externalUserId

GET

/api/v1/customer/wxid_to_externalUserId

功能说明：

本接口可以将客户的系统wxid（imcontact）转化为（externalUserId）企业微信外部联系人id

请求参数

Query 参数

token

string

接口调用凭证

必需

wxid

string

系统客户联系人id

必需

imBotId

string

可选

Body 参数application/json

object {0}

示例

{}

示例代码

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

curl --location --request GET '/api/v1/customer/wxid_to_externalUserId?token=&wxid=&imBotId=' \
--header 'Content-Type: application/json' \
--data-raw ''

返回响应

🟢200成功

application/json

Body

errcode

number

返回码

必需

-1 查询联系人异常 -3 未找到联系人

errmsg

string

对返回码的文本描述内容

必需

externalUserId

string

客户的企业微信外部联系人id

必需

（注：不同主体下，相同客户的externalUserId也是不一样的）

示例

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

修改于 2025-04-03 02:37:25

企业微信外部联系人externalUserId转系统wxid

删除客户接口