Produktleitfaden
So prüfen Sie Telefonnummern aus einer CSV-Datei in Echtzeit
Telefonnummern aus einer CSV-Datei in Echtzeit mit WA Lookup prüfen: E.164-Format, bis zu 100 Nummern pro synchroner Anfrage und Kontopräsenz in derselben Antwort.
Erfahren Sie, wie Sie eine CSV-Datei mit Telefonnummern im E.164-Format vorbereiten und über die Echtzeit-Einzel- und Multi-Endpunkte von WA Lookup prüfen, um sofort Kontopräsenzsignale zu erhalten.
WA Lookup prüft die Präsenz von WhatsApp-Konten in Echtzeit: Senden Sie eine E.164-Nummer an POST /api/v1/check oder bis zu 100 Nummern an den synchronen Multi-Endpunkt POST /api/v1/batch-check, und das fertige Ergebnis kommt in derselben HTTP-Antwort zurück. Eine CSV-Datei ist lediglich die Quelle für diese Anfragen – vereinheitlichen Sie die Spalte, wählen Sie einen Diensttyp und senden Sie die Kennungen über den Multi-Endpunkt in Portionen von bis zu 100. Eine ganze Datei, die weit über eine Echtzeitanfrage hinausgeht, kann auch als asynchrone Massenprüfungsaufgabe hochgeladen werden.
Ihre Daten für die Prüfung vorbereiten
Bevor Sie API-Anfragen starten, muss Ihre CSV-Datei korrekt formatiert sein. WA Lookup verlangt, dass alle übermittelten Telefonnummern das E.164-Format verwenden. Dieser internationale Rufnummernplan legt fest, dass jede Nummer eindeutig und unverwechselbar ist; sie beginnt in der Regel mit einem Pluszeichen, gefolgt von der Ländervorwahl und der Teilnehmernummer. Wenn Sie Ihre CSV-Spalte auf dieses Format vereinheitlichen, reduzieren Sie Fehler beim API-Aufruf und ermöglichen eine genaue Verarbeitung der Workflow-Eingabe.
Den richtigen WhatsApp-Prüftyp wählen
WA Lookup bietet drei Diensttypen, die für synchrone Einzelprüfungen und synchrone Multi-Prüfungen gleichermaßen gelten. Wählen Sie den Typ, der zu dem Kontopräsenzsignal passt, das Ihr Workflow benötigt.
| Diensttyp | Umfang und zurückgegebene Signale |
|---|---|
| ws | Liefert den Standardstatus der Plattformregistrierung (boolescher Wert registered). |
| ws_avatar | Prüft die Registrierung und ergänzt eine Profilanreicherung (boolescher Wert avatar und String avatar_url, leer, wenn keine URL verfügbar ist). |
| ws_business | Prüft die Registrierung und erkennt WhatsApp Business-Konten (boolescher Wert business). |
Der Parameter service_type steuert, welche Felder zurückgegeben werden und welche Guthabenkosten anfallen.
Ihren Prüf-Workflow ausführen
Verwenden Sie für eine CSV-Datei den synchronen Multi-Endpunkt POST /api/v1/batch-check für bis zu 100 formatierte Kennungen auf einmal; verwenden Sie POST /api/v1/check für eine einzelne Kennung. Beide liefern die Ergebnisse in der auslösenden HTTP-Antwort – ohne Task-Übermittlung, Polling oder Download-Schritt.
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.
Kosten und Ergebnisse verwalten
Teams können im WA Lookup Dashboard API-Schlüssel verwalten, den Prüfverlauf einsehen sowie Guthaben und Nutzung auf Produktebene überwachen. Die Multi-Anfrage selbst läuft synchron über die API, während das Dashboard Einblick in Konto und Nutzung gibt. Neue Konten können sich zudem an den Support wenden, um 100 kostenlose Prüfungen zu erhalten und Registrierungs-, Avatar- und Business-Konto-Prüfungen zu testen, bevor sie größere CSV-Dateien verarbeiten.
FAQ
Was ist der Unterschied zwischen ws, ws_avatar und ws_business?
Der Diensttyp ws liefert den Standardstatus der Plattformregistrierung. Der Typ ws_avatar ergänzt die Avatar-Verfügbarkeit und ein Feld für die Avatar-URL, das leer ist, wenn keine URL verfügbar ist. Der Typ ws_business prüft die Registrierung und erkennt, ob die Nummer mit einem WhatsApp Business-Konto verknüpft ist.
Kann ich mehrere Nummern in einer Anfrage prüfen?
Ja. Der synchrone Multi-Endpunkt POST /api/v1/batch-check akzeptiert bis zu 100 Kennungen und liefert die fertigen Ergebnisse in derselben HTTP-Antwort – ohne Task-Übermittlung, Polling oder Download-Schritt. Für eine ganze Liste, die weit darüber hinausgeht, steht auch eine asynchrone Massenprüfungsaufgabe zur Verfügung (Sie wählen beim Einreichen das Land, zu dem die Nummern gehören, und die Liste sollte im Wesentlichen aus diesem einen Land stammen), doch die synchronen Endpunkte bleiben der primäre Weg zur Prüfung.
Werden fehlgeschlagene Prüfungen von meinem Guthaben abgebucht?
Bei fehlgeschlagenen, abgelaufenen und unbestimmten Prüfungen wird die Gebühr nicht einbehalten. Aktuelle Abrechnungsdetails finden Sie auf der Preisseite.