企业视角明文客户ID转换服务商视角的密文客户ID
最后更新:2025/12/22企业可通过此接口将企业视角的明文客户ID转换为服务商视角的密文客户ID,支持客户场景和群客户场景。
企业需先安装本服务商的代开发应用,客户联系场景中,external_userid对应的添加人需要在代开发应用可见范围内;微信客服场景中,仅支持48小时内客服会话的external_userid
请求方式: POST(HTTPS)
请求地址: https://open.wshoto.com/openapi/customer/plain_text_eid_to_replace_eid?access_token=x
Query参数:
| 参数 | 类型 | 必填 | 说明 |
|---|---|---|---|
| access_token | string | 是 | 调用接口凭证 |
Body参数:
{
"external_ids": ["customer_001", "customer_002"],
"source": "CUSTOMER",
"chat_id": null
}
| 参数 | 类型 | 必填 | 说明 |
|---|---|---|---|
| external_ids | string[] | 是 | 明文客户ID external_userid 数组。建议200个,最多不超过1000个。 |
| source | string | 是 | ID来源/场景,只能是 "CUSTOMER" 或 "CHAT", CUSTOMER场景为企微好友客户id、微信客服场景的访客id,CHAT场景为企微客户群里的群客户id |
| chat_id | string | 条件必填 | 客户群ID(仅群客户场景使用),当source=CHAT时必填 |
返回值:
{
"code": 0,
"msg": "Success",
"data": {
"customer_001": "replace_id_001",
"customer_002": "replace_id_002",
"customer_003": "replace_id_003"
}
}
返回说明:
| 参数 | 类型 | 说明 |
|---|---|---|
| code | int | 出错返回码,为0表示成功,非0表示调用失败 |
| msg | string | 返回码描述 |
| data | Map |
转换结果,key为输入的客户ID,value为服务商视角的密文客户ID |