Durchführung einer WhatsApp-Massenprüfung per Datei
Erfahren Sie, wie Sie eine WhatsApp-Massenprüfung per TXT- oder CSV-Datei durchführen: Liste vorbereiten, Produkt wählen, Status verfolgen und Ergebnisdatei laden.
Eine Schritt-für-Schritt-Anleitung für asynchrone WhatsApp-Massenprüfungsaufgaben und wie sie sich von Echtzeitprüfungen unterscheiden.
Eine WhatsApp-Massenprüfung per Datei ist eine asynchrone Aufgabe: Sie laden eine TXT- oder CSV-Liste hoch, erhalten eine Aufgabe, die Sie verfolgen können, warten während der Verarbeitung und laden eine Ergebnisdatei herunter, sobald diese abgeschlossen ist. Nutzen Sie diese Methode, wenn eine Liste deutlich umfangreicher ist, als es für eine Echtzeitabfrage sinnvoll wäre. Für einzelne Nummern oder kleine Gruppen, die eine sofortige Antwort erfordern, verwenden Sie stattdessen eine Echtzeitprüfung.
Wann eine Massenprüfung per Datei das richtige Werkzeug ist
Echtzeitprüfungen liefern die Antwort direkt innerhalb der Anfrage. Dies eignet sich für Anmeldeformulare, CRM-Trigger oder kleine, eingefügte Gruppen. Eine Massenprüfung per Datei passt zur gegenteiligen Situation: eine exportierte Liste, eine gekaufte oder übernommene Datenbank oder eine regelmäßige Bereinigung einer gesamten Kontakttabelle.
Der praktische Unterschied liegt im Arbeitsablauf, nicht in der gestellten Frage. Bei der Echtzeitprüfung erhalten Sie die Ergebnisse sofort in der Antwort. Bei der Massenprüfung übermitteln Sie die Daten einmal, die Aufgabe wird separat verarbeitet und Sie rufen das Ergebnis später ab. Planen Sie Massenprüfungen als geplanten Prozess ein, nicht als etwas, auf das eine Person direkt am Bildschirm wartet.
Es gibt vier Massenprüfungsprodukte, von denen jedes ein spezifisches Signal abdeckt:
| Massenprodukt | Abgedecktes Signal |
|---|---|
| Registrierung | Ob die Nummer zum Zeitpunkt der Prüfung ein WhatsApp-Konto hatte |
| Profilbild | Ob ein Profilbild für das Konto verfügbar ist |
| Business-Konto | Ob es sich um ein Konto vom Typ Business handelt |
| Aktivitätstage | Tage seit der letzten Aktivität |
Jedes Produkt hat seine eigenen Dateigrößenbeschränkungen. Lesen Sie daher die aktuelle API-Dokumentation, bevor Sie einen Durchlauf planen. Gehen Sie nicht davon aus, dass die Grenzwerte eines Produkts für ein anderes gelten.
Vorbereitung der Datei vor dem Hochladen
Die meisten fehlgeschlagenen oder ineffizienten Massenprüfungen lassen sich auf die Eingabedatei zurückführen. Gehen Sie diese Liste zuerst durch:
- Format. Verwenden Sie eine TXT- oder CSV-Datei mit einer Nummer pro Zeile. Tabellenformate wie XLSX werden nicht akzeptiert; exportieren Sie diese daher als CSV.
- Internationales Format. Geben Sie jede Nummer mit ihrer Landesvorwahl an, ohne Leerzeichen, Klammern oder Bindestriche. Nummern im lokalen Format ohne Landesvorwahl können nicht zuverlässig interpretiert werden.
- Ein Land pro Datei. Die Liste sollte im Wesentlichen dem von Ihnen ausgewählten Land entsprechen. Eine Datei mit einem erheblichen Anteil an Nummern aus anderen Ländern wird bei der Vorprüfung abgelehnt. Teilen Sie gemischte Listen daher zuerst nach Ländern auf.
- Deduplizierung. Wiederholte Zeilen werden wie jede andere Nummer berechnet; entfernen Sie diese daher vorab.
- Regionale Unterstützung prüfen. Massenprüfungen per Datei unterstützen keine Nummern aus Festlandchina, Hongkong oder Macau. Diese Regionen werden nur eingeschränkt durch Echtzeit-Einzelprüfungen unterstützt.
- Einwilligung. Bestätigen Sie, dass Sie eine rechtmäßige Grundlage haben, diese Personen zu kontaktieren, bevor die Datei für die Kontaktaufnahme verwendet wird.
Eine Ablehnung bei der Vorprüfung ist eine nützliche Frühwarnung. Sie kostet Sie nur wenige Minuten und keinen vollständigen Durchlauf mit einer fehlerhaften Datei.
Übermittlung der Aufgabe und Verfolgung des Status
Sie können eine Massenaufgabe über das Dashboard oder die API übermitteln. Der API-Ablauf verwendet POST /api/v1/bulk-tasks, um die Aufgabe zu erstellen, und GET /api/v1/bulk-tasks/{id}, um den Status abzurufen. Das Dashboard listet ebenfalls Ihre Massenaufgaben und deren Status auf, was praktisch ist, wenn eine Person und kein Skript den Vorgang ausführt.
Eine sinnvolle Routine ist:
- Wählen Sie das Massenprodukt, das dem benötigten Signal entspricht.
- Laden Sie die vorbereitete Datei hoch und übermitteln Sie diese.
- Bewahren Sie die Aufgabenreferenz auf, die Sie bei der Übermittlung erhalten haben.
- Fragen Sie den Status in angemessenen Abständen ab oder prüfen Sie das Dashboard, anstatt den Endpunkt zu überlasten. Die API-Dokumentation beschreibt Kontrollmechanismen für Nebenläufigkeit und Timeouts; konsultieren Sie diese für die aktuellen Nutzungsregeln.
- Laden Sie die Ergebnisdatei herunter, wenn die Aufgabe abgeschlossen ist.
Bei der Übermittlung wird ein Guthaben reserviert. Nach der Verarbeitung wird der ungenutzte Teil der Reservierung Ihrem Kontoguthaben gutgeschrieben, und eine fehlgeschlagene Aufgabe gibt die vollständige Reservierung frei. Dies ist eine buchhalterische Abstimmung, kein Rückerstattungsprogramm für reguläre Prüfungen. Abgeschlossene Ergebnisse werden berechnet, unabhängig davon, ob eine Nummer registriert ist oder nicht.
Korrektes Lesen der Ergebnisdatei
Die herunterladbare Ergebnisdatei ist eine CSV-Datei mit einer Zeile pro verarbeiteter Nummer. Betrachten Sie jede Zeile als Signal zum Zeitpunkt des Durchlaufs:
- Ein Ergebnis als Registriert bedeutet, dass zum Zeitpunkt der Prüfung ein Konto existierte.
- Ein Profilbild- oder Business-Wert ergänzt die Registrierung. Ein fehlendes Profilbild bedeutet nicht, dass die Nummer nicht registriert ist, und ein Business-Flag identifiziert den Kontotyp und nicht ein verifiziertes Unternehmen.
- Nummern, die nicht eindeutig bestimmt werden konnten, sollten in einem späteren Durchlauf erneut geprüft werden, anstatt sie als Nicht registriert zu behandeln.
Laden Sie die Datei zurück in Ihr CRM oder Marketing-Tool, verknüpfen Sie sie über die Telefonnummer und speichern Sie das Prüfdatum neben dem Ergebnis. Segmente werden dann zu einfachen Filtern: registrierte Nummern für die WhatsApp-Warteschlange, andere für verschiedene Kanäle.
Kombination von Massen- und Echtzeitprüfungen in einem Arbeitsablauf
Die meisten Teams verwenden beides. Führen Sie eine Massenaufgabe durch, um die bestehende Datenbank einmalig zu bereinigen, und verwenden Sie anschließend Echtzeitprüfungen für jeden neuen Kontakt, der hinzukommt. So bleibt die Liste aktuell, ohne dass große Aufgaben wiederholt werden müssen. Beide greifen auf dasselbe Kontoguthaben zu, sodass eine Aufladung das Dashboard, die API und Massenaufgaben abdeckt. Besuchen Sie die Preisseite für Details zum aktuellen Plan und Guthaben.
FAQ
Wie können Teams eine WhatsApp-Massenprüfung durchführen?
Laden Sie eine vorbereitete TXT- oder CSV-Datei über das Dashboard hoch oder erstellen Sie eine Aufgabe über die API. Verfolgen Sie anschließend den Aufgabenstatus und laden Sie die Ergebnisdatei herunter, sobald diese abgeschlossen ist.
Warum könnte eine Massendatei bei der Vorprüfung abgelehnt werden?
Eine Datei kann abgelehnt werden, wenn ein großer Teil der Nummern zu einem anderen Land gehört als dem ausgewählten oder wenn Nummern keine Landesvorwahl haben. Das Aufteilen der Liste nach Ländern vor dem Hochladen vermeidet dies.
Was geschieht mit dem ungenutzten reservierten Guthaben nach einer Massenaufgabe?
Das Guthaben wird bei der Übermittlung reserviert. Jeder ungenutzte Teil wird nach der Verarbeitung dem Kontoguthaben gutgeschrieben, und eine fehlgeschlagene Aufgabe gibt die vollständige Reservierung frei.
Wie unterscheidet sich eine Massenprüfung von einer Echtzeitprüfung?
Eine Echtzeitprüfung liefert die Antwort in derselben Anfrage. Eine Massenprüfung gibt zuerst eine Aufgabe zurück, verarbeitet die Datei separat und stellt später eine herunterladbare Ergebnisdatei bereit.
Mehr erfahren
Wählen Sie die Produktinformationen, die zum nächsten Schritt in Ihrem Arbeitsablauf passen.