Telegram-Massenprüfung von Nummern: So prüfen Sie große Listen auf Registrierung
So führen Sie eine Telegram-Massenprüfung durch: TXT oder CSV vorbereiten, Land wählen, tg_batch-Task senden, sparsam abfragen und result.csv lesen.
Eine Schritt-für-Schritt-Anleitung zur Überprüfung der Telegram-Registrierung für eine große Liste von Telefonnummern mittels eines asynchronen tg_batch-Tasks, von der Dateivorbereitung bis zur result.csv.
Eine Telegram-Massenprüfung ist ein asynchroner Prozess: Sie laden eine TXT- oder CSV-Datei mit einer Telefonnummer pro Zeile hoch, wählen das Land und den tg_batch-Dienst aus, warten auf den Abschluss des Tasks und laden anschließend eine result.csv herunter. Diese Datei gibt an, ob die jeweilige Nummer zum Zeitpunkt der Prüfung bei Telegram registriert war. Dies hilft Teams bei der Entscheidung, welche Datensätze in eine Telegram-Kontaktliste aufgenommen werden sollen. Da Telegram selbst keine offizielle Massenabfrage anbietet, benötigen große Listen einen dedizierten Prüfdienst anstelle einer einfachen Kopier-Einfüge-Lösung.
Wann ein Massen-Task das richtige Werkzeug ist
Echtzeit-Prüfungen liefern das Ergebnis innerhalb derselben Sitzung, was für eine einzelne Nummer oder eine kleine Liste ideal ist. Sobald eine Liste jedoch deutlich größer ist, als es eine einzelne Anfrage zulässt, ist ein asynchroner Task die bessere Wahl: Sie übergeben die Datei, die Verarbeitung erfolgt im Hintergrund und Sie rufen das Ergebnis anschließend ab.
| Situation | Bessere Lösung |
|---|---|
| Eine einzelne Nummer während einer Formulareingabe oder im Support-Chat | Echtzeit-Einzelprüfung |
| Eine kurze Liste, die direkt am Bildschirm geprüft wird | Echtzeit-Batch-Prüfung im Dashboard oder über den Batch-Endpunkt |
| Ein vollständiger CRM-Export oder eine gekaufte Lead-Datei | Asynchroner Massen-Task mit tg_batch |
Die produktbezogenen Limits für jeden Weg sind in der aktuellen API-Dokumentation aufgeführt. Prüfen Sie diese daher, bevor Sie einen großen Durchlauf planen.
Die Datei für eine Telegram-Massenprüfung vorbereiten
Die meisten fehlgeschlagenen oder abgelehnten Tasks sind auf die Eingabedatei zurückzuführen. Vor dem Hochladen:
- Verwenden Sie eine einfache TXT- oder CSV-Datei mit einer Telefonnummer pro Zeile. Tabellenformate wie XLSX werden nicht akzeptiert; exportieren Sie diese daher zuerst als CSV.
- Schreiben Sie jede Nummer mit ihrer internationalen Landesvorwahl.
- Wählen Sie ein Land für den Task aus. Massen-Tasks für Telefonnummern sind auf ein einzelnes ausgewähltes Land ausgelegt; eine Datei, die hauptsächlich Nummern aus anderen Ländern enthält, kann abgelehnt werden. Teilen Sie gemischte Listen nach Ländern auf und senden Sie pro Land einen Task.
- Entfernen Sie offensichtliche Duplikate und Leerzeilen, damit Sie nicht für die Prüfung derselben Nummer doppelt bezahlen.
- Halten Sie Nummern für Festlandchina, Hong Kong und Macau aus der Datei heraus: Asynchrone Massen-Tasks decken diese Regionen nicht ab.
Wenn Sie sich bei der Formatierung unsicher sind, lesen Sie den Leitfaden zur ITU-T Recommendation E.164, bevor Sie die Liste normalisieren.
Den tg_batch-Task senden und abwarten
Der reine Registrierungs-Massen-Dienst heißt tg_batch. Im Dashboard wählen Sie die Option Massenprüfung, laden die Datei hoch und wählen das Land sowie den Dienst aus. Über die API wird der Task mit POST /api/v1/bulk-tasks erstellt und der Status mit GET /api/v1/bulk-tasks/{id} abgefragt.
Drei Verhaltensweisen sollten bei der Planung berücksichtigt werden:
- Das Guthaben wird bei der Übermittlung reserviert. Die Plattform reserviert das Guthaben für die gesamte Datei im Voraus, berechnet die Einträge, die Ergebnisse geliefert haben, und gibt die nicht verbrauchte Reserve nach Abschluss des Tasks frei. Wenn ein Task fehlschlägt, wird die vollständige Reserve freigegeben.
- Es gibt keinen Fortschrittsbalken pro Nummer. Ein Task meldet lediglich processing, success oder failed. Gestalten Sie Ihren Workflow daher um diese drei Zustände herum statt um einen Fortschrittsbalken.
- Fragen Sie behutsam ab. Überprüfen Sie den Task-Status nicht öfter als alle 30 Sekunden. Häufigere Abfragen erhöhen die Last, ohne dass Ergebnisse schneller vorliegen.
Die Fertigstellungszeit hängt von der Datei ab; vermeiden Sie es daher, Stakeholdern eine feste Bearbeitungszeit zu versprechen.
result.csv lesen und entsprechend handeln
Ein abgeschlossener Task liefert Ihnen eine herunterladbare result.csv. Für tg_batch enthält diese die übermittelte Nummer und eine Spalte, die anzeigt, ob sie Registriert ist. Betrachten Sie diese Spalte als Signal für die Kontopräsenz bei Telegram zum Zeitpunkt der Prüfung.
Eine praktische Anwendung:
- Registriert: Behalten Sie den Kontakt im Telegram-Segment Ihrer Outreach-Liste.
- Nicht registriert: Leiten Sie den Kontakt an einen anderen Kanal weiter oder schließen Sie ihn von Telegram-Kampagnen aus.
- Fehlende oder leere Zeilen: Senden Sie diese in einem späteren, kleineren Task erneut oder prüfen Sie sie manuell.
Eine Registrierung bedeutet nicht, dass eine Person aktiv ist, dass die Nummer dem erwarteten Kontakt gehört oder dass eine Zustimmung zur Kontaktaufnahme vorliegt. Wenn Sie zusätzlich ein Signal für die ungefähre Aktualität benötigen, liefert ein anderer Massen-Dienst, tg_active_batch, zusätzliche Spalten. Halten Sie die Ausgaben der einzelnen Dienste getrennt, anstatt davon auszugehen, dass jede Datei dieselben Spalten enthält.
Häufige Fehler bei der Prüfung großer Listen
- Hochladen einer Datei mit gemischten Ländern und die Ablehnung als Lerneffekt nutzen.
- Absenden vor der Deduplizierung, was das reservierte Guthaben unnötig erhöht.
- Abfragen alle paar Sekunden in einer Schleife.
- Registrierung als Zustimmung oder Identitätsnachweis interpretieren.
- Die gesamte Datei erneut ausführen, um ein paar Zeilen zu korrigieren, anstatt nur die verbleibenden Nummern zu senden.
Details zur Abrechnung finden Sie auf der aktuellen Preisseite und in der API-Dokumentation, anstatt sich auf Zahlen aus Artikeln zu verlassen.
FAQ
Kann ein Team eine Telegram-Liste ohne eigenes Telegram-Konto prüfen?
Ja. Teams übermitteln die Datei über das Dashboard oder die REST-API an einen Prüfdienst und laden die result.csv herunter, sodass für die Prüfung kein persönlicher Telegram-Login erforderlich ist.
Wie können Teams eine Liste verarbeiten, die mehrere Länder enthält?
Teilen Sie die Datei nach Ländern auf und senden Sie für jedes Land einen tg_batch-Task, da Massen-Tasks für Telefonnummern an ein ausgewähltes Land gebunden sind.
Wie funktioniert das Guthaben bei einem Massen-Task?
Das Guthaben wird bei der Übermittlung des Tasks reserviert, für die Einträge mit Ergebnissen berechnet und der nicht verbrauchte Restbetrag wird freigegeben. Bei einem fehlgeschlagenen Task wird die vollständige Reserve freigegeben.
Bedeutet ein Ergebnis als Registriert, dass der Kontakt antworten wird?
Nein.
Mehr erfahren
Wählen Sie die Produktinformationen, die zum nächsten Schritt in Ihrem Workflow passen.