Pengayaan Kontak CRM Telegram: Menambahkan Data Pendaftaran ke Rekam Kontak

Bagaimana tim penjualan dan CRM menambahkan kolom pendaftaran Telegram, serta opsional nama pengguna dan data aktivitas perkiraan, ke rekam kontak yang ada melalui panggilan API atau impor massal result.csv.

Pengayaan kontak CRM Telegram berarti menambahkan kolom terkait Telegram ke rekam kontak yang sudah Anda miliki, paling sering berupa status pendaftaran Telegram yang diberi tanggal untuk setiap nomor telepon. Dengan TG Validator, kontak baru atau yang telah diedit dapat diperiksa melalui API yang sama, sementara basis data yang ada dapat diisi ulang dengan menjalankan tugas massal dan mengimpor result.csv-nya. Kolom yang dihasilkan berfungsi paling baik sebagai salah satu sinyal perutean di samping data persetujuan dan keterlibatan, bukan sebagai vonis terhadap kontak tersebut.

Apa yang Dicakup oleh Pengayaan Kontak CRM Telegram

Hasil pencarian untuk kata kunci ini sebagian besar menjelaskan CRM yang dibangun di sekitar percakapan Telegram: alat yang menyinkronkan obrolan ke dalam alur kerja dan melampirkan riwayat pesan ke sebuah kesepakatan. Hal itu berguna ketika tim penjualan sudah berbicara dengan prospek di Telegram, tetapi tidak membantu tim yang memiliki ribuan rekam berbasis telepon dan ingin mengetahui mana di antaranya yang memiliki akun Telegram sebelum merencanakan saluran apa pun.

Panduan ini mencakup kasus kedua: memperkaya rekam yang sudah Anda miliki dengan sekumpulan kecil kolom yang diberi tanggal. Ini tidak melibatkan pembacaan obrolan, kontak, grup, atau konten profil pribadi. Pengayaan ini menjawab pertanyaan sempit:

• Apakah nomor telepon ini memiliki akun Telegram pada saat pemeriksaan?
• Jika tim menjalankan tugas aktivitas massal, nama pengguna dan perkiraan hari sejak aktivitas terakhir apa yang dikembalikan?
• Kapan informasi tersebut dihasilkan, dan oleh alur kerja yang mana?

Menjaga cakupan tetap sempit membuat data lebih mudah dijelaskan kepada perwakilan penjualan, lebih mudah disegarkan, dan lebih mudah dibenarkan di bawah aturan perlindungan data.

Merancang Kolom CRM Sebelum Melakukan Pemeriksaan

Tentukan di mana hasil akan disimpan sebelum menjalankan pemeriksaan pertama. Desain kolom yang direncanakan sejak awal menghindari catatan teks bebas yang tidak dapat difilter oleh siapa pun nantinya.

Dua pilihan desain akan membuahkan hasil nantinya. Pertama, pertahankan "Belum diperiksa" dan "Tidak dapat ditentukan" sebagai nilai terpisah dari "Tidak terdaftar"; menggabungkannya akan menyembunyikan rekam yang hanya perlu dicoba lagi. Kedua, simpan band aktivitas alih-alih jumlah hari mentah ketika CRM digunakan oleh orang-orang yang akan membaca angka tersebut sebagai sesuatu yang presisi. activedays bersifat perkiraan, jadi sebuah band mengomunikasikan tingkat keyakinan yang tepat.

Normalisasi Nomor Telepon Terlebih Dahulu

Kualitas pengayaan bergantung pada kolom telepon lebih dari pada pemeriksaan itu sendiri. Pemeriksaan nomor tunggal menerima satu nomor E.164: tanda plus, kode negara, dan nomor nasional, tanpa spasi, tanda baca, atau awalan trunk. Kolom telepon CRM sering kali menyimpan format lokal seperti 07700 900123, ekstensi, atau dua nomor dalam satu sel.

Urutan praktisnya:

1. Salin kolom telepon ke kolom kerja alih-alih menimpa yang asli.
2. Konversi setiap nilai ke E.164 dengan pustaka penguraian seperti libphonenumber milik Google, menggunakan negara rekam sebagai wilayah default.
3. Tandai nilai yang gagal diurai dan biarkan kolom Telegram-nya sebagai "Belum diperiksa".
4. Hapus duplikat pada nomor yang dinormalisasi agar nomor telepon yang sama tidak diperiksa beberapa kali untuk kontak duplikat.

