WhatsApp-Nummernverifizierung erstellen (API)

Prüfen Sie, ob eine Liste von Telefonnummern bei WhatsApp registriert ist, bevor Sie diese anschreiben. Nutzen Sie die API, um importierte Kontaktlisten zu bereinigen, bei der Registrierung angegebene Nummern zu validieren oder Nummern zu entfernen, an die Nachrichten ohnehin fehlschlagen würden.

Der Request erstellt eine Verifizierungsaufgabe und gibt sofort eine campaign_id zurück. Die Nummern werden dann im Hintergrund von einer Ihrer verbundenen WhatsApp-Nummern geprüft. Verwenden Sie die campaign_id mit Verifizierungsstatus, um den Fortschritt zu verfolgen, oder mit Verifizierungsergebnisse, um die Ergebnisse abzurufen.

Kurzes Beispiel#

curl -X POST https://wbiztool.com/api/v1/verification/create/ \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "campaign_name": "Website leads - September",
    "numbers": ["919876543210", "+91 98765 43211", "14155550123"]
  }'

import requests

response = requests.post(
    "https://wbiztool.com/api/v1/verification/create/",
    headers={"Authorization": "Bearer YOUR_API_KEY"},
    json={
        "campaign_name": "Website leads - September",
        "numbers": ["919876543210", "+91 98765 43211", "14155550123"],
    },
    timeout=60,
)
result = response.json()  # read the body even when the HTTP code is 4xx or 5xx

if result["status"] == "success":
    print("Task created, campaign_id", result["campaign_id"])
    print("Accepted numbers:", result["numbers_submitted"])
else:
    print(f"Failed ({response.status_code}):", result["message"])

// Node.js 18+ (built-in fetch). Save as .mjs to use top-level await.
const response = await fetch("https://wbiztool.com/api/v1/verification/create/", {
  method: "POST",
  headers: {
    Authorization: "Bearer YOUR_API_KEY",
    "Content-Type": "application/json",
  },
  body: JSON.stringify({
    campaign_name: "Website leads - September",
    numbers: ["919876543210", "+91 98765 43211", "14155550123"],
  }),
});
const result = await response.json(); // read the body even when the HTTP code is 4xx or 5xx

if (result.status === "success") {
  console.log("Task created, campaign_id", result.campaign_id);
  console.log("Accepted numbers:", result.numbers_submitted);
} else {
  console.error(`Failed (${response.status}):`, result.message);
}

<?php
$payload = [
    'campaign_name' => 'Website leads - September',
    'numbers'       => ['919876543210', '+91 98765 43211', '14155550123'],
];

$ch = curl_init('https://wbiztool.com/api/v1/verification/create/');
curl_setopt_array($ch, [
    CURLOPT_POST           => true,
    CURLOPT_HTTPHEADER     => [
        'Authorization: Bearer YOUR_API_KEY',
        'Content-Type: application/json',
    ],
    CURLOPT_POSTFIELDS     => json_encode($payload),
    CURLOPT_RETURNTRANSFER => true,
    CURLOPT_TIMEOUT        => 60,
]);
$result = json_decode(curl_exec($ch), true);
curl_close($ch);

if (($result['status'] ?? '') === 'success') {
    echo 'Task created, campaign_id ' . $result['campaign_id'];
} else {
    echo 'Failed: ' . ($result['message'] ?? 'no response');
}

Ersetzen Sie YOUR_API_KEY durch einen Schlüssel aus Einstellungen → API-Schlüssel. Der Schlüssel bestimmt, zu welchem Arbeitsbereich die Aufgabe gehört.

Request-Parameter#

Antwort#

Ein erfolgreicher Request gibt HTTP 200 zurück:

{
  "status": "success",
  "message": "Verification task created successfully",
  "campaign_id": 4521,
  "numbers_count": 3,
  "numbers_submitted": ["919876543210", "919876543211", "14155550123"]
}

Jede akzeptierte Nummer beginnt mit pending. Die Aufgabe erscheint außerdem auf der Seite Nummernverifizierung in Ihrem Dashboard. Ihre Karte dort zeigt möglicherweise auch nach Abschluss weiter „Wird verarbeitet“ an. Den tatsächlichen Stand liefert Verifizierungsstatus.

Fehler#

Fehler liefern einen JSON-Body mit status gleich "error" und einen HTTP-Fehlercode:

{ "status": "error", "message": "No valid phone numbers found" }

Wie Nummern geprüft werden#

1. Die Aufgabe wird in die Warteschlange gestellt

   Die API speichert jede akzeptierte Nummer als pending und antwortet sofort.

2. Eine verbundene WhatsApp-Nummer prüft sie

   Die Nummern werden jeweils bis zu 10 auf einmal mit einer WhatsApp-Nummer geprüft, die in den WhatsApp-Einstellungen verbunden ist. Jede Nummer wird verified, wenn sie bei WhatsApp registriert ist, oder invalid, wenn nicht. Geprüft wird nur mit einer verbundenen Nummer, die nicht gerade Nachrichten sendet. Während einer großen Kampagne können die Prüfungen daher warten, bis der Versand abgeschlossen ist.

3. Sie rufen die Ergebnisse ab

   Fragen Sie Verifizierungsstatus regelmäßig ab, bis overall_status den Wert completed hat, und lesen Sie die Nummern dann aus derselben Antwort oder aus Verifizierungsergebnisse.

Tipps#

• Geben Sie immer die Ländervorwahl an. Eine 10-stellige lokale Nummer ohne Vorwahl besteht zwar die Längenprüfung, wird aber genau so geprüft, wie sie geschrieben ist. Das Ergebnis gilt dann nicht für die Nummer, die Sie gemeint haben.
• Verwenden Sie nicht das internationale Präfix 00. Es wird nur eine führende 0 entfernt, daher wird 00919876543210 als 0919876543210 geprüft. Senden Sie 919876543210.
• Entfernen Sie Duplikate selbst vor dem Senden, damit Sie das Limit Ihres Plans pro Request nicht für Wiederholungen verbrauchen.
• Prüfen Sie numbers_submitted, um Nummern zu finden, die entfernt wurden, weil sie zu kurz waren oder Buchstaben enthielten.
• Große Listen: Wenn Sie das Limit pro Request erreichen, senden Sie mehrere kleinere Aufgaben und verfolgen Sie jede campaign_id.

Neu bei der Nummernverifizierung? Lesen Sie die Anleitung zur Nummernverifizierung.