So bereiten Sie eine CSV- oder TXT-Liste für WhatsApp-Nummernprüfungen in Echtzeit vor

Ein praxisnaher Workflow-Leitfaden zur Vorbereitung einer CSV- oder TXT-Liste mit Telefonnummern für WhatsApp-Echtzeitprüfungen: E.164-Formatierung, Wahl des Diensttyps und Abruf von Kontopräsenzsignalen über die synchronen Einzel- und Multi-Endpunkte.

WA Lookup prüft die Präsenz von WhatsApp-Konten in Echtzeit: Senden Sie eine Nummer an den synchronen Prüf-Endpunkt oder bis zu 100 Nummern an den synchronen Multi-Endpunkt POST /api/v1/batch-check, und die fertigen Ergebnisse kommen in der auslösenden HTTP-Antwort zurück – ganz ohne auf einen Job warten zu müssen. Um eine CSV- oder TXT-Liste darüber zu prüfen, formatieren Sie jede Kennung strikt nach dem internationalen Nummerierungsstandard E.164, entfernen nicht numerische Zeichen und lokale Präfixe und wählen den Diensttyp, den Ihr Workflow benötigt: ws für den einfachen Registrierungsstatus, ws_avatar, um zusätzlich die Avatar-Verfügbarkeit zu erhalten, oder ws_business, um WhatsApp Business-Konten zu erkennen. Eine ganze Datei, die weit über eine Echtzeitanfrage hinausgeht, kann auch als asynchrone Massenprüfungsaufgabe hochgeladen werden (hochladen, warten, herunterladen).

WhatsApp-Prüfsignale verstehen

Bei der Vorbereitung einer CSV- oder TXT-Liste für Echtzeitprüfungen besteht der erste Schritt darin, festzulegen, welches Kontopräsenzsignal Ihren konkreten Workflow unterstützt. WA Lookup bietet drei verschiedene Diensttypen, die alle über dieselben synchronen Endpunkte aufgerufen werden. Der Parameter service_type steuert, welche Felder in der Antwort zurückgegeben werden.

Einfache Registrierungsprüfung (ws)

Der Diensttyp ws bestätigt, ob eine übermittelte Telefonnummer derzeit bei WhatsApp registriert ist. Diese Prüfung liefert ein Feld registered und damit ein eindeutiges Kontopräsenzsignal. Es dient als Grundlage für interne Entscheidungen darüber, welche Nummern in Ihrer CSV- oder TXT-Datei zum Zeitpunkt der Prüfung mit einem WhatsApp-Konto verknüpft sind.

Prüfung mit Avatar-Anreicherung (ws_avatar)

Der Diensttyp ws_avatar umfasst die einfache Registrierungsprüfung und ergänzt sie um Funktionen zur Profilanreicherung. Zusätzlich zum Status registered liefert diese Prüfung einen booleschen Wert avatar, der die Avatar-Verfügbarkeit angibt, sowie einen String avatar_url. Das URL-Feld ist leer, wenn keine URL verfügbar ist. Dieser zusätzliche Kontext kann bei der Prüfung von Nutzerprofilen eine Eingabe neben anderen Prüfungen sein.

Business-Konto-Prüfung (ws_business)

Der Diensttyp ws_business prüft die WhatsApp-Registrierung und ermittelt, ob das Konto WhatsApp Business nutzt. Er liefert einen booleschen Wert business. Dieses Signal hilft Teams, ihre Listen zu segmentieren, indem es Standardkonten von Business-Profilen unterscheidet, und unterstützt so ein gezielteres Workflow-Routing.

Ihre Datendatei vorbereiten

Die wichtigste Voraussetzung, um eine CSV- oder TXT-Liste durch Echtzeitprüfungen laufen zu lassen, ist die korrekte Formatierung der Daten. WA Lookup verlangt, dass alle Nummern im E.164-Format übermittelt werden. E.164 ist ein internationaler Rufnummernplan, der jedem Gerät eine weltweit eindeutige Kennung zuweist. So bereiten Sie Ihre CSV- oder TXT-Datei vor:

1. Ländervorwahl angeben: Jede Nummer muss mit der passenden internationalen Ländervorwahl beginnen.
2. Formatierungszeichen entfernen: Entfernen Sie Leerzeichen, Bindestriche, Klammern und alle anderen nicht numerischen Zeichen aus Ihrer Liste.
3. Führende Nullen weglassen: Entfernen Sie lokale Verkehrsausscheidungsziffern (oft eine führende Null), die nicht Teil der internationalen Vorwahl sind.

