Menormalisasi Nomor Telepon ke E.164 di BigQuery untuk Pencarian

Untuk menormalisasi nomor telepon ke E.164 di BigQuery sebelum Pencarian Operator Asli, pertahankan kolom mentah, hapus karakter presentasi, dan tambahkan kode negara hanya jika kolom negara yang otoritatif mendukung pilihan tersebut. Pertahankan tanda plus di depan untuk permintaan waktu nyata CarrierLookup. Untuk tugas file satu negara, ekspor digit berkode negara dan rekonsiliasi CSV yang dikembalikan menggunakan kunci yang stabil.

Pertahankan nomor asli dan bukti negaranya

Jangan menimpa satu-satunya salinan nomor telepon selama pembersihan. Buat kolom terpisah untuk nilai mentah, negara asal, kandidat yang dinormalisasi, dan alasan penolakan atau peninjauan manual. Sumber mungkin berisi awalan panggilan nasional, format lokal, atau kode negara yang ditulis secara tidak konsisten. Regex dapat menghapus tanda baca, tetapi tidak dapat memutuskan negara mana yang menjadi asal nomor tersebut. Keputusan itu memerlukan kolom negara yang tepercaya atau bukti sumber resmi lainnya.

ITU-T Recommendation E.164 mendefinisikan struktur penomoran internasional. Pemeriksaan waktu nyata CarrierLookup memerlukan tanda + di depan, kode negara, dan nomor pelanggan tanpa spasi atau pemisah. Kandidat yang hanya terlihat seperti digit tidak secara otomatis menjadi nomor yang valid. Jauhkan nilai yang tidak pasti dari set pencarian sampai manusia atau aturan penomoran yang tervalidasi menyelesaikannya.

Rencanakan bentuk ekspor di awal. Permintaan multi waktu nyata dapat menyertakan nomor dari berbagai negara dan kembali dalam urutan input. Tugas file massal CarrierLookup menerima nomor dari satu negara yang dipilih. Pisahkan dataset campuran negara berdasarkan penetapan negara yang andal sebelum menyiapkan file; jangan memilih negara hanya dari beberapa digit pertama.

Gunakan fungsi BigQuery untuk pembersihan mekanis

Referensi fungsi string BigQuery mendokumentasikan REGEXP_REPLACE, REGEXP_CONTAINS, dan fungsi terkait. Gunakan fungsi tersebut untuk transformasi mekanis seperti menghapus spasi, tanda kurung, dan tanda hubung dari salinan nilai sumber. Ekspresi sederhana seperti REGEXP_REPLACE(raw_phone, r'[^0-9+]', '') dapat membuat kandidat inspeksi, tetapi juga dapat mempertahankan tanda plus internal yang tidak terduga. Ikuti dengan uji format dan jalur karantina alih-alih mengirim setiap output ke API.

Untuk data yang sudah disimpan dengan tanda plus dan kode negara yang tepercaya, ekspresi kandidat dapat menghapus pemisah sambil tetap mempertahankan tanda plus tersebut. Untuk nomor lokal, gunakan aturan normalisasi khusus negara yang ditinjau terhadap panduan penomoran saat ini. Aturan "tambahkan kode negara CRM" yang umum berisiko jika nilai aslinya sudah menyertakan kode negara atau awalan trunk. Dokumentasikan transformasi spesifik yang diterapkan pada setiap jenis sumber dan ambil sampel output sebelum ekspor.

Tabel pementasan yang praktis berisi raw_phone, country_source, normalized_e164, normalization_rule, dan review_status. Bangun input pencarian hanya dari baris yang ditandai siap. Ini mencegah format yang ditolak disalahartikan sebagai hasil tanpa operator dan membuat koreksi dapat dibalik.

Siapkan jalur multi waktu nyata

Untuk set siap pakai yang kecil, ekspor string E.164 seperti + diikuti oleh digit berkode negara ke alur kerja multi REST. Endpoint POST /api/v1/batch-check menerima 1–100 nomor dan mengembalikan hasil sinkron yang berurutan. Simpan pemetaan posisi dari elemen permintaan ke kunci baris sumber sebelum mengirim panggilan. Jangan hanya mengandalkan nilai telepon yang identik jika CRM berisi duplikat.

Baca identifier dan status exists dari setiap item yang dikembalikan. exists=false berarti item tersebut tidak memiliki hasil normal; ini bukan pernyataan bahwa nomor tersebut terputus. Hasil yang berhasil mungkin berisi operator, operator dasar, jenis nomor, kode negara, wilayah, dan kota, dengan kolom opsional yang kosong. Simpan waktu pemeriksaan dan asosiasi input setiap hasil di tabel pementasan.

