· 5 min read
Hal yang Perlu Diperiksa Saat Library Telepon Menolak Rentang Nomor Baru
Telusuri konteks negara, metadata yang terpasang, dan bukti penomoran resmi sebelum membuang nomor telepon pelanggan yang bermasalah.
Perlakukan penolakan yang dicurigai akibat rentang baru sebagai sebuah proses investigasi. Reproduksi hasilnya dengan input dan konteks negara yang persis sama, bandingkan library yang diterapkan dengan metadata saat ini, dan temukan bukti otoritatif mengenai rentang tersebut sebelum menentukan tindakan terhadap data yang ada.
Dokumentasikan penolakan sebelum mengubah nomor
Pelanggan menyatakan bahwa nomor mereka sudah benar, tetapi proses impor Anda menolaknya. Menghapus angka di awal secara berulang kali hingga validator menerima nilainya adalah langkah perbaikan yang berisiko: nilai baru tersebut bisa jadi merujuk ke nomor yang sama sekali berbeda. Mulailah dengan mempertahankan input asli dan nilai persis yang dikirimkan ke library.
Catat negara default yang diberikan untuk proses penguraian (parsing), kode negara yang dihasilkan jika parsing berhasil, serta operasi validasi yang mengalami kegagalan. Bedakan antara eror parsing, kegagalan akibat panjang nomor yang tidak memungkinkan, dan kegagalan validitas rentang nomor. Nomor yang tidak memiliki konteks negara belum tentu menjadi bukti adanya rentang penomoran baru.
Reproduksi kasus tersebut di luar logika formulir aplikasi dengan menggunakan paket dan metadata yang sama dengan yang diterapkan di lingkungan produksi. Langkah ini memperjelas apakah penolakan berasal dari library atau dari aturan aplikasi tambahan. Masking pada front-end, regular expression yang tersimpan dalam cache, atau pembatasan negara di sisi server dapat menolak input meskipun library telepon sebenarnya menerimanya.
Periksa versi yang benar-benar sedang berjalan
Ketahui versi dependensi yang terpasang secara pasti pada aplikasi yang diterapkan, bukan hanya membaca rentang versi pada manifes paket. Jika aplikasi membundel metadata telepon secara terpisah, catat pula aset tersebut. Mesin pengembangan dapat menghasilkan respons yang berbeda dari bundel produksi yang masih memuat build lama.
Ulangi pengujian dengan input dan konteks negara yang sama terhadap versi terkini yang dikelola dalam pengujian terisolasi. Bandingkan kedua hasil tersebut secara berdampingan. Jika versi yang lebih baru menerima rentang tersebut, periksa rilis atau perubahan metadata terkait sebelum merencanakan pembaruan. Ujilah juga sampel nomor yang ada melalui pembaruan tersebut, khususnya untuk negara-negara yang menjadi basis utama pelanggan Anda.
Jika kedua versi menolak nomor tersebut, pembaruan versi saja belum menyelesaikan masalah. Lanjutkan dengan menelusuri bukti penomoran resmi. Jangan menonaktifkan pemeriksaan validitas secara global hanya karena satu pelanggan melaporkan nomor yang valid; perubahan seperti itu akan berdampak pada setiap input berikutnya, termasuk nomor yang benar-benar tidak valid.
Cari bukti yang merujuk pada rentang yang tepat
FAQ libphonenumber milik Google menjelaskan bahwa rentang yang valid adalah rentang yang didukung oleh dokumentasi resmi yang memadai yang menunjukkan bahwa nomor tersebut dapat dialokasikan. Dijelaskan pula bahwa pembaruan metadata dapat tertinggal dari peluncuran rentang baru. Hal ini menjadi alasan untuk menginvestigasi suatu penolakan, bukan alasan untuk berasumsi bahwa setiap awalan asing otomatis valid.
Carilah rencana penomoran dari otoritas telekomunikasi nasional terkait atau pemberitahuan alokasi resmi. Cocokkan kode panggilan negara, panjang nomor nasional, dan batas awalan. Periksa tanggal berlakunya: pengumuman mengenai rentang di masa mendatang belum tentu membuktikan bahwa rentang tersebut sudah siap untuk dialokasikan.
Pemberitahuan resmi dari operator dapat memberikan konteks tambahan apabila rencana nasional belum lengkap. Simpan URL asli, tanggal dokumen, dan kutipan yang mendukung rentang tersebut dalam catatan investigasi Anda. Laporan forum atau situs web lain yang menerima input tersebut dapat memberi petunjuk awal, tetapi tidak menggantikan bukti resmi. Salinan arsip FAQ penomoran menjelaskan masalah secara umum, namun tidak dapat mengonfirmasi alokasi yang berlaku saat ini.
Tentukan respons terarah berdasarkan bukti yang ada
Jika metadata terbaru menerima nomor tersebut sementara metadata lama yang diterapkan menolaknya, uji dan rilis pembaruan yang didukung melalui alur deployment reguler Anda. Simpan nomor yang dilaporkan sebagai kasus uji regresi agar penolakan serupa tidak kembali muncul saat terjadi perubahan bundel di masa mendatang.
Jika alokasi resmi yang sudah berlaku belum tercantum dalam metadata terkini, siapkan laporan upstream yang ringkas berisi input yang dapat direproduksi, konteks negara, serta sumber otoritatif. Hapus rincian identitas pelanggan dari laporan tersebut. Hindari memublikasikan data kontak lengkap pelanggan jika kasus pengujian atau deskripsi rentang sudah memadai untuk menjelaskan masalahnya.
Untuk alur kerja internal Anda, simpan data yang terdampak dalam antrean rentang yang disengketakan alih-alih menghapusnya atau langsung menyatakannya valid secara diam-diam. Setiap pengecualian sementara harus dibatasi secara ketat pada rentang yang terbukti serta keputusan bisnis spesifik. Sebagai contoh, mengizinkan pengguna menyimpan data kontak tidak harus serta-merta memberi izin untuk menjalankan setiap tindakan yang bergantung pada nomor telepon. Dokumentasikan kapan pengecualian tersebut perlu ditinjau ulang setelah metadata diperbarui.
Tambahkan pemeriksaan terpisah hanya untuk menjawab kebutuhan spesifik
Investigasi rencana penomoran dan hasil pemeriksaan massal adalah dua observasi yang berbeda. Validasi Nomor Telepon dari CheckNumber menyediakan sinyal validitas terdokumentasi untuk daftar yang didukung. Produk katalog lainnya menjawab pertanyaan yang berbeda, seperti status registrasi pada platform tertentu. Pilihlah produk sesuai dengan keputusan yang perlu diambil oleh tim Anda.
Siapkan data yang telah disetujui dalam format CSV atau TXT dengan satu negara per berkas dan satu nomor per baris termasuk kode negara. Pastikan cakupan negara saat ini untuk produk yang dipilih. Simpan input asli yang belum terselesaikan dalam lembar peninjauan Anda sendiri, sehingga hasil ekspor di kemudian hari dapat direkonsiliasi dengan catatan investigasi alih-alih menimpanya.
Observasi pemeriksaan yang positif tidak membuktikan kepemilikan atau memperbaiki catatan alokasi resmi yang belum terdaftar. Demikian pula, penolakan oleh library tidak boleh mengabaikan observasi terpisah tanpa peninjauan. Simpan sumber dan waktu dari setiap kesimpulan, lalu tentukan apakah data pelanggan dapat diproses lebih lanjut, perlu diperbaiki, atau tetap ditahan.
Mulailah dari penolakan yang dapat direproduksi dan versi yang terpasang. Setelah persoalan rentang nomor dipahami, gunakan pemeriksa nomor telepon kami untuk tugas pemeriksaan daftar nomor yang didukung berikutnya. Langkah ini mempertahankan pemisahan yang jelas antara perbaikan aturan validasi Anda dan pemahaman terhadap daftar kontak.