WhatsApp 工具

whatsapp 筛号接口

注意: 单次筛号数量上限为 2w 条，下限为 500 条，此接口为收费接口。

• 类型

  API

• URI

  /wscrm-bus-api/open/scan/screenWhatsApp

• 请求方式

  POST、Content-Type: application/json

• 接口说明

  判断手机号是否是 whatsApp、是否活跃、头像性别等

• 请求参数说明

字段	类型	是否必填	备注
data	List	是	手机号码（带区号）
type	int	是	筛号类型 0、是否 whatsapp 账号 1、 筛活跃 2、筛头像性别
activeType	int	否	活跃类型 0、频繁 1、最近 2、近期）
country	String	是	国家

请求示例:

{
  "data": ["91182716322323", "91182716322321"],
  "type": 1,
  "activeType": 0,
  "country": "IN"
}

• 响应参数说明

  参数名	类型	是否必填	备注
  code	int	是	状态码
  message	String	是	描述
  data	String	是	订单 id

• 响应示例

{
  "code": 200,
  "message": "Success",
  "data": "330e6b1c1dd62662d0474de6f0003288"
}

查询筛号任务状态接口

• 类型

  API

• URI

  /wscrm-bus-api/open/scan/queryTaskStatus/{orderId}

• 请求方式

  POST

• 接口说明

  查询 whatsapp 筛选任务订单的状态

• 请求参数说明

字段	类型	是否必填	备注
orderId	String	是	订单号

• 响应参数说明

  参数名	类型	是否必填	备注
  code	int	是	状态码
  message	String	是	描述
  data	int	是	1、完成 0、未完成

• 响应示例

{
  "code": 200,
  "message": "Success ",
  "data": 0
}

查询筛号任务结果接口

• 类型

  API

• URI

  /wscrm-bus-api/open/scan/queryTaskDetails/{orderId}

• 请求方式

  POST

• 接口说明

  查询 whatsapp 筛选任务的详细信息（前提:筛号任务完成状态）

• 请求参数说明

字段	类型	是否必填	备注
orderId	String	是	订单号

• 响应参数说明

参数名	类型	是否必填	备注
code	int	是	状态码
message	String	是	描述
data	String	是	url 下载地址（带有效期）

• 响应示例

{
  "code": 200,
  "message": "Success ",
  "data":  "http://aliyun/xxx/yyy/zzz.xlsx"
  ]
}

• xlsx 的列字段解释

  参数名	类型	必定有值	备注
  手机号	String	是	9119228282828
  是否 WhatsApp 号	int	否	1、是
  状态	String	否	happy
  最后活跃时间	String	否	2025-09-05 00:10:47
  活跃小时	int	否	2
  头像	String	否	http://wwww/xxxx/1.png
  是否商业号	int	否	1、是
  性别	String	否	male(男）、female（女）、unknown
  年龄	String	否	22