企微中台聊天记录页的客户列表

更新时间：2025-04-15 17:16:18

接口说明

企微中台聊天记录页的客户列表

基本信息

请求方式： GET

请求路径：

https://prod.open-api.mysre.cn/szmc/qw-nbd-api/list-chat-external-user

请求参数

参数名 参数位置 参数类型 必填 默认值 示例 描述
app_id query string 是 企微中台应用 id
keyword query string 否 搜索客户的关键词，如客户姓名、手机等
custom_condition query string 否 自定义查询条件，json 字符串，接入方可识别的格式，由接入方前后端自行约定格式
pager.page query number 否 页码，默认为 1
pager.page_size query number 否 分页行数，默认为 10

请求示例

get /qw-nbd-api/list-chat-external-user?key1=value1&key2=value2

返回成功示例

{
    "errcode": 0,
    "errmsg": "ok",
    "total": "100",
    "external_users": [
        {
            "external_userid": "xa",
            "name": "喵大壮",
            "avatar": "https://xxxx",
            "type": 1,
            "corp_name": "明源云"
        },
        {
            "external_userid": "string",
            "name": "string",
            "avatar": "string",
            "type": -45530,
            "corp_name": "string"
        }
    ]
}

返回参数说明（成功）

参数名 参数类型 描述
errcode number
errmsg string
total string
external_users array
external_users.external_userid string
external_users.name string
external_users.avatar string
external_users.type number
external_users.corp_name string

失败返回示例

{
    "errcode": 200,
    "errmsg": "ok",
}

返回参数说明（失败）

参数名 参数类型 描述

results matching ""

    No results matching ""