批量校验 WhatsApp 号码:一次十个,CSV 能断点续跑
十二行导出已经够烧点数。三格是同一个美国号:纯数字、带空格的 +1、从 CRM 再贴一遍。英国号在旁边那列。两行空白。一行写着 N/A。对每格打一次 check-exist-by-phone,你付十二次,其中三次是同一个人,磁盘上还没有下次能接着用的记录。十二个一股脑塞进 accounts,batch-check-10 也不收。一次工单就是十个号码:一次 GET,逗号分隔,完整国际号码最多十个。
本页只做这件事:把 CSV 切成十个一组,杀掉进程还能续。不是 isExist 三态教程,那篇在如何检测号码是否在用 WhatsApp;也不是「先检查再补资料」的预算文,那篇是 WhatsApp 号码查询。打开本页或复制示例不会发查询。跑脚本才会,并且扣点数。
登录 后从控制台复制你有权使用的 Key,放到打开 CSV 那台机器的 OPENDATA_API_KEY。文中的 YOUR_API_KEY 只是占位。Key 走查询串,不要写进工单、截图、仓库,也不要当成表格里的一列。
十个号码才是一次工单
batch-check-10 对付的是文件,不是注册表单。accounts 用逗号串完整国际号码。一到十都合法。十一个不是「更大的批量」,是坏请求。CSV 末尾剩三个,就是三个的请求——不要再塞七个占位号把名单「凑满」。占位号会变成假的未命中,下次续跑会当成已经干完的活。
送达的每一行给 exist(在不在 WhatsApp)和 isBusiness。isBusiness 只适合旁记分段,不是注册结论。个人号 isBusiness 为 false,仍然在网上。这个字段也不叫 isExist,更不会签发 userHash。冲着头像、签名来的,先停:批量这一跳不给 24 小时的票。
状态分两层,底下才是名单。HTTP 4xx/5xx——缺 Key、Key 无效、额度、传输——表示请求没跑成。信封里没有 WhatsApp 结论;该修凭证或网络,不要给十行都写 false。网关是 {code, message, data},code 不是 200 同一条规则。HTTP 2xx 且网关 code 为 200,只说明这批送达了,这时才读每行的 exist。返回条数不够、某行没有 exist、整组重试耗尽,这些输入都是未判定。重试这一组。不要为了表格好看去编一个未命中。
下面的号码只是文档形态,不保证能查到注册。真发出去的 GET 会扣点数:
# Documented request shape only — running it spends credits.
# GET https://api.opendata-api.com/api/project/whatsapp/batch-check-10
# key=YOUR_API_KEY
# accounts=15551234567,15557654321,442071234567
表单当场只有一个号、对面有人在等。那里用 check-exist-by-phone 或 check-active。为了「顺便走批量」去凑九个号,付的是延迟,不是吞吐。
切块、落盘、再续跑
读 CSV,丢掉垃圾格,按规范数字去重,剩下的按十个切。每组成功之后追加一行 JSON:本次请求的号码和原始返回放在一起,立刻 flush()。进程挂了,磁盘上最多缺这一组。下次运行先读这些 requested,已写过的不再发。
先留原始正文。把 exist / isBusiness 摊平是第二步,等你看过真实结构再写。不要默认按下标对齐。服务器没返回的号码,解析器若补一个「否」,续跑会当它已经结案。
import csv
import json
import os
import time
from datetime import datetime, timezone
import requests
URL = "https://api.opendata-api.com/api/project/whatsapp/batch-check-10"
KEY = os.environ["OPENDATA_API_KEY"].strip()
IN_CSV = "numbers.csv"
OUT = "whatsapp_results.jsonl"
def canonical(raw):
text = raw.strip()
digits = "".join(ch for ch in text if ch.isdigit())
if text.startswith("00") and len(digits) > 8:
digits = digits.lstrip("0")
return digits
def load_input(path):
phones = []
with open(path, newline="") as fh:
sample = fh.read(2048)
fh.seek(0)
has_header = False
if sample:
has_header = csv.Sniffer().has_header(sample)
reader = csv.reader(fh)
if has_header:
next(reader, None)
for row in reader:
if not row:
continue
raw = (row[0] or "").strip()
if not raw or raw.lower() in {"n/a", "na", "none", "null"}:
continue
phone = canonical(raw)
if len(phone) < 8:
continue
phones.append(phone)
seen = set()
unique = []
for phone in phones:
if phone in seen:
continue
seen.add(phone)
unique.append(phone)
return unique
def load_done(path):
done = set()
if not os.path.exists(path):
return done
with open(path) as fh:
for line in fh:
line = line.strip()
if not line:
continue
done.update(json.loads(line)["requested"])
return done
def unwrap(body):
# Replies wrap as {code, data}; the platform may wrap once more.
while isinstance(body, dict) and "code" in body and isinstance(
body.get("data"), (dict, list)
):
if str(body.get("code")) != "200":
raise RuntimeError(body.get("message") or "gateway code not 200")
body = body["data"]
return body
def check_batch(batch, attempts=4):
for attempt in range(attempts):
try:
resp = requests.get(
URL,
params={"key": KEY, "accounts": ",".join(batch)},
timeout=60,
)
if not 200 <= resp.status_code < 300:
# HTTP layer: key, quota, or transport — not a WhatsApp verdict.
time.sleep(2 ** attempt)
continue
return unwrap(resp.json())
except (requests.RequestException, ValueError, RuntimeError):
time.sleep(2 ** attempt)
return None
def chunks(items, size=10):
for i in range(0, len(items), size):
yield items[i : i + size]
def run():
unique = load_input(IN_CSV)
done = load_done(OUT)
todo = [n for n in unique if n not in done]
failed = []
with open(OUT, "a") as out:
for batch in chunks(todo):
result = check_batch(batch)
if result is None:
failed.extend(batch)
continue
out.write(
json.dumps(
{
"requested": batch,
"result": result,
"checked_at": datetime.now(timezone.utc).isoformat(),
}
)
+ "\n"
)
out.flush()
return {
"input_unique": len(unique),
"already_done": len(unique) - len(todo),
"failed": failed,
}
if __name__ == "__main__":
print(run())
失败的号码只出现在返回值里,不写进文件,所以再跑只会打这些,加上 CSV 后来新增的行。HTTP 401/403 是密钥问题,休眠换不来授权。在服务端导出 OPENDATA_API_KEY,装 requests,把 IN_CSV 指到那份表,在那台机器上跑——不要放到浏览器里。
重复号码在烧点数
最贵的一行,往往是你早就认识的那个人。那十二行里,标点变不出新联系人。规范数字能把三种美国写法收成一个槽位。空白和 N/A 永远不该进 accounts。真正发出去的,是去重之后、看起来像号码的剩余,再按十个切——不是单元格个数。
每次调用 batch-check-10 都按这次请求扣点,末尾只剩两个也算一次,没落盘的重试也算一次。费率看定价;预算上真正翻车的,是同一个号被送了几遍。两组里各有一份拷贝,就是两笔。删掉 whatsapp_results.jsonl 再「干净重跑」,等于整表再付一遍。周一活动前无视 checked_at、把上个月的文件整表再查,只是换了个日历借口。
顺着文件循环 check-exist-by-phone 是另一张账单:一次一个号,没有续跑文件(除非你自己做),重复没丢掉,往返次数就跟着涨。单位真是「这一个号」时用单个检查;单位是 CSV 的一片时用本页的批量。
也别为了「点数别浪费」就从这份脚本里对每个 exist=true 去补资料。batch-check-10 不签发 userHash。头像、签名、在线、完整商家名片是命中之后的另几跳,而且多数名单里未命中才是大头。那道闸在查询那篇。这里卖的就是便宜的筛:exist、isBusiness、时间戳、一份能续的文件。
一组老失败,你却写成未注册、每天夜里再刷「确认一下」,同样是漏点。让它留在失败列表里,脚本下次会再问。已经送达并落盘的 exist,在你自己的复查周期到来之前,不必每晚重放。
批量仍然判断不了的事
一次十个,不能证明你可以给这个号发消息。注册不是授权。它不签发 userHash,不拉头像,不读最后出现。它不能把 HTTP 200 变成十个「是」,也不能把缺行写成「否」。exist 不是 isExist;要单个号码的三态记录,就离开这份文件型任务。
它也替不了注册表单上的检查。一张表单干等到另外九个号,不叫批量校验。它不会帮你分类那些本该在进 accounts 之前丢掉的垃圾——短数字串照样占十个名额里的一个。没写到磁盘的工作,它也不会记得。复制文档里的 accounts=15551234567,15557654321,442071234567 更不是一次真实结果;只有拿授权 Key 跑起来才是。
还在 CSV、十个一组、flush 一行、以及同一串数字不要付两次的时候,就留在本页。要看参数列表、不需要续跑逻辑,去 WhatsApp 号码校验 试用,或读 batch-check-10 文档。