Mempartisi Daftar Telepon Lintas Negara ke dalam Tugas Pencarian Operator

Manifes negara-ke-file mengubah ekspor CRM campuran menjadi tugas Pencarian Operator spesifik negara yang telah ditinjau.

Untuk mempartisi daftar telepon lintas negara bagi tugas massal CarrierLookup, simpan ekspor sumber, uraikan setiap nomor ke dalam bentuk internasional, kelompokkan baris yang memenuhi syarat berdasarkan negara ISO yang dipilih, dan tulis satu file TXT atau CSV yang telah ditinjau per negara. Simpan manifes yang menghubungkan setiap file keluaran ke negaranya, baris input, pengecualian, dan hasil di kemudian hari. Layanan massal CarrierLookup memproses file negara yang dipilih; layanan ini tidak membagi ekspor campuran untuk tim Anda.

Mulailah dengan daftar sumber dan bukti negaranya

Bidang pasar CRM tidak cukup untuk menempatkan nomor ke dalam tugas massal. Seorang pelanggan mungkin tinggal di satu negara dan tetap menggunakan nomor dari negara lain. Mulailah dari kode negara internasional nomor telepon tersebut, dan simpan negara atau pasar CRM asli sebagai bidang bisnis terpisah. Rekomendasi ITU-T Recommendation E.164 mendefinisikan struktur penomoran internasional; rekomendasi ini juga mengakui kode penomoran yang mencakup rencana terintegrasi alih-alih label satu negara yang sederhana. Gunakan parser penomoran yang terpelihara dan periksa baris yang ambigu alih-alih menetapkan negara hanya dari digit pertama atau kolom spreadsheet saja.

Baca pengidentifikasi telepon sebagai teks. Perangkat lunak spreadsheet dan pembaca CSV dapat mengubah karakter awal atau menyimpulkan jenis numerik. Sebagai contoh, pandas read_csv documentation menjelaskan dtype eksplisit dan pembacaan dalam potongan (chunked). Tim yang menggunakan alat lain memerlukan properti yang sama: impor yang mempertahankan teks dan cara yang dapat diulang untuk menangani ekspor besar tanpa mengubah pengidentifikasi secara diam-diam.

Simpan file sumber yang tidak tersentuh dan referensi baris lokal. Jika nilai telepon tidak memiliki kode negara internasional, jangan menebaknya hanya agar baris tersebut lolos penerimaan massal. Tandai baris tersebut untuk peninjauan data sumber. Baris yang ditolak sebelum pengiriman harus tetap terlihat dalam laporan penerimaan, meskipun baris tersebut tidak pernah muncul dalam file hasil CarrierLookup.

Buat manifes negara-ke-file sebelum pengunggahan

Buat manifes dengan satu baris per file keluaran yang dituju. Bidang milik pelanggan yang disarankan adalah negara ISO yang dipilih, nama file keluaran, tanggal ekspor sumber, jumlah baris sumber, jumlah nomor unik yang disiapkan, jumlah baris yang dikecualikan, peninjau, dan checksum file. Simpan sidecar terpisah dari setiap nomor kanonik kembali ke setiap baris kontak asli. Ini adalah kontrol lokal, bukan bidang dalam respons atau CSV CarrierLookup.

Partisi hanya nomor berkode negara yang telah disiapkan ke dalam file TXT atau CSV satu kolom. Dokumentasi API CarrierLookup mengidentifikasi negara yang dipilih untuk layanan massal Pencarian Operator Asli global, sementara pencarian tunggal dan multi-nomor waktu nyata menerima nomor dari negara yang berbeda. Perbedaan inilah yang menyebabkan ekspor campuran memerlukan persiapan untuk massal, tetapi mungkin ditangani secara berbeda dalam alur kerja waktu nyata yang lebih kecil.

Manifes juga harus menyatakan alasan baris dikecualikan: kode negara hilang, nomor tidak dapat diuraikan, pengidentifikasi yang disiapkan duplikat, atau negara tidak disertakan dalam proses saat ini. Duplikat mungkin mewakili beberapa kontak sumber yang sah. Hapus duplikat kunci pengiriman sambil mempertahankan setiap hubungan baris sumber di sidecar; setelah hasil yang sukses, tim dapat dengan sengaja memetakan konteks alokasi kembali ke setiap catatan yang sesuai.

Jalankan laporan penerimaan untuk setiap partisi negara

Sebelum pengiriman, bandingkan setiap file dengan manifes. Periksa apakah setiap baris berisi satu nomor berkode negara, apakah negara yang dipilih konsisten dengan baris yang disiapkan, dan apakah tidak ada header atau kolom CRM yang masuk ke dalam file satu kolom. File tersebut pada dasarnya harus ditujukan untuk negara yang dipilih di bawah aturan layanan saat ini. Jangan menyatakan ambang batas baris atau ukuran file tetap dari ingatan; periksa informasi produk massal langsung dan dokumentasi API untuk batas penerimaan saat ini.

