获取门店活码客户记录列表

GET

/open-api/contact_way/region/record/list

按门店活码配置 hid 查询客户添加及进群记录，支持按门店名称、员工 ID、客户昵称筛选。客户昵称筛选使用 contact_way_region_add_record.eu_name 的 SQL 模糊匹配，不使用 ES。

请求参数

Authorization

Query 参数

请求示例代码

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

curl --location --globoff 'https://open.weibanzhushou.com/open-api/contact_way/region/record/list?config_hid=undefined&page_no=undefined&page_size=undefined&region_name=undefined&staff_ext_id=undefined&external_user_name=undefined&access_token='

返回响应

🟢200

application/json

HTTP 200 表示请求已被服务处理，需通过 errcode 判断业务成功或失败。

Bodyapplication/json

示例

成功示例config_hid 异常示例

{
    "errcode": 0,
    "errmsg": "ok",
    "total": 1,
    "customer_list": [
        {
            "unionid": "oXx1234567890",
            "external_user_name": "王小明",
            "region_name": "上海南京西路店",
            "tags": [
                "高意向",
                "会员"
            ],
            "tag_list": [
                {
                    "ext_id": "etV5KHqL0CMf",
                    "name": "高意向"
                },
                {
                    "ext_id": "etV5KHqL0CMe",
                    "name": "会员"
                }
            ],
            "staff_ext_id": "zhangsan",
            "staff_name": "张三",
            "add_time": 1715335200,
            "staff_deleted_at": null,
            "external_user_deleted_at": null,
            "join_time": 1715338800,
            "deleted_time": null
        }
    ]
}

修改于 2026-05-12 07:06:32

获取门店活码下的门店列表