Menemukan Nama Pengguna Telegram di Balik Daftar Nomor Telepon

Panduan untuk menambahkan nama pengguna Telegram ke daftar nomor telepon spesifik negara dengan layanan massal tg_active_batch, termasuk persiapan berkas, kolom result.csv, nama pengguna kosong, dan penggunaan yang bertanggung jawab.

Untuk menemukan nama pengguna Telegram di balik nomor telepon dalam daftar bisnis, jalankan daftar tersebut melalui tugas aktivitas massal seperti tg_active_batch dari TG Validator, yang mengembalikan status pendaftaran Telegram beserta uid, nama pengguna, dan activedays untuk setiap nomor. Kolom nama pengguna akan kosong jika akun tidak memiliki nama pengguna publik, karena nama pengguna bersifat opsional di Telegram. Perlakukan hasil ini sebagai pengayaan daftar untuk data yang sudah dimiliki tim, bukan sebagai cara untuk mencari orang yang tidak dikenal.

Mengapa tim mencari nama pengguna Telegram berdasarkan nomor telepon

Sebagian besar panduan untuk frasa ini menjelaskan rute konsumen: simpan nomor di kontak Anda, buka profil di aplikasi, dan baca nama pengguna jika ditampilkan. Cara itu berhasil untuk satu teman. Cara tersebut tidak berhasil untuk ekspor CRM yang berisi ribuan prospek, dan cara itu menyalurkan data bisnis melalui buku alamat pribadi staf.

Tim bisnis biasanya memiliki tujuan yang berbeda:

• Tim dukungan menginginkan nama pengguna agar agen dapat menautkan ke profil Telegram pelanggan dengan tautan t.me saat pelanggan meminta untuk dihubungi di sana.
• Tim komunitas dan pertumbuhan ingin mencocokkan kontak yang ada dengan nama pengguna yang sudah muncul di grup atau saluran mereka sendiri.
• Tim CRM menginginkan kunci Telegram yang stabil di samping setiap catatan telepon agar duplikat dapat digabungkan.

Ketiganya merupakan pekerjaan pengayaan pada catatan yang sudah dimiliki organisasi. Pembingkaian tersebut penting bagi metode dan cara data digunakan setelahnya.

Hubungan antara nama pengguna Telegram dan nomor telepon

Di Telegram, nomor telepon membuat akun, sementara nama pengguna adalah pegangan publik opsional. Telegram FAQ menjelaskan bahwa pengguna tidak perlu memiliki nama pengguna, dapat mengatur atau menghapusnya di Pengaturan, dan dapat membagikan tautan t.me agar orang lain dapat menghubungi mereka tanpa melihat nomor mereka. Pengguna juga memutuskan siapa yang dapat melihat nomor telepon mereka dan siapa yang dapat menemukan mereka melalui nomor tersebut.

Dua konsekuensi praktis yang muncul:

1. Banyak akun tidak memiliki nama pengguna, jadi kolom nama pengguna yang kosong adalah hasil yang normal, bukan kesalahan.
2. Nama pengguna dapat berubah atau dihapus. Nama pengguna yang diambil hari ini harus mencantumkan tanggal saat data tersebut diambil.

Uid Telegram berbeda: ini adalah pengidentifikasi akun numerik dan tidak berubah saat nama pengguna berubah. Hal ini menjadikan uid sebagai kunci gabungan yang lebih baik untuk deduplikasi daripada nama pengguna.

Layanan TG Validator mana yang mengembalikan nama pengguna

Pemeriksaan Pendaftaran Telegram untuk satu nomor, di dasbor atau melalui POST /api/v1/check, hanya mengembalikan status pendaftaran Telegram. Ini adalah alat yang tepat untuk menentukan apakah suatu nomor memiliki akun Telegram, tetapi tidak mengembalikan nama pengguna.

Nama pengguna berasal dari layanan aktivitas massal asinkron, tg_active_batch. Untuk setiap nomor telepon, layanan ini mengembalikan:

Kolom tambahan bergantung pada jenis layanan dan mungkin kosong untuk beberapa baris. Jika tim juga memerlukan URL avatar dan perkiraan berbasis avatar, tg_profile_batch adalah layanan profil terpisah; untuk pekerjaan ini, tg_active_batch adalah pilihan yang terfokus.

Langkah demi langkah: dari daftar telepon ke kolom nama pengguna

1. Pilih satu negara per berkas. Tugas massal nomor telepon memerlukan satu negara yang dipilih, dan berkas tersebut harus berisi nomor dari negara tersebut. Jika 10% atau lebih nomor menggunakan kode negara lain, berkas akan ditolak, jadi pisahkan daftar campuran berdasarkan negara terlebih dahulu.
2. Normalisasi ke format internasional. Gunakan kode negara sebagaimana didefinisikan dalam ITU-T Recommendation E.164, hapus angka nol utama, spasi, dan simbol, lalu lakukan deduplikasi.
3. Simpan sebagai TXT atau CSV dengan satu nomor per baris. Batas per produk untuk ukuran berkas dan entri berlaku; periksa dokumentasi API saat ini.
4. Buat tugas di area Bulk Check dasbor atau dengan POST /api/v1/bulk-tasks, pilih tg_active_batch dan negaranya.
5. Tunggu tugas selesai. Tugas melaporkan status pemrosesan, keberhasilan, atau kegagalan. Saat melakukan polling melalui API, lakukan polling tidak lebih sering dari setiap 30 detik.
6. Unduh result.csv dan gabungkan kembali ke daftar sumber pada kolom identifier.