Langkah ini juga menentukan rekam mana yang masuk ke file massal mana, karena tugas massal nomor telepon dibuat untuk satu negara yang dipilih.

Jalur A: Pengayaan API untuk Kontak Baru dan yang Diperbarui

Untuk rekam yang dibuat oleh formulir, impor, atau perwakilan penjualan, API REST yang sama sangat cocok dengan alur kerja CRM atau langkah middleware.

• Satu kontak: kirim nomor yang dinormalisasi ke POST /api/v1/check dengan header X-API-Key dan tipe layanan tg. Respons tiba dalam sesi yang sama, sehingga alur kerja dapat segera menulis kolom pendaftaran Telegram.
• Grup kecil: POST /api/v1/batch-check menerima hingga 100 nomor dalam satu permintaan, yang cocok untuk pekerjaan malam hari yang mengambil kontak yang diubah hari itu.
• Pemeriksaan yang tidak dapat ditentukan: pemeriksaan yang tidak dapat ditentukan mengembalikan kode bisnis non-nol dan tidak ada hasil yang lengkap. Tulis "Tidak dapat ditentukan" dengan tanggal dan coba lagi nanti alih-alih merekam nilai negatif.

Dokumentasi API saat ini menjelaskan kontrol konkurensi dan batas waktu per pengguna: lima pemeriksaan sekaligus, 60 detik untuk satu pemeriksaan, 300 detik untuk pemeriksaan multi, dan satu pemeriksaan multi per akun dalam satu waktu. Antrean yang mematuhi batas tersebut, dengan backoff pada batas waktu, menghindari lonjakan kesalahan. Tidak ada batas tingkat permintaan per menit yang dipublikasikan, jadi integrasi harus mengikuti kontrol yang didokumentasikan alih-alih tingkat yang diasumsikan. Setiap pemeriksaan yang selesai akan dikenakan biaya baik hasilnya positif maupun negatif, jadi memicu pemeriksaan hanya ketika kolom telepon benar-benar berubah menjaga penggunaan tetap proporsional dengan pengeditan nyata.

Jalur B: Mengisi Ulang Rekam yang Ada dengan Impor result.csv

Untuk basis data besar yang ada, tugas massal asinkron adalah pilihan yang lebih baik. Ini adalah alur kerja unggah-tunggu-unduh, terpisah dari API yang sama.

1. Ekspor nomor telepon yang dinormalisasi untuk satu negara, bersama dengan kunci rekam unik CRM, ke dalam lembar kerja.
2. Bangun file unggahan dengan satu nomor telepon per baris (TXT atau CSV) dan tanpa kolom lain.
3. Pilih layanan. tg_batch hanya mengembalikan pendaftaran. tg_active_batch menambahkan nama pengguna, pengidentifikasi pengguna Telegram numerik, dan activedays, yang mendukung band aktivitas. Pilih layanan yang lebih kecil jika aktivitas tidak diperlukan.
4. Kirim dan polling melalui area Bulk Check dasbor atau POST /api/v1/bulk-tasks, lalu periksa GET /api/v1/bulk-tasks/{id} tidak lebih dari sekali setiap 30 detik.
5. Unduh result.csv saat tugas melaporkan keberhasilan. File ini berisi kolom pengidentifikasi dan activated ditambah kolom khusus layanan, beberapa di antaranya mungkin kosong.
6. Gabungkan result.csv ke lembar kerja pada nomor telepon, sehingga setiap baris mendapatkan kembali kunci rekam CRM-nya.
7. Impor sebagai pembaruan. Di HubSpot, misalnya, impor mencocokkan rekam yang ada dengan pengidentifikasi unik seperti kunci rekam atau email, dan opsi "perbarui yang ada saja" mencegah impor membuat kontak baru.

Rekam yang nomornya tidak disertakan dalam tugas tetap "Belum diperiksa", yang membuat kesenjangan cakupan terlihat dalam laporan.

Menggunakan Pengayaan Telegram sebagai Sinyal Perutean

Setelah kolom ada, kolom tersebut dapat menginformasikan tampilan daftar, alur kerja, dan antrean perwakilan. Penggunaan umum meliputi:

