企业视角明文客户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

results matching ""

    No results matching ""