Saldo dicadangkan saat tugas dikirimkan. Saat tugas selesai, entri yang mengembalikan hasil akan dikenakan biaya dan cadangan yang tidak terpakai akan dirilis; tugas yang gagal akan merilis seluruh cadangannya.

Nomor dari Tiongkok Daratan (+86), Hong Kong (+852), dan Makau (+853) tidak didukung dalam tugas berkas massal, jadi jangan sertakan nomor tersebut dalam unggahan.

Membaca dan menyimpan hasil nama pengguna

Setelah result.csv digabungkan kembali ke daftar, urutkan baris ke dalam kelompok praktis:

• Akun ada, nama pengguna ada. Simpan nama pengguna dan uid di kolom CRM khusus dengan tanggal tugas.
• Akun ada, nama pengguna kosong. Akun tersebut ada tetapi tidak memiliki pegangan publik. Simpan uid untuk deduplikasi dan biarkan kolom nama pengguna kosong daripada membuat nilai sendiri.
• Tidak ada akun. Tandai kolom Telegram dan simpan nomor untuk saluran lain.
• Kolom kosong karena alasan lain. Beberapa kolom tambahan mungkin kosong untuk beberapa baris; perlakukan sebagai tidak diketahui, bukan sebagai nol.

Beberapa kebiasaan penyimpanan mencegah kebingungan di kemudian hari:

• Simpan nama pengguna tanpa awalan @ dan normalisasi menjadi huruf kecil, karena nama pengguna Telegram tidak peka huruf besar-kecil.
• Lakukan penggabungan kunci pada uid jika ada, karena nama pengguna dapat diubah atau dilepaskan.
• Simpan activedays sebagai nilai perkiraan dengan tanggalnya; ini menjelaskan hari sejak aktivitas terakhir, bukan apakah orang tersebut sedang daring sekarang.
• Segarkan pengayaan sesuai jadwal yang sesuai dengan alur kerja alih-alih menganggap satu kali proses sebagai permanen.

Pengayaan daftar, bukan pencarian orang

Nama pengguna memberi tahu tim pegangan publik mana yang terlampir pada akun Telegram untuk nomor yang sudah dimilikinya. Hal ini tidak mengungkapkan siapa pemilik telepon tersebut, tidak mengonfirmasi bahwa prospek adalah orang yang mereka klaim, dan bukan izin untuk mengirim pesan kepada mereka.

Tim yang bertanggung jawab menetapkan beberapa aturan internal sebelum menjalankan pengayaan:

• Hanya perkaya nomor yang dikumpulkan untuk tujuan yang mencakup kontak atau dukungan Telegram.
• Batasi kolom yang disimpan sesuai dengan yang digunakan alur kerja. Panduan ICO Inggris tentang data minimisation meminta data pribadi agar memadai, relevan, dan terbatas pada apa yang diperlukan.
• Perbaiki atau hapus nilai yang kedaluwarsa, sejalan dengan prinsip akurasi ICO.
• Hormati pengguna yang memilih untuk tidak mengatur nama pengguna; kolom kosong adalah pilihan mereka, bukan celah untuk diisi dengan cara lain.

Aturan ini adalah contoh kebijakan internal, bukan nasihat hukum untuk yurisdiksi tertentu.

FAQ

Mengapa kolom nama pengguna kosong untuk beberapa nomor yang memiliki akun Telegram?

Nama pengguna bersifat opsional di Telegram. Jika akun tidak memiliki nama pengguna publik, tg_active_batch tetap melaporkan status pendaftaran dan kolom lain yang tersedia, tetapi kolom nama pengguna tetap kosong.

Bisakah pemeriksaan satu nomor mengembalikan nama pengguna Telegram?

Tidak. Pemeriksaan Pendaftaran Telegram untuk satu nomor hanya mengembalikan status pendaftaran. Nama pengguna, uid, dan activedays berasal dari layanan massal tg_active_batch.

Bagaimana tim dapat menggunakan nama pengguna yang sudah mereka miliki untuk memperkaya catatan?

Jika daftar awal berisi nama pengguna alih-alih nomor telepon, layanan tg_username_batch terpisah memeriksa apakah nama pengguna tersebut milik akun yang ada, dan tg_username_profile_batch menambahkan uid, activedays, dan URL avatar. Tugas nama pengguna tidak memerlukan negara dan menerima pegangan dengan atau tanpa @.

Haruskah tim memberi kunci catatan CRM pada nama pengguna Telegram atau uid?

Uid adalah kunci yang lebih baik karena tetap sama saat pengguna mengubah atau menghapus nama pengguna. Simpan nama pengguna sebagai kolom tampilan dengan tanggal saat data tersebut diambil.

Pelajari Lebih Lanjut

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

• Lihat dokumentasi produk →
• Hubungi tim →