• Perencanaan saluran: buat tampilan kontak dengan hasil pendaftaran Telegram positif dan persetujuan terdokumentasi untuk penjangkauan Telegram, dan simpan rekam lain dalam urutan email atau telepon.
• Pelaporan kualitas data: lacak bagian rekam yang "Belum diperiksa" atau "Tidak dapat ditentukan" berdasarkan sumber, yang sering kali mengungkapkan formulir yang mengumpulkan nomor dengan format buruk.
• Memprioritaskan tindak lanjut: gabungkan band aktivitas dengan riwayat keterlibatan CRM, sehingga akun yang sudah lama tenang tanpa balasan baru ditinjau sebelum menerima langkah urutan berikutnya.

Kolom pendaftaran adalah sinyal keberadaan akun pada saat pemeriksaan. Ini menginformasikan perutean tetapi tidak menetapkan siapa yang menggunakan akun tersebut, apakah kontak setuju dengan pesan Telegram, atau apakah mereka akan membalas. Oleh karena itu, alur kerja harus memasangkannya dengan kolom persetujuan yang sudah dikelola tim alih-alih memperlakukannya sebagai izin.

Menjaga Kolom yang Diperkaya Tetap Akurat Seiring Waktu

Data pengayaan menua. Orang mengubah nomor, dan Telegram menghapus akun setelah periode ketidakaktifan yang dapat disesuaikan pengguna. Pasal 5 GDPR meminta agar data pribadi dibatasi pada apa yang diperlukan dan dijaga keakuratannya serta, jika perlu, diperbarui, yang dalam istilah CRM diterjemahkan menjadi beberapa kebiasaan:

• Segarkan saat berubah: periksa kembali secara otomatis saat kolom telepon diedit.
• Segarkan sesuai jadwal: jalankan kembali tugas massal sebelum kampanye besar atau pada siklus tetap untuk rekam yang masih dalam alur kerja aktif.
• Kedaluwarsa nilai lama: alur kerja dapat mengatur ulang kolom pendaftaran ke "Belum diperiksa" setelah tanggal pemeriksaan melewati usia yang dipilih tim.
• Kumpulkan lebih sedikit: lewati perkiraan avatar dan profil kecuali proses terdokumentasi menggunakannya; nilai tg_profile_batch untuk usia, jenis kelamin, dan warna kulit adalah perkiraan, bukan identitas terverifikasi.

Riwayat pemeriksaan dasbor dan laporan penggunaan membantu merekonsiliasi apa yang ditampilkan CRM dengan apa yang sebenarnya diperiksa. Tim yang menguji pengaturan dapat menghubungi dukungan setelah mendaftar untuk menerima 100 pemeriksaan gratis, dan paket saat ini tercantum di halaman harga.

FAQ

Bagaimana tim dapat menambahkan data Telegram ke kontak CRM tanpa menyinkronkan obrolan?

Periksa nomor telepon yang dinormalisasi setiap kontak dengan API yang sama, atau jalankan tugas massal dan impor result.csv-nya, lalu tulis hasilnya ke kolom pendaftaran Telegram khusus dengan tanggal pemeriksaan. Tidak ada riwayat obrolan atau daftar kontak yang terlibat.

Layanan TG Validator mana yang cocok untuk pengisian ulang CRM satu kali?

tg_batch cocok jika hanya pendaftaran yang diperlukan. tg_active_batch cocok jika tim juga menginginkan nama pengguna dan perkiraan hari sejak aktivitas terakhir untuk band aktivitas. Keduanya berjalan sebagai tugas file asinkron untuk satu negara yang dipilih per file telepon.

Apa yang harus direkam CRM ketika pemeriksaan tidak dapat ditentukan?

Pemeriksaan yang tidak dapat ditentukan mengembalikan kode bisnis non-nol alih-alih hasil yang lengkap. Simpan nilai terpisah seperti "Tidak dapat ditentukan" dengan tanggal dan coba lagi nanti, sehingga rekam tersebut tidak disalahartikan sebagai kontak tanpa Telegram.

Seberapa sering kolom pengayaan Telegram harus disegarkan?

Segarkan setiap kali nomor telepon berubah, dan jalankan kembali pemeriksaan sebelum kampanye besar atau pada siklus reguler untuk rekam yang masih digunakan. Mengedaluwarsakan nilai setelah usia yang dipilih menjaga laporan agar tidak mengandalkan hasil lama.

Pelajari Lebih Lanjut

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

• Lihat dokumentasi produk →
• Bicara dengan tim →