Menggabungkan CSV Pencarian Operator ke Baris Kontak Asli
Panduan praktis untuk menggabungkan CSV hasil pencarian operator ke baris kontak asli, dengan batasan permintaan dan langkah peninjauan bagi tim data.
Untuk menggabungkan CSV Pencarian Operator kembali ke catatan kontak, buatlah sidecar lokal sebelum mengunggah: petakan setiap nomor dengan kode negara yang telah disiapkan ke setiap ID baris kontak asli yang menyediakannya.
Untuk menggabungkan CSV Pencarian Operator kembali ke catatan kontak, buatlah sidecar lokal sebelum mengunggah: petakan setiap nomor dengan kode negara yang telah disiapkan ke setiap ID baris kontak asli yang menyediakannya. Kirimkan hanya pengenal yang telah disiapkan untuk negara yang dipilih, lalu rekonsiliasi CSV yang dikembalikan berdasarkan pengenal, bukan berdasarkan posisi baris file. Hal ini menjaga kontak duplikat tanpa mengasumsikan bahwa layanan bulk mengembalikan satu baris untuk setiap catatan sumber.
Siapkan sidecar sebelum membuat file bulk
Pencarian Operator Asli secara realtime dari CarrierLookup mengembalikan operator yang dialokasikan secara asli, operator dasar, jenis nomor, dan geografi alokasi. Produk pencarian operator Global yang terpisah menangani tugas file asinkron. Halaman Global carrier lookup adalah jalur produk yang relevan. Bulk menerima TXT atau CSV satu kolom dengan nomor berkode negara di setiap baris dan satu negara ISO yang dipilih. File yang disiapkan harus ditujukan untuk negara yang dipilih tersebut. Jangan berasumsi bahwa produk menerima XLSX, skema campuran, atau file yang berisi ID baris CRM.
Ekspor CRM sumber mungkin berisi nomor yang berulang, format tampilan yang berbeda, nilai kosong, dan nomor di luar negara yang dituju. Sebelum pengiriman, buat pemetaan lokal dari nomor berkode negara kanonik ke daftar ID baris sumber. Simpan teks asli dan keputusan normalisasi di samping setiap baris untuk audit. Misalnya, dua kontak mungkin berbagi satu nomor switchboard bisnis; sidecar harus menyimpan kedua ID baris meskipun daftar yang dikirimkan berisi nomor tersebut satu kali. Ini adalah struktur data milik pelanggan, bukan kolom yang dikembalikan oleh produk bulk.
Pisahkan baris sumber yang ditolak dari pengenal yang disiapkan namun dikecualikan. Sebuah baris mungkin tidak dapat digunakan sebelum diunggah karena kurangnya konteks untuk normalisasi, sementara prapemrosesan bulk nantinya mungkin mengecualikan duplikat atau nomor di luar negara yang dipilih. Catat tahapannya dengan jelas.
Gunakan makna pengenal, bukan posisi baris, sebagai kunci gabungan
Tugas bulk yang berhasil mengembalikan satu CSV dengan pengenal dan kolom alokasi asli. Pengenal bulk adalah digit berkode negara tanpa tanda tambah atau spasi. CRM sumber mungkin menyimpan nomor E.164 dengan tanda tambah di depan, format nasional, atau tanda baca. Normalisasikan kedua sisi ke dalam bentuk perbandingan yang sama milik pelanggan sebelum menggabungkan, sambil tetap menyimpan setiap representasi asli secara terpisah. Jangan berasumsi bahwa urutan baris CSV cocok dengan urutan baris kontak; prapemrosesan dapat mengecualikan entri yang tidak valid atau duplikat.
Penggabungan ini bersifat many-to-one: beberapa baris kontak dapat merujuk ke satu nomor yang disiapkan dan satu baris pencarian yang dikembalikan. Perluas hasil kembali ke baris sumber tersebut hanya setelah memvalidasi kuncinya. Sebaliknya, jika pengenal yang dikembalikan tidak ada dalam manifes yang dikirimkan, karantinakan untuk ditinjau alih-alih melampirkannya ke baris terdekat. Ini adalah aturan rekonsiliasi, bukan klaim bahwa baris yang tidak terduga adalah perilaku produk yang normal.
Manifes yang ringkas dapat memuat ID baris sumber, teks telepon asli, nilai perbandingan yang dinormalisasi, negara yang dipilih, nama file yang disiapkan, dan referensi batch pengiriman. Ini adalah kolom metadata lokal. Kolom-kolom ini tidak boleh diiklankan sebagai kolom CSV CarrierLookup. API documentation harus digunakan untuk pengiriman tugas saat ini dan detail hasil.
Periksa pengecualian dan duplikat sebelum memperbarui catatan
Prapemrosesan bulk mengecualikan baris yang tidak valid, duplikat, nomor tanpa kode negara, dan nomor di luar negara yang dipilih. Baris yang dikecualikan tidak dikenakan biaya. Inilah sebabnya mengapa jumlah baris unggahan, jumlah valid yang disiapkan, dan jumlah hasil bisa berbeda. Rekonsiliasi ketiganya sebagai tiga kuantitas yang terpisah. Jangan mengisi operator baris yang dikecualikan dari baris keluaran yang berdekatan. Jika kontak sumber duplikat berbagi satu nomor yang dinormalisasi, aplikasi dapat memetakan satu hasil yang selesai kembali ke keduanya, dengan waktu pengamatan dan sumber yang sama.
Tugas mungkin gagal selama persiapan jika terlalu sedikit nomor seluler valid yang diperkirakan atau kondisi penerimaan lainnya gagal. Dalam kasus tersebut, jangan membuat baris hasil bayangan dari file input. Simpan manifes untuk diagnosis dan konsultasikan dokumentasi produk untuk batasan per produk saat ini. Artikel ini sengaja tidak menyatakan minimum tugas, maksimum, atau waktu penyelesaian normal tertentu. Tugas bulk bersifat asinkron, jadi tunggu hingga berhasil sebelum menggunakan CSV-nya.
Kolom CSV menjelaskan alokasi asli, bukan operator saat ini setelah porting nomor. Wilayah dan kota adalah geografi alokasi jangkauan, bukan lokasi kontak. Baris yang selesai dengan kolom alokasi kosong harus tetap menjadi baris yang selesai dengan nilai yang tidak tersedia, bukan dibuang sebagai gabungan yang tidak valid.
Buat laporan rekonsiliasi sebelum penulisan CRM
Laporan akhir milik pelanggan harus mencantumkan pengenal unik yang dikirimkan, pengenal yang dikembalikan, kunci yang dikirimkan namun tidak cocok, kunci yang dikembalikan namun tidak terduga, baris sumber yang nomornya ditolak sebelum diunggah, dan baris sumber duplikat yang akan menerima hasil yang sama. Peninjau harus menyetujui kebijakan penggabungan untuk kasus yang tidak cocok sebelum penulisan dimulai. Simpan CSV mentah dan sidecar di bawah kebijakan akses dan retensi organisasi sendiri agar audit di kemudian hari dapat mereproduksi pemetaan tersebut.
Untuk setiap pembaruan CRM, periksa apakah kontak masih membawa nomor yang dinormalisasi yang sama. Jika nomor berubah saat tugas berjalan, tandai sebagai konflik alih-alih menimpa catatan saat ini dengan konteks operator yang usang. Pemeriksaan versi catatan opsional dapat membantu integrasi pelanggan dalam menegakkan aturan tersebut; ini bukan fitur CarrierLookup. Simpan sumber pencarian dan waktu pengamatan dengan kolom alokasi asli.
Setelah uji coba, ambil sampel nomor yang berulang, nomor yang dikecualikan selama persiapan, hasil kolom kosong yang selesai, dan kontak yang diedit selama tugas. Hasil yang diharapkan masing-masing adalah perluasan many-to-one yang disengaja, tidak ada hasil operator yang dibuat-buat, nilai kosong yang dipertahankan, dan konflik yang ditangguhkan. Validasi ini menargetkan risiko nyata dari alur kerja file: memetakan pencarian yang benar secara teknis ke kontak yang salah.
Jika satu baris sumber berisi beberapa kolom telepon, catat kolom mana yang menghasilkan setiap pengenal yang disiapkan. Nomor kontak utama dan nomor alternatif tidak boleh menerima nilai operator yang dapat dipertukarkan. Sidecar kemudian dapat menjelaskan mengapa baris CSV yang selesai memperbarui satu kolom tetapi membiarkan kolom lainnya tidak tersentuh, bahkan ketika kedua nilai tersebut milik orang atau catatan perusahaan yang sama.
FAQ
Haruskah tim menggabungkan baris CSV bulk berdasarkan posisi?
Tidak. Gunakan pengenal berkode negara yang dikembalikan dan pemetaan sidecar lokal ke ID baris sumber; prapemrosesan dapat menghapus baris.
Bagaimana cara menangani kontak duplikat dengan satu nomor telepon?
Simpan setiap ID baris sumber di sidecar, kirimkan pengenal yang disiapkan satu kali jika perlu, dan petakan hasil yang selesai kembali ke setiap baris yang cocok secara sengaja.
Apa yang terjadi pada nomor yang dikecualikan selama persiapan?
Simpan dalam laporan pengecualian dan jangan membuat hasil operator untuk baris sumber tersebut.
Bisakah CSV menunjukkan jaringan atau lokasi kontak saat ini?
Tidak. CSV melaporkan operator asli dan geografi alokasi rentang nomor, yang bukan merupakan fakta jaringan saat ini atau lokasi orang.
Pelajari Lebih Lanjut
Pilih informasi produk yang sesuai dengan langkah berikutnya dalam alur kerja Anda.