探马OpenAPI

高级筛选接口（新版）

POST

/api/v3/customer/search

提示

具体查询案例可参考：https://tanmarket.feishu.cn/docx/AbQ7dDMchoLRIWxn721cwqyBn2c

请求参数

Header 参数

appId

string

应用 appId

必需

默认值:

timestamp

string

请求时间戳

必需

默认值:

sign

string

请求消息签名值

必需

默认值:

appKey

string

应用 appKey

可选

默认值:

Body 参数application/json

customerId

number

客户id

可选

searchKey

string

搜索内容

可选

企业/姓名/备注/电话

role

string

1负责人 2协作人

可选

salesIdList

array[string]

所属员工

可选

departmentIdList

array[string]

所属部门

可选

createTime

object

创建时间

可选

start

string

开始时间

必需

end

string

结束时间

必需

conditions

object

高级筛选条件

可选

conditionOp

integer

多个条件关系

必需

0 所有 1任一

conditionItems

array [object {3}]

必需

pageSize

integer

分页大小

可选

默认10，最大100

pageNo

integer

页码

可选

默认1，最大100

creditCode

string

统一社会信用代码

可选

精准匹配；该字段未启用时，搜索无效。

示例

{
    "customerId": 513799527504064,
    "searchKey": "测试",
    "role": 1
    "departmentIdList": [
        966461,
        558613
    ],
    "salesIdList": [
        5885555666,
        666666584111
    ],
    "createTime": {
        "start": "2022-12-1300:00:00",
        "end": "2022-12-19 23:59:59"
    },
    "qwCustomerTime": {
        "start": null,
        "end": null
    },
    "qwLastFollowTypes": {
        "start": null,
        "end": null
    },
    "pageNo": 1,
    "pageSize": 100,
    "conditions": {
        "conditionOp": 1,
        "conditionItems": [
            {
                "name": "contentTagIds",
                "op": 6,
                "values": [
                    "d430ec9166e511edb71d00163e06cc86:2l"
                ]
            },
            {
                "name": "tagIds",
                "op": 6,
                "values": [
                    2801078
                ]
            },
            {
                "name": "point_credit",
                "op": 7,
                "values": [
                    "11"
                ]
            },
            {
                "name": "sales_stage",
                "op": 2,
                "values": [
                    474555082656000
                ]
            },
            {
                "name": 30744,
                "op": 2,
                "values": [
                    "15135859545"
                ]
            },
            {
                "name": 30898,
                "op": 2,
                "values": [
                    110101,
                    "北京市/北京市/东城区"
                ]
            },
            {
                "name": 30751,
                "op": 2,
                "values": [
                    "09-01",
                    "09-02",
                    "09-03",
                    "09-04"
                ]
            },
            {
                "name": 31892,
                "op": 2,
                "values": [
                    "单行文本"
                ]
            },
            {
                "name": 31457,
                "op": 3,
                "values": [
                    1
                ]
            },
            {
                "name": 31270,
                "op": 2,
                "values": [
                    4,
                    5,
                    6
                ]
            },
            {
                "name": 32477,
                "op": 0,
                "values": [
                    0,
                    1
                ]
            },
            {
                "name": 31562,
                "op": null,
                "values": [
                    "2022-11-19",
                    "2022-12-19"
                ]
            },
            {
                "name": 31460,
                "op": null,
                "values": [
                    "2022-09-20 14:36:31",
                    "2022-12-19 14:36:31"
                ]
            },
            {
                "name": 31462,
                "op": 2,
                "values": [
                    "2.2"
                ]
            },
            {
                "name": "point_credit",
                "op": 7,
                "values": [
                    "112"
                ]
            }
        ]
    }
}

示例代码

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

curl --location --request POST '/api/v3/customer/search' \
--header 'appId;' \
--header 'timestamp;' \
--header 'sign;' \
--header 'appKey: {{appKey}}' \
--header 'Content-Type: application/json' \
--data-raw '{
    "customerId": 513799527504064,
    "searchKey": "测试",
    "role": 1
    "departmentIdList": [
        966461,
        558613
    ],
    "salesIdList": [
        5885555666,
        666666584111
    ],
    "createTime": {
        "start": "2022-12-1300:00:00",
        "end": "2022-12-19 23:59:59"
    },
    "qwCustomerTime": {
        "start": null,
        "end": null
    },
    "qwLastFollowTypes": {
        "start": null,
        "end": null
    },
    "pageNo": 1,
    "pageSize": 100,
    "conditions": {
        "conditionOp": 1,
        "conditionItems": [
            {
                "name": "contentTagIds",
                "op": 6,
                "values": [
                    "d430ec9166e511edb71d00163e06cc86:2l"
                ]
            },
            {
                "name": "tagIds",
                "op": 6,
                "values": [
                    2801078
                ]
            },
            {
                "name": "point_credit",
                "op": 7,
                "values": [
                    "11"
                ]
            },
            {
                "name": "sales_stage",
                "op": 2,
                "values": [
                    474555082656000
                ]
            },
            {
                "name": 30744,
                "op": 2,
                "values": [
                    "15135859545"
                ]
            },
            {
                "name": 30898,
                "op": 2,
                "values": [
                    110101,
                    "北京市/北京市/东城区"
                ]
            },
            {
                "name": 30751,
                "op": 2,
                "values": [
                    "09-01",
                    "09-02",
                    "09-03",
                    "09-04"
                ]
            },
            {
                "name": 31892,
                "op": 2,
                "values": [
                    "单行文本"
                ]
            },
            {
                "name": 31457,
                "op": 3,
                "values": [
                    1
                ]
            },
            {
                "name": 31270,
                "op": 2,
                "values": [
                    4,
                    5,
                    6
                ]
            },
            {
                "name": 32477,
                "op": 0,
                "values": [
                    0,
                    1
                ]
            },
            {
                "name": 31562,
                "op": null,
                "values": [
                    "2022-11-19",
                    "2022-12-19"
                ]
            },
            {
                "name": 31460,
                "op": null,
                "values": [
                    "2022-09-20 14:36:31",
                    "2022-12-19 14:36:31"
                ]
            },
            {
                "name": 31462,
                "op": 2,
                "values": [
                    "2.2"
                ]
            },
            {
                "name": "point_credit",
                "op": 7,
                "values": [
                    "112"
                ]
            }
        ]
    }
}'

