批量unionId，openId转换客户externalUserId，

请求参数

Header 参数

Authorization

string <string>

认证令牌

必需

示例值:

Bearer 64FMJbvkyQC2EHY

Body 参数application/json

array of:

unionId

string <string>

必需

微信开放平台下用户id，最长64位
注意：
1、微信开放平台账号主体需认证，且与当前授权企业主体名称一致，
2、openId与unionId必须是在同一个应用获取到的
Validate[max: 64; ]

openId

string <string>

必需

微信公众平台下用户id，最长64位
注意：
1、小程序或服务号账号主体需认证，且与当前授权企业主体名称一致
2、openId与unionId必须是在同一个应用获取到的
Validate[max: 64; ]

示例

[
  {
    "unionId": "",
    "openId": ""
  }
]

示例代码

Shell

JavaScript

Java

Swift

Go

PHP

Python

HTTP

C

C#

Objective-C

Ruby

OCaml

Dart

R

curl --location --request POST 'https://w.xiaoliebian.com/api/demo-wechat-work/open/api/customer/unionId-batch-convert' \
--header 'Authorization: Bearer 64FMJbvkyQC2EHY' \
--header 'Content-Type: application/json' \
--data-raw '[
  {
    "unionId": "",
    "openId": ""
  }
]'

返回响应

🟢200OK

application/json

Body

array of:

success

boolean

成功标识

可选

示例值:

true

code

integer <int32>

错误编码

可选

示例值:

0

msg

string <string>

错误信息

可选

示例值:

value

array[object (WecomOpenAppCustomerUnionIdBatchConvertResponse_response) {5}]

返回对象

可选

unionId

string <string>

可选

微信开放平台下用户id

示例值:

openId

string <string>

可选

微信公众平台下用户id

示例值:

externalUserId

string <string>

可选

externalUserId，转换成功时有值
注意：
1、是企业外部群成员，企业成员客户时有值不是企业客户时无值，
2、该客户的跟进人或其所在客户群群主必须在应用的可见范围之内

示例值:

status

string <enum>

可选

转换状态
0：成功
1：失败
(See: 接口类型)

示例值:

SUCCESS

reason

string <string>

可选

失败原因
注意：转换失败时有值

示例值:

traceId

string <string>

链路ID

可选

示例值:

示例

[
    {
        "success": false,
        "code": 43,
        "msg": "elit ex incididunt id",
        "value": [
            {
                "unionId": "19",
                "openId": "46",
                "externalUserId": "7",
                "status": 1,
                "reason": "officia cupidatat"
            }
        ],
        "traceId": "9"
    }
]