Pemeriksaan Nomor Telegram Massal: Cara Memeriksa Daftar Nomor Besar untuk Pendaftaran

Panduan langkah demi langkah untuk memeriksa pendaftaran Telegram bagi daftar nomor telepon yang besar dengan tugas asinkron tg_batch, mulai dari persiapan file hingga result.csv.

Pemeriksaan nomor Telegram massal adalah tugas asinkron: Anda mengunggah file TXT atau CSV dengan satu nomor telepon per baris, memilih negara dan layanan tg_batch, menunggu tugas selesai, lalu mengunduh satu file result.csv. Layanan ini memberi tahu Anda apakah setiap nomor terdaftar di Telegram pada saat pemeriksaan, yang membantu tim memutuskan catatan mana yang akan disimpan dalam daftar jangkauan Telegram. Telegram sendiri tidak menawarkan pencarian massal resmi, sehingga daftar yang besar memerlukan layanan pemeriksaan khusus alih-alih sekadar menempelkan daftar.

Kapan tugas massal menjadi alat yang tepat

Pemeriksaan waktu nyata (realtime) memberikan hasil dalam sesi yang sama, yang cocok untuk satu nomor atau daftar tempel kecil. Setelah daftar jauh lebih besar daripada yang dapat ditangani oleh satu permintaan, tugas asinkron adalah pilihan yang lebih tepat: Anda menyerahkan file, pekerjaan berjalan di latar belakang, dan Anda mengumpulkan hasilnya setelah selesai.

Batas per-produk untuk setiap rute tercantum dalam dokumentasi API saat ini, jadi periksalah sebelum merencanakan proses yang besar.

Siapkan file untuk pemeriksaan nomor Telegram massal

Sebagian besar tugas yang gagal atau ditolak berasal dari file input. Sebelum mengunggah:

• Gunakan file TXT atau CSV biasa dengan satu nomor telepon per baris. Format spreadsheet seperti XLSX tidak diterima, jadi eksporlah ke CSV terlebih dahulu.
• Tulis setiap nomor dengan kode negara internasionalnya.
• Pilih satu negara untuk tugas tersebut. Tugas massal nomor telepon dibuat berdasarkan satu negara yang dipilih, dan file yang sebagian besar berisi nomor dari kode negara lain dapat ditolak. Pisahkan daftar campuran berdasarkan negara dan kirimkan satu tugas per negara.
• Hapus duplikat yang jelas dan baris kosong agar Anda tidak membayar untuk memeriksa nomor yang sama dua kali.
• Jauhkan nomor untuk wilayah Tiongkok daratan, Hong Kong, dan Makau dari file: tugas massal asinkron tidak mencakup wilayah tersebut.

Jika format tidak pasti, bacalah panduan tentang ITU-T Recommendation E.164 sebelum Anda menormalisasi daftar tersebut.

Kirim tugas tg_batch dan tunggu

Layanan massal khusus pendaftaran disebut tg_batch. Di dasbor, Anda memilih opsi Pemeriksaan Massal, mengunggah file, serta memilih negara dan layanan. Melalui API, tugas dibuat dengan POST /api/v1/bulk-tasks dan statusnya dibaca dengan GET /api/v1/bulk-tasks/{id}.

Tiga perilaku yang perlu direncanakan:

1. Saldo dicadangkan saat pengiriman. Platform menahan saldo untuk seluruh file di muka, mengenakan biaya untuk entri yang memberikan hasil, dan melepaskan cadangan yang tidak terpakai saat tugas selesai. Jika tugas gagal, seluruh cadangan akan dilepaskan.
2. Tidak ada progres per-nomor. Tugas melaporkan status processing, success, atau failed, jadi bangun alur kerja berdasarkan ketiga status tersebut alih-alih bilah progres.
3. Polling dengan bijak. Periksa status tugas tidak lebih sering dari setiap 30 detik. Polling yang lebih cepat menambah beban tanpa memberikan hasil lebih cepat.

Waktu penyelesaian bergantung pada file, jadi hindari menjanjikan tenggat waktu tetap kepada pemangku kepentingan.

Baca result.csv dan tindak lanjuti

Tugas yang selesai memberi Anda satu file result.csv yang dapat diunduh. Untuk tg_batch, file ini berisi nomor yang dikirimkan dan kolom yang menunjukkan apakah nomor tersebut terdaftar. Anggap kolom tersebut sebagai sinyal keberadaan akun Telegram pada saat pemeriksaan.

Cara praktis untuk menggunakannya:

• Terdaftar: simpan dalam segmen Telegram dari daftar jangkauan.
• Tidak terdaftar: arahkan ke saluran lain atau keluarkan dari kampanye Telegram.
• Baris yang hilang atau kosong: kirimkan kembali dalam tugas yang lebih kecil di kemudian hari atau tinjau secara manual.

Pendaftaran tidak menunjukkan bahwa seseorang aktif, bahwa nomor tersebut milik kontak yang Anda harapkan, atau bahwa mereka setuju untuk dihubungi. Jika Anda juga memerlukan sinyal kekinian (recency) perkiraan, layanan massal yang berbeda, tg_active_batch, akan memberikan kolom tambahan; simpan output setiap layanan secara terpisah alih-alih berasumsi bahwa setiap file memiliki kolom yang sama.

Kesalahan umum dalam pemeriksaan daftar besar

• Mengunggah file dengan negara campuran dan membiarkan penolakan mengajarkan Anda aturannya.
• Mengirimkan sebelum menghapus duplikat, yang meningkatkan saldo yang dicadangkan.
• Melakukan polling setiap beberapa detik dalam sebuah loop.
• Menganggap pendaftaran sebagai bukti persetujuan atau identitas.
• Menjalankan ulang seluruh file untuk memperbaiki beberapa baris alih-alih hanya mengirimkan sisanya.

Untuk detail penagihan, lihat halaman harga saat ini dan dokumentasi API alih-alih mengandalkan angka yang dikutip dalam artikel.

FAQ

Bisakah tim memeriksa daftar Telegram tanpa memiliki akun Telegram sendiri?

Ya. Tim mengirimkan file ke layanan pemeriksaan melalui dasbor atau REST API dan mengunduh result.csv, sehingga tidak diperlukan login Telegram pribadi untuk pemeriksaan tersebut.

Bagaimana tim dapat menangani daftar yang berisi beberapa negara?

Pisahkan file berdasarkan negara dan kirimkan satu tugas tg_batch untuk masing-masing negara, karena tugas massal nomor telepon terikat pada negara yang dipilih.

Bagaimana cara kerja saldo untuk tugas massal?

Saldo dicadangkan saat tugas dikirimkan, dikenakan biaya untuk entri yang memberikan hasil, dan sisa yang tidak terpakai akan dilepaskan. Tugas yang gagal akan melepaskan seluruh cadangannya.

Apakah hasil Terdaftar berarti kontak akan membalas?

Tidak.

Pelajari Lebih Lanjut

Pilih informasi produk yang sesuai dengan langkah berikutnya dalam alur kerja Anda.

• Lihat dokumentasi produk →
• Hubungi tim →