探马OpenAPI
  1. 公海
探马OpenAPI
  • 开发指南
    • 开发前必读
    • 对接地址说明
    • 调用说明
    • 接口鉴权说明
    • 对接测试
      POST
  • 基础接口
    • 获取客户id
      POST
    • 获取员工id
      POST
    • 自动开启探马账号及绑定互通账号
      POST
    • 代开发应用id明文转密文
      POST
  • 客户设置
    • 查询企业字段
      POST
    • 查询客户字段
      POST
    • 按时间段消除积分(已废弃)
      POST
  • 消息推送
    • 概述
    • 消息推送数据格式
    • 消息推送类型
      • 推送地址注册回调推送
      • 企微客户新增推送
      • 企微客户修改推送
      • 企微客户删除消息推送
      • 企微客户跟进数据变更推送
      • 积分/评分变更消息推送
      • 客户
        • 新增探马客户推送
        • 修改探马客户推送
        • 删除探马客户推送
        • 新增客户联系人消息推送
        • 编辑客户联系人消息推送
        • 删除客户联系人消息推送
      • 订单
        • 新增探马订单推送
        • 修改探马订单推送
      • 标签
        • 客户标签变更推送
        • 企微标签变更推送
        • 内容标签变更推送
        • 企微个人标签变更推送
      • 合同
        • 合同变更推送
      • 商机
        • 客户商机变更推送
      • 企业
        • 企业信息变更推送
        • 推送字段映射
        • 查询已映射的推送字段
      • 通话记录
        • 通话记录推送
      • 跟进记录
        • 写跟进记录推送
    • 推送注册接口
      POST
  • 客户&线索&待分配
    • 客户查询
      • 高级筛选接口(新版)
      • 查询没有群聊的客户
      • 客户高级筛选接口
    • 客户导入
      • 对接前必读
      • 字段映射
        • 客户字段映射
      • 个人线索导入
      • 个人待分配客户导入
      • 个人客户导入
      • 企业线索导入
      • 企业待分配客户导入
      • 企业客户导入
    • 客户
      • 客户数据
        • 必读说明
        • 字段映射
          • 列出客户数据字段列表
          • 映射外部CRM客户数据字段
        • 客户详情
          • 按企微客户id获取详情
          • 按新增时间查询企微客户数据
          • 按详情字段更新时间查询企微客户数据
        • 客户标签
          • 列出企微客户企业标签树
          • 按企微客户id列出客户企业标签(批量)
          • 更新企微客户企业标签
        • 客户跟进
          • 获取指定企微客户的跟进数据
          • 创建企微客户的跟进
          • 删除企微客户的跟进
          • 查询客户跟进记录
        • 客户通话
          • 查询电销手机通话记录
        • 客户文件
          • 客户文件查询接口
          • 客户文件上传
      • 客户聊天
        • 基于时间段内聊天数统计
      • 已跟进客户数据
        • 列出销售跟进的客户
        • 按跟进关系创建时间升序列出已跟进的客户
        • 按跟进关系字段更新时间升序列出已跟进的客户
        • 更新已跟进客户昵称
        • 更新已跟进客户头像
        • 更新已跟进客户备注名
        • 更新已跟进客户字段
        • 更新已跟进客户标签
        • 列出指定客户跟进内容
        • 写客户跟进
        • 跟进记录批量导入
    • 线索&待分配
      • 按创建时间列出线索&待分配客户
      • 按更新时间列出线索&待分配客户
      • 获取线索&待分配客户详情
      • 更新线索&待分配客户字段
      • 编辑 线索&待分配客户 标签
      • 列出指定线索&待分配客户跟进内容
      • 写线索&待分配客户跟进
    • 商机
      • 查询商机配置
      • 获取商机列表
      • 创建客户商机
      • 修改客户商机
      • 查询客户商机
      • 获取客户商机详情
      • 获取探马商品列表
    • 个人客户转企业客户
      • 个人客户转企业客户
    • 企业客户联系人
      • 接口须知
      • 查询联系人
      • 创建联系人
      • 修改联系人
      • 删除联系人
    • 客户旅程
      • 查询旅程
    • 客户操作
      • 修改客户
      • 合并客户
      • 转移客户
      • 变更跟进人
      • 更新企微客户详情(批量)
      • 修改客户积分
      • 添加协作人
    • 按企微员工id列出企微好友客户详情
  • 公海
    • 接口调用须知
    • 公海客户高级筛选列表
      POST
    • 公海-转出记录列表
      POST
    • 列出客户数据字段列表
      POST
    • 列出企业字段列表
      POST
    • 查询公海客户库
      POST
    • 公海-个人客户批量导入
      POST
    • 公海-企业客户批量导入
      POST
    • 公海-个人客户批量更新
      POST
    • 公海-企业客户批量更新
      POST
    • 查询公海销售对应客户的联系人信息
      POST
    • 查询错误信息
      POST
  • 企微组织架构
    • 对接前必读
    • 员工
      • 创建员工
      • 更新员工
      • 读取员工
      • 启用/禁用员工
      • 探马后台登录权限
      • 删除员工
    • 部门
      • 创建部门
      • 编辑部门
      • 获取部门信息
    • 获取组织架构信息
  • 企微标签库
    • 标签树
    • 编辑标签组
    • 删除标签组
    • 添加标签
    • 编辑标签
    • 删除标签
  • 企业
    • 获取企业信息
    • 创建企业
  • 合同
    • 必读说明
    • 保存合同字段映射
    • 获取合同和回款单自定义字段
    • 查询配置的合同映射字段
    • 查询回款单列表
    • 合同扩展字段
    • 新建合同
    • 修改合同
    • 查询销售所有部门
    • 查询客户合同关联订单
    • 查询指定客户合同信息
    • 作废/删除合同
    • 查询合同列表
    • 获取合同详情
  • 电商平台
    • 商城
      • H5商城
        • 概述
        • 注册商城
        • 导入商城商品类别
        • 导入商城商品
    • 订单
      • 概述
      • 第三方订单
        • 获取订单自定义字段
        • 自定义字段映射
        • 查询订单列表
        • 查询订单详情
        • 创建/更新订单
        • 批量创建/更新订单
        • 批量创建/更新订单结果查询接口
      • 探马订单
        • 查询探马商城订单详情
        • 查询探马商城订单列表
        • 获取探马商城订单自定义字段
        • 修改探马商城订单状态
  • 营销
    • 营销内容
      • 表单
        • 获取表单收集明细
      • 自定义
        • 创建自定义内容
        • 更新自定义内容
        • 删除自定义内容
        • 获取自定义内容详情
        • 营销内容标签查询
      • 获取营销内容分类
      • 获取营销内容及明细
      • 获取营销内容-内容标签
      • 获取营销内容-员工分享明细
    • 企微获客
      • 获取企微获客所有表单
      • 获取兑换码手机号
    • 渠道活码
      • 获取渠道活码分组-按部门查询
      • 渠道活码创建接口
      • 渠道活码更新接口
      • 获取渠道活码详情
      • 获取渠道活码分组
      • 获取渠道活码列表
      • 获取渠道活码分析数据
    • 渠道活码 Copy
      • 获取渠道活码分组-按部门查询
      • 渠道活码创建接口
      • 渠道活码更新接口
      • 获取渠道活码详情
      • 获取渠道活码分组
      • 获取渠道活码列表
      • 获取渠道活码分析数据
    • 一客一码
      • 批量删除
      • 查询/创建接口
    • 问答库
      • 层级展示分组
      • 创建问答库分组
      • 编辑分组
      • 删除分组
      • 新建问答
      • 删除问答
      • 编辑问答
      • 问答详情
      • 编辑关键词
      • 删除关键词
      • 新建关键词
      • 查询公司下所有关键词
      • 文件上传
    • 获客活动
      • 获取获客活动参与记录
  • 数据统计
    • 获取微信跟进统计数据明细
    • 获取内容营销员工统计数据明细
  • 内容访客
    • 按内容访问时间列出访客事件信息
  • 电销手机
    • 一键拨号
  • SOP任务
    • 接口说明
    • 客户SOP
      • 客户SOP-群发活动SOP
      • 客户SOP-定期提醒SOP
      • 客户SOP-新增好友SOP
      • 客户SOP-群发助手SOP
      • 创建添加客户任务(分配线索/待分配客户)
    • 群SOP
      • 创建手动发送SOP
      • 创建群发助手SOP
      • 创建群群发任务
      • 创建客户群发任务
    • 跟进客户SOP
      • 跟进客户任务-客户跟进
    • 朋友圈运营
      • 朋友圈任务执行详情
      • 创建朋友圈任务
      • 删除/中止朋友圈任务
      • 查询朋友圈列表
      • 查询朋友圈列表(边城体育)
    • 客户群群发
      • 客户群群发任务执行详情
      • 客户群群发任务列表
    • 客户群发
      • 群发任务执行详情
      • 客户群发任务列表
    • 分页查询员工信息
    • SOP任务-查询销售跟进客户关系
    • 查询标签树
    • 查询营销内容明细数据
    • 查询SOP任务中所需客户字段
    • 查询群列表
    • 查询群标签列表
    • SOP素材上传接口
    • 获取群成员列表
  • 群发消息
    • 创建客户群发消息
    • 上传文件
  • 管控
    • 敏感动作
      • 敏感动作列表接口
  • 工单
    • 工单列表
    • 工单详情
    • 模板列表
    • 创建工单
  • 素材
    • 文件上传
  • 应用通知
    • 应用通知
  • 附录
    • 全局参考文档
    • 前端SDK文档
  • 群数据
    • 群画像
    • 更新群字段
  • 店主活码
    • 店主活码state转换活码名接口
  • 通话列表
    • 语音和通话转文本api
  1. 公海

公海客户高级筛选列表

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 
查询关键词
可选
关键词不能超过50个字符
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 
多个条件关系
必需
0 所有 1任一
conditionItems
array [object {4}] 
必需
pageSize
integer 
分页大小
必需
默认值:
30
pageNo
integer 
页码
必需
默认值:
1
sortField
string 
排序字段
必需
示例值:
open_sea_time
sortDir
integer 
排序方式
必需
1-降序,2-升序
示例值:
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
  }
}
上一页
接口调用须知
下一页
公海-转出记录列表
Built with