Pemeriksaan tunggal menggunakan bentuk E.164 yang sama saat operator perlu memeriksa satu catatan. Lakukan autentikasi dari server tepercaya menggunakan header X-API-Key yang didokumentasikan. Alur kerja ini memberi tim data cara untuk menguji normalisasi pada sampel sebelum mengirim daftar siap pakai yang jauh lebih besar.

Siapkan tugas file satu negara

Untuk daftar besar, buat TXT atau CSV satu kolom dengan satu nomor berkode negara per baris dan pilih negara ISO yang sesuai untuk tugas massal. Input yang didokumentasikan harus milik negara yang dipilih tersebut. Dalam pengiriman multipart, kolom negara harus mendahului file. Persiapan massal menghapus baris yang tidak valid, duplikat, baris tanpa kode negara, dan nomor di luar negara yang dipilih. Periksa jumlah persiapan sebelum memperlakukan ekspor sumber sebagai diproses sepenuhnya.

Tugas massal bersifat asinkron: kirim dengan POST /api/v1/bulk-tasks, simpan ID tugas, dan kueri GET /api/v1/bulk-tasks/{id} tidak lebih sering dari setiap 30 detik. Tugas yang berhasil menyediakan satu CSV. Tugas tersebut melaporkan pengidentifikasi sebagai digit berkode negara biasa tanpa tanda plus. Itu berbeda dari bentuk permintaan waktu nyata, jadi jangan gabungkan hasil ke kolom telepon mentah dengan kesetaraan string langsung.

Bangun kunci gabungan khusus digit yang dinormalisasi dari setiap kandidat E.164 yang diterima, dan simpan kunci baris sumber secara terpisah. Jika input berisi nomor duplikat, persiapan massal dapat menggabungkannya; putuskan apakah satu hasil harus dikaitkan dengan beberapa catatan sumber. Rekonsiliasi baris sumber yang tidak cocok, tidak valid, dan duplikat di luar CSV hasil.

Tinjau data yang digabungkan sebelum pembaruan CRM

Operator yang dihasilkan menjelaskan alokasi asli, bukan operator yang melayani saat ini setelah porting. Wilayah dan kota adalah geografi alokasi, bukan lokasi langsung. Masukkan deskripsi ini ke dalam kamus data agar analis tidak salah mengartikan nama kolom sebagai bukti di mana seseorang berada sekarang. Hasil waktu nyata yang selesai dengan code=0 dapat memiliki kolom operator opsional yang kosong; simpan yang kosong sebagai tidak tersedia alih-alih membuat label negatif.

Ambil sampel baris yang digabungkan dari beberapa sistem sumber dan negara. Periksa apakah nomor mentah, bentuk E.164 yang dinormalisasi, kunci digit biasa, dan pengidentifikasi hasil merujuk pada input yang sama. Selidiki ketidakcocokan di tabel pementasan sebelum menulis nilai ke CRM. Simpan stempel waktu pencarian, karena konteks alokasi dapat ditinjau kembali nanti dan catatan sumber itu sendiri dapat berubah.

Alur kerja ini memisahkan tiga pekerjaan: BigQuery membersihkan representasi yang diketahui, Pencarian Operator Asli menyediakan kolom alokasi yang didokumentasikan, dan tim CRM memutuskan apakah dan bagaimana memperbarui kontak. Pembagian itu membuat kesalahan terlihat dan menjaga hasil operator tetap dalam makna yang tepat.

FAQ

Bagaimana tim dapat menghapus pemisah telepon di BigQuery?

Gunakan salinan kerja dan fungsi string yang didokumentasikan seperti REGEXP_REPLACE, lalu validasi kandidat terhadap bentuk E.164 yang diharapkan.

Bagaimana tim dapat menetapkan kode negara ke nomor lokal?

Gunakan kolom negara yang andal dan aturan khusus negara yang telah ditinjau. Karantina baris yang negara atau bentuk panggilannya ambigu.

Bagaimana tim dapat menggabungkan CSV massal ke input E.164?

Buat kunci khusus digit yang stabil dari kandidat E.164 yang diterima dan rekonsiliasi dengan pengidentifikasi CSV massal, sambil tetap mempertahankan ID baris sumber.

Bagaimana tim dapat menangani daftar campuran negara?

Gunakan permintaan multi waktu nyata untuk set campuran negara yang kecil atau pisahkan file besar berdasarkan penetapan negara tepercaya sebelum pengiriman massal.

Pelajari Lebih Lanjut

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

• Lihat dokumentasi produk →
• Hubungi tim →