WhatsApp-Nummernprüfung — Massenhaft über Plattform oder API prüfen | CheckNumber.AI

WhatsApp-Nummern-Erkennungs-API — Schritt-für-Schritt-Integration

Die Massenprüfung der WhatsApp-Registrierung ist entscheidend für Marketinglistenbereinigung, Betrugserkennung, Lead-Qualifizierung und CRM-Datenvalidierung. Dieser Leitfaden zeigt die Integration der CheckNumber.AI WhatsApp-Bulk-API mit Beispielen in curl, Python und Node.js.

Funktionsweise

In Produktion laufen Prüfungen als Batch-Tasks: Datei hochladen, Status abfragen, Ergebnis herunterladen — nicht ein synchroner HTTP-Call pro Nummer. So lassen sich große Volumina effizient verarbeiten.

Offizielle Referenz: WhatsApp Checker — bulk registration.

Task einreichen

POST https://api.checknumber.ai/v1/tasks

Beispiel — curl:

curl --location 'https://api.checknumber.ai/v1/tasks' \
--header 'X-API-Key: API-KEY' \
--form 'file=@"./numbers.txt"' \
--form 'task_type="ws"'

Beispiel — Python:

import requests

url = "https://api.checknumber.ai/v1/tasks"
headers = {"X-API-Key": "YOUR_API_KEY"}

with open("numbers.txt", "rb") as f:
    files = {"file": f, "task_type": (None, "ws")}
    response = requests.post(url, headers=headers, files=files)

print(response.json())

Beispiel — Node.js:

const FormData = require('form-data');
const fs = require('fs');
const axios = require('axios');

const form = new FormData();
form.append('file', fs.createReadStream('numbers.txt'));
form.append('task_type', 'ws');

axios.post('https://api.checknumber.ai/v1/tasks', form, {
  headers: {
    ...form.getHeaders(),
    'X-API-Key': 'YOUR_API_KEY'
  }
}).then(res => console.log(res.data))
  .catch(err => console.error(err.message));

Status abfragen

POST https://api.checknumber.ai/v1/gettasks

curl --location 'https://api.checknumber.ai/v1/gettasks' \
--header 'X-API-Key: API-KEY' \
--form 'task_id="TASK_ID"'

Ergebnisspalten

Häufige Fehler & Troubleshooting

FAQ

F: Wie lange dauert eine Bulk-Prüfung?
A: Typischerweise Sekunden bis wenige Minuten für sehr große Listen — abhängig von der Warteschlange.

F: Mindest- und Maximigröße?
A: Mindestens eine Nummer; maximal etwa 50MB pro Datei (oft mehrere Millionen Zeilen möglich, siehe aktuelle Limits in der Doku).

Werden nur erfolgreiche Checks berechnet?
A: Ja — erfolgreich verarbeitete Ergebnisse verbrauchen Credits; fehlgeschlagene Zeilen in der Regel nicht.

Nächste Schritte

• 1.000 kostenlose Checks registrieren →
• Preisseite →
• API-Dokumentation →

Integrationshinweise

1. Eine Nummer pro Zeile; Ländervorwahl in E.164.
2. Polling bis status = exported, dann result_url.
3. Details in der offiziellen Dokumentation.
4. Preise: pricing.