开发者文档 开发者文档
帮助中心 (opens new window)
帮助中心 (opens new window)
  • 呼叫中心V7

  • 外呼机器人V5
  • 电销中心

  • 行业语音 Agents

    • 权限认证
    • 基础信息接口

    • 短信平台接口

    • 风控策略接口

    • AI引擎接口

    • 回调接口

    • AI外呼接口

      • 外呼场景调用流程说明
      • 任务操作接口

      • 任务信息查询接口

      • 任务完成电话信息查询接口

        • 获取已经完成任务电话号码接口
        • 获取一个通话的详情接口
        • 已呼列表记录数查询
        • 获取过滤记录接口
          • 1、接口描述
          • 2、请求头
          • 3、输入参数
          • 4、输出参数
          • 5、示例
      • 通话统计接口

      • 通话计费接口

  • 语音类产品 API
  • 行业语音 Agents
  • AI外呼接口
  • 任务完成电话信息查询接口
智齿科技
2026-08-04
目录

获取过滤记录接口

# 1、接口描述

功能说明: 通过此接口可以获取某任务中指定号码的过滤记录数据。单次调用最多返回20条数据 请求地址: https://open-api.soboten.com/apiOpen/v1/filterRecord/getFilterRecord 请求方法: POST

# 2、请求头

请求头参数获取详见权限认证

参数名 类型 是否必填 描述
appkey String 是 ISV账号信息里获取
timestamp Long 是 生成验签字段时使用的时间戳
signature String 是 验签字段,获取方法详见权限认证

# 3、输入参数

参数名 类型 是否必须 描述 示例
robotCallJobId Integer 是 任务id 2588
calledPhoneNumber String 是 联系电话(明文或密文) ew9fZeBRLVRVEtxE2nSb
customerPersonName String 否 客户名 张三
filterType String 否 过滤类型 详见枚举类型说明中的外呼过滤枚举 SHARE_WHITE_LIST
startTime String 否 过滤时间(开始时间) "2025-03-01 00:00:00"
endTime String 否 过滤时间(结束时间) "2025-03-01 23:59:59"

# 4、输出参数

参数名 类型 描述 示例
code Integer 响应码 200
data JsonArray 结果集
+filteredRobotCallTaskId Integer 过滤记录id 23013
+robotCallJobId Integer 任务id 1851
+calledPhoneNumber String 联系电话 ew9fZeBRLVRVEtxE2nSb
+customerPersonId Integer 客户id 138307658
+customerPersonName String 客户名 章三
+gender String 性别,UNKNOWN(“未知”),MALE( “男”),FEMALE(“女”); MALE
+filterType String 过滤类型 ILLEGAL_TEL
+filterReason String 过滤原因 风控系统不可用
+createTime String 过滤时间 "2024-09-25 17:49:47"
+properties Map 自定义变量 { "积分": "100" }
requestId String 请求Id PDRAROJB
resultMsg String 响应说明 执行成功
host String 业务主机名 prod-web-7
errorStackTrace String 异常堆栈 null

# 5、示例

输入示例:

{
    "robotCallJobId":32322,
    "calledPhoneNumber":"94852749",
    "customerPersonName":"张三",
    "filterType":"LOREAL_INTERCEPT",
    "startTime":"2025-03-03 10:14:56",
    "endTime":"2025-03-03 19:14:56"
}
1
2
3
4
5
6
7
8

输出示例:

{
    "code": 200,
    "data": [
        {
            "filteredRobotCallTaskId": 8519146,
            "robotCallJobId": 32322,
            "calledPhoneNumber": "94852749",
            "customerPersonId": 377130100,
            "customerPersonName": "张三",
            "gender": "MALE",
            "filterType": "LOREAL_INTERCEPT",
            "filterReason": "黑名单接口调用异常",
            "createTime": "2025-03-03 18:14:56",
            "properties": {
                "积分": "100"
            }
        }
    ],
    "requestId": "zQOTs31L",
    "resultMsg": "执行成功",
    "host": "daily-acp-03",
    "errorStackTrace": null
}
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
上次更新: 2026/8/4 16:22:00

← 已呼列表记录数查询 获取任务统计相关信息(总量,完成量)→

最近更新
01
权限认证
08-04
02
短信接收结果回调
08-04
03
外呼场景调用流程说明
08-04
更多文章>
Theme by Vdoing
  • 跟随系统
  • 浅色模式
  • 深色模式
  • 阅读模式