返回响应

🟢200成功

application/json

Body

code

integer

必需

message

string

必需

data

object

必需

totalCount

integer

总数量

必需

totalPage

integer

总页数

必需

pageNo

integer

当前页码

必需

pageSize

integer

页码大小

必需

data

array [object {97}]

必需

signId

number | null

必需

示例

{
  "code": 0,
  "message": "success",
  "data": {
    "totalCount": 1,
    "totalPage": 1,
    "pageNo": 1,
    "pageSize": 30,
    "limit": null,
    "limitType": null,
    "data": [
      {
        "30744": [],
        "30747": "测试客户阶段0001",
        "30750": 0,
        "31560": "编号- 5993831",
        "toOpenSeaName": null,
        "customerAllocateSource": 3,
        "getCreateTime": "2022-12-21 11:50:28",
        "salesStageEndName": null,
        "recoveryReasons": [],
        "remainingProtectionTime": null,
        "followRepeat": false,
        "pvTagId": null,
        "isFailReason": false,
        "customerAbandonReason": null,
        "customerType": 1,
        "toSalesName": null,
        "openSeaTransferRecordId": null,
        "customerSalesInfoId": 515180602083520,
        "salesStage": 480693588891904,
        "replyChatCount": 0,
        "shareFirst": null,
        "id": 515180602083520,
        "remainingProtectionReason": null,
        "salesStageSub": null,
        "contentType": null,
        "areaValue": "",
        "salesStageName": "新入库",
        "rollOutType": null,
        "wechatAvatar": null,
        "unionId": null,
        "lastFollowUserName": null,
        "groupList": [],
        "pointScore": null,
        "toSalesDeptNames": "[]",
        "helperSalesName": "",
        "tags": null,
        "getUpdateTime": "2022-12-21 11:50:34",
        "companyId": null,
        "sendChatCount": 0,
        "friendType": null,
        "followTimeType": 0,
        "salesName": "张磊",
        "externalUserId": null,
        "customerRepoId": 450617011013824,
        "openSeaEditable": true,
        "customerAbandon": null,
        "groupSize": 0,
        "salesStageEnd": null,
        "lastRequestSent": null,
        "birthday": null,
        "toId": null,
        "shield": null,
        "role": "1",
        "tagIds": null,
        "requestSent": false,
        "shareSource": 453638473541824,
        "salesDeptNames": "[\"江鑫祥科技/洋洋洋部门电商的就是看到第三节课京东数科建东加竞赛课\"]",
        "channelState": "",
        "customerRecovery": "-1",
        "customerStatus": 0,
        "helperSalesDeptNames": "[]",
        "protectedTime": 0,
        "salesId": 453638473541824,
        "enterSeaReason": "新建/导入",
        "enterSeaType": 4,
        "deleteStatus": null,
        "salesDeleted": false,
        "customerId": 515180602015936,
        "isFriend": false,
        "protect": 0,
        "qwRemark": "测试客户阶段0001",
        "corpNameShort": null,
        "shareFollows": [],
        "mainFollows": [
          {
            "salesId": 453638473541824,
            "salesName": "张磊",
            "followDeptNames": "[\"江鑫祥科技/洋洋洋部门电商的就是看到第三节课京东数科建东加竞赛课\"]",
            "isFriend": false,
            "salesAvatar": "http://wework.qpic.cn/bizmail/hJO6Tic8PhQcl9UzETs8pPAp04CF2VyterhN1uS7DwVZALY0gb1Qgcw/0"
          }
        ],
        "abandonTime": null,
        "toType": null,
        "corpName": null,
        "qwSalesId": "ZhangLei",
        "fromId": null,
        "isCustomer": 1,
        "lastFollowUserId": null,
        "signNum": 0,
        "phoneRepeat": false,
        "deleted": 0,
        "areaId": null,
        "createTime": "2022-12-21 11:50:28",
        "wechatNickname": null,
        "location": null,
        "salesStageSubName": null,
        "stageFlowId": 511292156367040,
        "contentTags": [],
        "pointCredit": null
      }
    ],
    "signId": null
  }
}

修改于 2023-11-03 02:34:06

推送注册接口

查询没有群聊的客户