Eine US-amerikanische Nummer sollte zum Beispiel als durchgehende Ziffernfolge formatiert werden, die mit der Ländervorwahl beginnt (z. B. 1). Wenn Sie sicherstellen, dass Ihre gesamte Liste dem E.164-Standard entspricht, vermeiden Sie Formatierungsfehler während der synchronen Prüfung. Eine saubere, standardisierte Eingabedatei ist unerlässlich, um für jede übermittelte Nummer genaue Kontopräsenzsignale zu erhalten.

Ihre Liste zur Prüfung übermitteln

Sobald Ihre CSV- oder TXT-Liste korrekt formatiert ist, können Sie die Kennungen an die WA Lookup Plattform übermitteln. Der primäre Weg ist synchron: Die Ergebnisse werden in derselben HTTP-Antwort wie die Anfrage zurückgegeben, statt zu einem späteren Zeitpunkt geliefert zu werden. Technische Teams, die den Dienst integrieren, verwenden POST /api/v1/check für eine Kennung oder den synchronen Multi-Endpunkt POST /api/v1/batch-check für bis zu 100 Kennungen. Beide Anfragen erfordern einen Header X-API-Key und einen Header Content-Type: application/json. Der Body der Einzelprüfung enthält service_type und identifier; der Multi-Body enthält service_type und identifiers. Beachten Sie die Hinweise zur Parallelität in der API-Dokumentation. Eine ganze CSV- oder TXT-Datei, die weit über eine Echtzeitanfrage hinausgeht, kann auch als asynchrone Massenprüfungsaufgabe hochgeladen werden; Sie wählen beim Einreichen das Land, zu dem die Nummern gehören, und die Liste sollte im Wesentlichen aus diesem einen Land stammen. Bei fehlgeschlagenen, abgelaufenen und unbestimmten Prüfungen wird die Gebühr nicht einbehalten. Aktuelle Abrechnungsdetails finden Sie auf der Preisseite.

Ihre Ergebnisse interpretieren

Bei einer abgeschlossenen WhatsApp-Prüfung enthält das zurückgegebene data die Felder service_type, identifier und registered; ws_avatar enthält zusätzlich avatar und avatar_url, während ws_business das Feld business enthält. Interne Datensatz-, Transaktions-, Status- und Abrechnungsfelder werden nicht zurückgegeben. Das Ergebnis registered gibt die WhatsApp-Statusfelder wieder, die genau zum Zeitpunkt der Prüfung verfügbar sind. Es ist wichtig, die Grenzen dieses Kontopräsenzsignals zu verstehen. Zudem sagt die Prüfung nichts über Live-Präsenz, Nachrichtenverlauf oder die Einwilligung zur Kontaktaufnahme aus. Sie zeigt auch nicht an, ob die Nummer erfolgreich kontaktiert werden kann oder ob Nachrichten zugestellt werden. Das Signal informiert Ihre interne Datenbank lediglich über die Plattformregistrierung und kann bei der Organisation Ihres CRM oder beim Routing von Datensätzen eine Eingabe neben anderen Prüfungen sein.

FAQ

Welches Format ist für Telefonnummern erforderlich?

Alle Telefonnummern müssen strikt im E.164-Format übermittelt werden. Dieser internationale Rufnummernplan erfordert die Ländervorwahl sowie das Entfernen aller nicht numerischen Zeichen, Leerzeichen und lokalen führenden Nullen.

Kann ich den WhatsApp Business-Status für eine ganze Liste prüfen?

Ja. Wenn Sie den Diensttyp ws_business wählen, können Sie sowohl den einfachen Registrierungsstatus als auch prüfen, ob das Konto WhatsApp Business nutzt. Dabei wird ein spezifischer boolescher Wert zurückgegeben, der die Präsenz eines Business-Kontos angibt – bei einer Einzelprüfung ebenso wie bei einer synchronen Multi-Anfrage.

Was passiert, wenn eine Prüfung fehlschlägt?

Bei fehlgeschlagenen, abgelaufenen und unbestimmten Prüfungen wird die Gebühr nicht einbehalten. Aktuelle Abrechnungsdetails finden Sie auf der Preisseite.

Werden die Prüfergebnisse asynchron geliefert?

Nicht auf dem primären Weg. Die synchronen Einzel- und Multi-Endpunkte liefern das fertige Ergebnis in derselben HTTP-Antwort wie die Anfrage. Eine asynchrone Massenprüfungsaufgabe (hochladen, warten, herunterladen) steht zusätzlich für eine ganze große Liste zur Verfügung, doch für alltägliche Prüfungen sind die synchronen Endpunkte der richtige Weg.