- 开发指南
- 基础接口
- 客户设置
- 消息推送
- 客户&线索&待分配
- 公海
- 企微组织架构
- 企微标签库
- 企业
- 合同
- 电商平台
- 营销
- 数据统计
- 内容访客
- 电销手机
- SOP任务
- 群发消息
- 管控
- 工单
- 素材
- 应用通知
- 附录
- 群数据
- 店主活码
- 通话列表
公海客户高级筛选列表
POST
/api/v3/highSea/customer/search
请求参数
Header 参数
appId
string
应用 appId
默认值:
{{appId}}
timestamp
string
请求时间戳
默认值:
{{timestamp}}
sign
string
请求消息签名值
默认值:
{{sign}}
appKey
string
应用 appKey
默认值:
{{appKey}}
Body 参数application/json
repoId
number
公海库id
示例值:
568431323435073
searchKey
string
查询关键词
refreshCustomerId
number
customerId
departmentIds
array[string]
前负责人部门id
salesIds
array[string]
前负责人id
openSeaTime
object
进入公海时间
start
string
开始时间
示例值:
2023-11-26 23:59:59
end
string
结束时间
示例值:
2023-11-26 23:59:59
createTime
object
客户创建时间
start
string
开始时间
示例值:
2023-11-26 23:59:59
end
string
结束时间
示例值:
2023-11-26 23:59:59
conditions
object
可选
conditionOp
integer
多个条件关系
conditionItems
array [object {4}]
必需
pageSize
integer
分页大小
默认值:
30
pageNo
integer
页码
默认值:
1
sortField
string
排序字段
示例值:
open_sea_time
sortDir
integer
排序方式
示例值:
1
示例
{
"repoId": 489763275397313,
"isCustomer": 1,
"searchKey": "",
"authId": 10411,
"openSeaTime": null,
"createTime": null,
"conditions": {
"conditionOp": 1,
"conditionItems": [
{
"name": 100156,
"op": 2,
"fieldType": 1,
"values": [
"test"
]
},
{
"name": 100313,
"op": 0,
"fieldType": 5,
"values": [
"test"
]
},
{
"name": 100159,
"op": 2,
"fieldType": 2,
"values": [
1
]
},
{
"name": 100168,
"op": 2,
"fieldType": 9,
"values": [
110100,
"北京市/北京市"
]
}
]
},
"pageSize": 50,
"pageNo": 1,
"sortField": "open_sea_time",
"sortDir": 1
}示例代码
Shell
JavaScript
Java
Swift
Go
PHP
Python
HTTP
C
C#
Objective-C
Ruby
OCaml
Dart
R
请求示例请求示例
Shell
JavaScript
Java
Swift
curl --location --request POST '/api/v3/highSea/customer/search' \
--header 'appId;' \
--header 'timestamp;' \
--header 'sign;' \
--header 'appKey: {{appKey}}' \
--header 'Content-Type: application/json' \
--data-raw '{
"repoId": 489763275397313,
"isCustomer": 1,
"searchKey": "",
"authId": 10411,
"openSeaTime": null,
"createTime": null,
"conditions": {
"conditionOp": 1,
"conditionItems": [
{
"name": 100156,
"op": 2,
"fieldType": 1,
"values": [
"test"
]
},
{
"name": 100313,
"op": 0,
"fieldType": 5,
"values": [
"test"
]
},
{
"name": 100159,
"op": 2,
"fieldType": 2,
"values": [
1
]
},
{
"name": 100168,
"op": 2,
"fieldType": 9,
"values": [
110100,
"北京市/北京市"
]
}
]
},
"pageSize": 50,
"pageNo": 1,
"sortField": "open_sea_time",
"sortDir": 1
}'返回响应
🟢200成功
application/json
Body
code
integer
必需
message
string
必需
data
object
必需
totalCount
integer
总条数
totalPage
integer
总页数
pageNo
integer
当前页数
pageSize
integer
每页条数
data
array [object {50}]
必需
示例
{
"code": 0,
"message": "success",
"data": {
"totalCount": 1872276,
"totalPage": 374456,
"pageNo": 1,
"pageSize": 5,
"limit": null,
"limitType": null,
"data": [
{
"30744": [
"178787878773483"
],
"30750": 0,
"33355": "",
"33386": "",
"33489": "7443683",
"33530": "",
"33586": "赵加超",
"toOpenSeaName": null,
"customerAllocateSource": 2,
"getCreateTime": "2023-10-30 19:39:51",
"salesStageEndName": null,
"hasExternalContactUser": true,
"pvTagId": null,
"isFailReason": false,
"replyChatCount": 0,
"shareFirst": null,
"id": 570622753257792,
"wechatAvatar": null,
"groupList": [
{
"chatId": "wr2ohRCAAA57lIf4vdNHZTx-pn0HvylA",
"ownerName": null,
"chatName": "新的专属群002",
"ownerId": "547030947547456"
}
],
"pointScore": 10001,
"isAdmin": false,
"tags": null,
"externalUserId": null,
"customerAbandon": 445499848397010,
"salesStageEnd": null,
"shield": null,
"role": "1",
"requestSent": false,
"shareSource": 547030947547456,
"customerRecovery": "-1",
"salesId": 547030947547456,
"enterSeaReason": "没有需求",
"enterSeaType": 2,
"salesDeleted": false,
"customerId": 567251773626560,
"protect": 0,
"33586#json": {
"name": "赵加超",
"id": 5
},
"qwRemark": null,
"toType": null,
"qwSalesId": "HeZhangBiao",
"lastFollowUserId": null,
"phoneRepeat": false,
"deleted": 0,
"areaId": null,
"createTime": "2023-10-11 16:37:21",
"stageFlowId": null,
"contactNums": 5,
"recoveryReasons": [],
"remainingProtectionTime": null,
"followRepeat": false,
"customerAbandonReason": "没有需求",
"customerType": 2,
"toSalesName": null,
"openSeaTransferRecordId": null,
"customerSalesInfoId": 570622753257792,
"salesStage": 480693588891904,
"openSeaTime": "2023-10-31 19:33:21",
"remainingProtectionReason": null,
"salesStageSub": null,
"contentType": null,
"areaValue": "",
"salesStageName": "新入库的客户好好服务",
"rollOutType": null,
"unionId": null,
"lastFollowUserName": null,
"toSalesDeptNames": "[]",
"getUpdateTime": "2023-10-31 19:33:21",
"companyId": 451891311847616,
"contactList": [
{
"wechatAvatar": "https://wework.qpic.cn/wwpic/515446_74J_CtnVQL6h8Tw_1695118140/0",
"followerSalesName": null,
"corpid": "wwd074f3968f56dcb0",
"contactId": 567238332844352,
"followerSalesId": null,
"requestSent": false,
"salesDeleteCus": 0,
"customerName": "何长彪",
"phoneNumbers": [],
"friendApplyTime": null,
"cusDeleteSales": 0,
"chatAgree": 1,
"qwCustomerTime": "2023-10-11 16:31:31",
"sendChatCount": 0,
"customerType": 2,
"externalUserId": "wo2ohRCAAAVfmsqTjwnPlKLFuPcntM8w",
"qwLastFollowTime": "2023-10-20 11:05:14",
"deleteStatus": null,
"customerId": 567251773626560,
"replyChatCount": 0,
"wechatNickname": "何长彪",
"gmtCreateTime": "2023-10-11 16:37:22"
}
],
"sendChatCount": 0,
"friendType": null,
"salesName": "何长彪",
"customerRepoId": 445499822248128,
"openSeaEditable": false,
"groupSize": 7,
"lastRequestSent": null,
"birthday": null,
"toId": null,
"tagIds": null,
"salesDeptNames": "[\"江鑫祥科技/changb\"]",
"chatAgree": 1,
"customerStatus": 1,
"protectedTime": 0,
"deleteStatus": null,
"isFriend": false,
"nonFollowUpTime": null,
"corpNameShort": null,
"isEncryptPhone": false,
"abandonTime": "2023-10-31 19:33:21",
"corpName": "北京科汇佳兴科技有限公司",
"fromId": null,
"isCustomer": 2,
"signNum": 0,
"wechatNickname": null,
"location": null,
"customerRepoName": "默认公海库",
"salesStageSubName": null,
"contentTags": []
},
{
"30744": [],
"30747": "玛卡巴卡",
"30750": 6,
"30751": "2023-07-01",
"30888": [
"北京什刹海紫檀文化酒店-会议厅（北京市西城区兴华胡同42号）"
],
"31649": "[36,38]",
"32277": "https://blueh5.wechatsi.com/fdfsServer/group1/M00/04/7F/rBIAY2TByu-AYNpXAADryTAtaDk026.png",
"32428": 110101,
"32633": 2,
"33165": "[36,40]",
"33355": "0岁",
"33361": "12",
"33386": "0岁4个月",
"33457": "-3.0",
"33489": "6965127",
"33530": "",
"toOpenSeaName": null,
"customerAllocateSource": 2,
"getCreateTime": "2023-10-10 15:31:01",
"salesStageEndName": null,
"pvTagId": null,
"isFailReason": false,
"replyChatCount": 0,
"shareFirst": false,
"id": 567053233629376,
"wechatAvatar": null,
"groupList": [],
"pointScore": null,
"isAdmin": false,
"tags": null,
"externalUserId": null,
"customerAbandon": 445499848397012,
"fullAddress": [
{
"address": "北京什刹海紫檀文化酒店-会议厅（北京市西城区兴华胡同42号）",
"latitude": 39.93453272,
"locationAddress": "北京市西城区兴华胡同42号",
"longitude": 116.38084936
}
],
"salesStageEnd": null,
"shield": false,
"role": "1",
"requestSent": false,
"shareSource": 528469526159680,
"customerRecovery": "-1",
"salesId": 528469526159680,
"enterSeaReason": "我的公海库",
"enterSeaType": 3,
"salesDeleted": false,
"customerId": 552898432088256,
"protect": 0,
"qwRemark": "玛卡巴卡",
"toType": null,
"qwSalesId": "WangYu",
"lastFollowUserId": null,
"phoneRepeat": false,
"deleted": 0,
"areaId": 110101,
"createTime": "2023-07-22 15:38:57",
"stageFlowId": 532902040193344,
"pointCredit": null,
"recoveryReasons": [],
"remainingProtectionTime": null,
"followRepeat": false,
"customerAbandonReason": null,
"customerType": 1,
"toSalesName": null,
"openSeaTransferRecordId": null,
"customerSalesInfoId": 567053233629376,
"salesStage": 480693588891904,
"openSeaTime": "2023-10-31 15:49:00",
"remainingProtectionReason": null,
"salesStageSub": null,
"contentType": null,
"areaValue": "北京市/北京市/东城区",
"salesStageName": "新入库的客户好好服务",
"rollOutType": null,
"unionId": null,
"lastFollowUserName": null,
"toSalesDeptNames": "[]",
"getUpdateTime": "2023-10-31 15:49:00",
"companyId": null,
"sendChatCount": 0,
"friendType": null,
"salesName": "王瑜",
"customerRepoId": 445499822248128,
"openSeaEditable": false,
"groupSize": 0,
"lastRequestSent": null,
"birthday": "2023-07-01",
"toId": null,
"tagIds": null,
"salesDeptNames": "[\"江鑫祥科技/Gerow部门\"]",
"chatAgree": null,
"customerStatus": 7,
"protectedTime": 0,
"deleteStatus": null,
"isFriend": false,
"nonFollowUpTime": null,
"corpNameShort": null,
"isEncryptPhone": false,
"abandonTime": "2023-10-28 17:36:36",
"corpName": null,
"fromId": null,
"isCustomer": 1,
"signNum": 0,
"wechatNickname": null,
"location": null,
"customerRepoName": "默认公海库",
"salesStageSubName": null,
"contentTags": []
}
],
"signId": null,
"channelAnalyzeTotalCount": null
}
}修改于 2023-11-20 09:28:49