Laporan penerimaan dapat menunjukkan empat total: baris sumber yang dipertimbangkan, baris yang ditahan untuk perbaikan data, pengidentifikasi unik yang ditulis, dan baris sumber duplikat yang diwakili melalui sidecar. Hitung ulang total tersebut dari file alih-alih menyalinnya dari ekspor sebelumnya. Manifes yang menyatakan satu negara sementara filenya berisi negara lain adalah kesalahan operasional yang dapat dicegah; mintalah peninjau untuk membandingkan file dan negara yang dipilih sebelum pengiriman.

Perlakukan partisi negara kecil sebagai titik keputusan. Jika tidak memenuhi aturan penerimaan massal saat ini, tahan partisi tersebut atau gunakan alur kerja waktu nyata yang terdokumentasi jika sesuai. Jangan mengisinya dengan nomor yang diulang. CarrierLookup memiliki Pencarian Operator Asli sinkron untuk nomor individu dan permintaan multi-nomor, ditambah layanan file Pencarian Operator Asli global asinkron yang terpisah. Keduanya adalah alur kerja yang berbeda, dan tim harus memilih berdasarkan partisi aktual dan batas produk saat ini.

Kirim dan pantau setiap tugas secara terpisah

Untuk setiap partisi yang disetujui, kirim file dengan negara yang dipilih yang cocok dan catat referensi tugas yang dikembalikan dalam manifes. Jangan melampirkan file satu negara ke tugas negara lain hanya karena nama filenya terlihat mirip. Referensi API CarrierLookup mendokumentasikan titik akhir pengiriman massal dan status tugas; aturan API saat ini harus mengatur detail pengunggahan dan polling. Pemrosesan massal bersifat asinkron, jadi pengunggahan yang diterima bukanlah hasil operator yang selesai.

Lacak setiap tugas secara independen sebagai processing, success, atau failed. Tugas yang gagal selama persiapan mungkin telah mengecualikan baris yang tidak valid, duplikat, tanpa negara, atau di luar negara dan mungkin masih gagal dalam kondisi penerimaan lainnya. Simpan manifes dan kesalahannya untuk perbaikan. Jangan menyimpulkan nilai operator dari tugas yang gagal atau dari awalan nomor sumber. Tugas yang berhasil menyediakan satu CSV untuk nomor yang disiapkan, yang harus disimpan bersama manifes dan sidecar yang sesuai.

Setelah diunduh, periksa apakah file tersebut milik tugas dan negara yang dipilih yang dituju. Pengidentifikasi massal adalah digit biasa dengan kode negaranya, tanpa tanda plus atau spasi. Normalisasi kunci perbandingan milik pelanggan di kedua sisi sambil tetap menyimpan file mentah. Hasilnya menjelaskan operator yang dialokasikan secara asli, operator dasar, jenis saluran, dan geografi rentang nomor jika tersedia; ini bukan operator saat ini setelah porting atau lokasi langsung seseorang.

Rekonsiliasi hasil tanpa kehilangan kontak sumber

Gabungkan pengidentifikasi yang dikembalikan ke sidecar, bukan ke posisi baris CSV asli. Pra-pemrosesan massal dapat menghapus entri duplikat dan tidak valid, sehingga urutan baris bukanlah kunci gabungan yang dapat dipercaya. Hasilkan jumlah untuk pengidentifikasi yang dikembalikan, pengidentifikasi yang disiapkan yang tidak cocok, dan pengidentifikasi yang dikembalikan yang tidak cocok dengan manifes. Hentikan pembaruan CRM otomatis untuk kunci yang tidak terduga sampai operator melakukan investigasi.

Untuk nomor yang dibagikan oleh beberapa baris sumber, petakan satu pencarian yang selesai ke baris-baris tersebut dengan sengaja dan pertahankan waktu pengamatan serta referensi tugas yang sama. Jika nomor kontak berubah setelah ekspor, tandai konflik alih-alih menimpa data saat ini. Pemeriksaan versi opsional adalah pilihan integrasi pelanggan, bukan fitur produk. Simpan bidang operator yang kosong sebagai informasi alokasi yang tidak tersedia alih-alih mengodekannya ulang sebagai nomor yang tidak valid atau tidak dapat dijangkau.

Tindakan terakhir adalah mengirimkan file spesifik negara yang telah ditinjau melalui Pencarian Operator Asli global dan menyimpan manifesnya bersama hasilnya. Ini memberikan jalur yang dapat dilacak bagi operator CRM dari ekspor sumber campuran ke tugas terpisah dan kembali lagi, tanpa mengklaim bahwa data alokasi membuktikan jaringan saat ini, kemampuan untuk dihubungi, identitas, atau persetujuan.

FAQ

Bisakah CarrierLookup massal membagi CSV lintas negara secara otomatis?

Tidak ada pembagian seperti itu yang didokumentasikan. Siapkan file spesifik negara dan pilih negara yang sesuai untuk setiap tugas.

Apa yang harus dilakukan terhadap nomor dengan kode negara yang hilang?

Tahan nomor tersebut untuk peninjauan data sumber. Jangan membuat kode negara untuk meloloskan pengunggahan.

Haruskah hasil digabungkan ke ekspor asli berdasarkan nomor baris?

Tidak. Gunakan pengidentifikasi yang dikembalikan dan sidecar milik pelanggan yang memetakan setiap nomor yang disiapkan ke baris sumbernya.

Pelajari Lebih Lanjut

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

• Lihat dokumentasi produk →
• Hubungi tim →