Pemeriksa Nomor Telegram — Verifikasi Akun Secara Massal melalui Platform atau API

Pemeriksa nomor Telegram memproses nomor telepon dalam format E.164 dan mengembalikan sinyal Telegram per baris. Gunakan tugas dasar tg jika Anda hanya memerlukan status pendaftaran. Pemeriksaan aktivitas dan profil publik adalah produk terpisah dengan kolom dan biaya yang berbeda; jangan berasumsi bahwa hasil dasar sudah memuatnya.

Anda dapat menjalankan batch tanpa kode di antarmuka produk Telegram, atau mengotomatiskan daftar berulang dengan REST API yang dijelaskan di bawah ini.

Pilih kedalaman hasil Telegram terlebih dahulu

Pemeriksaan	Tipe tugas API	Output utama	Paling cocok untuk
Pendaftaran	`tg`	Nomor yang dikirim dan status pendaftaran	Menghapus baris yang tidak terdaftar dan segmentasi daftar dasar
Aktivitas	`tg_active`	Pendaftaran serta ID, waktu terakhir terlihat, hari aktif, dan status anggota yang tersedia	Segmentasi internal berdasarkan kebaruan aktivitas
Profil publik	`tg_avatar`	Pendaftaran serta profil, avatar, aktivitas, dan atribut turunan gambar yang tersedia	Peninjauan pengayaan profil yang sah

Kolom profil opsional dapat kosong. Atribut usia dan gender yang diturunkan dari avatar publik adalah perkiraan probabilistik, bukan fakta terverifikasi, dan tidak boleh digunakan untuk membuat keputusan penting tentang seseorang. Halaman produk Telegram saat ini menampilkan output yang dikonfigurasi untuk setiap tingkat.

Siapkan file input

Buat file .txt atau .csv dengan satu nomor telepon berformat internasional per baris. Simpan ID catatan stabil Anda sendiri di sistem sumber agar setiap baris hasil ekspor dapat dipetakan kembali dengan aman.

+14155550100
+41798284651
+447700900123

Validasi kode negara dan hapus ekstensi sebelum mengirim. Kesalahan format harus diperlakukan berbeda dari hasil “tidak terdaftar” yang sudah pasti.

Kirim tugas pendaftaran Telegram

Referensi resmi: Telegram Bulk CheckNumber API.

POST https://api.checknumber.ai/v1/tasks

Parameter	Deskripsi
`file`	Satu nomor telepon E.164 per baris
`task_type`	`tg` untuk pemeriksaan pendaftaran Telegram dasar

curl --location 'https://api.checknumber.ai/v1/tasks' \
  --header 'X-API-Key: API-KEY' \
  --form 'file=@"./numbers.txt"' \
  --form 'task_type="tg"'

Simpan task_id yang dikembalikan. Jangan tampilkan kunci API di kode sisi klien, log browser, event analitik, atau tangkapan layar yang dibagikan.

Polling tugas dan unduh hasil

POST https://api.checknumber.ai/v1/gettasks

curl --location 'https://api.checknumber.ai/v1/gettasks' \
  --header 'X-API-Key: API-KEY' \
  --form 'task_id="TASK_ID"'

Lakukan polling dengan interval yang wajar alih-alih mengirim permintaan terus-menerus. Ketika tugas mencapai exported, ambil file dari result_url.

Kolom tugas	Arti
`created_at`, `updated_at`	Stempel waktu pembuatan dan status terbaru
`task_id`	Pengenal yang digunakan untuk permintaan status
`status`	Misalnya `pending`, `processing`, atau `exported`
`total`	Jumlah baris yang dikirim dalam tugas
`success`, `failure`	Jumlah baris yang selesai dan yang gagal
`result_url`	Lokasi unduhan setelah ekspor

Untuk tugas dasar tg, kolom hasil yang penting adalah Number yang dikirim dan putusan pendaftaran telegram. Ikuti dokumentasi untuk kunci respons terbaru alih-alih menulis kolom secara permanen berdasarkan ekspor lama.

Tangani kegagalan tanpa merusak daftar

Respons	Penagihan menurut API	Perilaku aplikasi
`200`	Permintaan berhasil yang dikenai biaya	Simpan ID tugas atau status yang dikembalikan
`400`	Tidak dikenai biaya	Perbaiki parameter atau format file sebelum mencoba lagi
`500`	Tidak dikenai biaya	Coba lagi nanti dengan backoff

Pertahankan tiga kelompok dalam pemrosesan lanjutan: terdaftar (pasti), tidak terdaftar (pasti), dan belum terselesaikan/error. Mengulang hanya baris yang belum terselesaikan mencegah kegagalan sementara dianggap sebagai hasil Telegram yang negatif.

Apa yang tidak dibuktikan oleh pendaftaran Telegram

Kecocokan pendaftaran tidak membuktikan bahwa akun baru-baru ini aktif, milik orang yang dimaksud, menyetujui untuk dihubungi, atau akan merespons. Demikian pula, sinyal terakhir terlihat atau profil publik dapat kosong karena kondisi ketersediaan dan privasi.

Gunakan kedalaman hasil minimum yang dibutuhkan alur kerja Anda, dokumentasikan alasan data diproses, dan terapkan persyaratan privasi serta penjangkauan setempat. CheckNumber.AI tidak perlu mengirim pesan ke nomor yang dikirim untuk menghasilkan hasil pendaftaran yang dijelaskan.

Daftar periksa implementasi

Normalisasikan nomor ke E.164 dan pertahankan ID catatan sumber.
Pilih tg, tg_active, atau tg_avatar berdasarkan kolom yang dibutuhkan—bukan berdasarkan kolom terbanyak yang tersedia.
Kirim satu tugas khusus platform dan simpan task_id-nya.
Lakukan polling dengan backoff hingga tugas mencapai status akhir.
Segera unduh hasil dan pisahkan hasil yang pasti dari error.
Tinjau dokumentasi API resmi dan harga terbaru sebelum digunakan di produksi.

Pertanyaan yang sering diajukan

Berapa lama tugas berisi satu juta nomor diproses?

Waktu pemrosesan bervariasi menurut beban server dan batas laju platform. Jangan merancang integrasi berdasarkan waktu penyelesaian yang dijamin; pantau status tugas sebagai gantinya.

Apakah pemeriksaan ini mengirim pesan Telegram?

Tidak. Pemeriksaan pendaftaran tidak mengirim pesan atau notifikasi ke nomor yang dikirim.

Bisakah satu tugas memeriksa Telegram dan platform lain?

Tidak. Setiap tugas bersifat khusus platform. Kirim tugas terpisah jika alur kerja membutuhkan hasil dari lebih dari satu platform.

Apa yang terjadi jika kredit yang tersedia tidak mencukupi?

Baris yang berhasil diproses memakai kredit. Tinjau status tugas dan status baris yang dikembalikan alih-alih berasumsi bahwa setiap baris yang dikirim telah selesai.

Pemeriksa Nomor Telegram — Verifikasi Akun Secara Massal melalui Platform atau API | CheckNumber.AI