Cara Mengonversi Daftar Nomor Telepon ke E.164 Sebelum Pemeriksaan Telegram

Alur kerja tingkat lembar kerja untuk mengubah nomor telepon lokal menjadi E.164 agar dapat dibaca oleh Pemeriksaan Pendaftaran Telegram atau file massal satu negara.

Untuk mengonversi nomor telepon ke E.164, hapus spasi dan simbol, hilangkan awalan trunk nasional seperti angka nol di depan, lalu tulis tanda plus diikuti dengan kode negara dan digit yang tersisa. Hasilnya tidak memiliki spasi atau tanda baca dan menggunakan maksimal 15 digit. Melakukan hal ini di lembar kerja sebelum Pemeriksaan Pendaftaran Telegram menjaga nomor tetap dapat dibaca untuk pemeriksaan waktu nyata (realtime) dan untuk file massal satu negara.

Apa yang disyaratkan oleh E.164

E.164 adalah rencana penomoran telekomunikasi publik internasional yang diterbitkan oleh ITU, yang dijelaskan pada halaman rekomendasi ITU. Dalam pekerjaan data sehari-hari, ini berarti satu bentuk kanonik: tanda plus, kode negara, kemudian nomor pelanggan termasuk kode area, tanpa spasi, kurung, atau tanda hubung. Panjang totalnya maksimal 15 digit.

Dua kebiasaan menyebabkan sebagian besar kesalahan konversi. Pertama adalah memperlakukan nomor lokal seolah-olah nomor internasional. Nomor yang ditulis seperti cara orang menelepon di rumah sering kali dimulai dengan awalan trunk, yang bukan merupakan bagian dari bentuk internasional. Kedua adalah memperlakukan tanda plus sebagai hiasan. Di lembar kerja, tanda plus di depan sering kali diartikan sebagai operator rumus, sehingga sel tersebut secara otomatis menghilangkannya.

Pemeriksaan waktu nyata TG Validator memerlukan satu nomor telepon E.164. Dasbor dan file massal untuk nomor telepon mengharapkan kode negara telepon internasional, jadi kolom E.164 yang bersih adalah persiapan yang tepat untuk kedua jalur tersebut.

Langkah 1: Pertahankan kolom sebagai teks dan buat cadangan

Sebelum mengubah apa pun, salin kolom asli ke lembar atau tab baru. Konversi mudah untuk disalahartikan, dan data asli yang tidak tersentuh memungkinkan Anda melacak kembali nomor apa pun.

Kemudian atur format kolom kerja menjadi teks biasa. Di Excel atau Google Sheets, ini mencegah program menghapus angka nol di depan atau membaca tanda plus di depan sebagai aritmatika. Jika file tiba sebagai CSV, impor dengan kolom telepon yang secara eksplisit diketik sebagai teks, alih-alih membiarkan program menebaknya.

Langkah 2: Hapus semua yang bukan digit

Hapus spasi, tanda hubung, titik, kurung, dan teks apa pun seperti label ekstensi. Di Google Sheets, penggantian Regex pada kolom dapat melakukannya dalam satu langkah: ganti karakter non-digit dengan apa pun. Di Excel, panggilan SUBSTITUTE bersarang untuk setiap simbol mencapai hasil yang sama, atau langkah pembersihan teks Power Query dapat menangani seluruh kolom.

Catat nomor yang dimulai dengan tanda plus atau awalan internasional nol ganda sebelum dihapus. Nomor tersebut sudah membawa kode negara dan memerlukan penanganan berbeda pada langkah berikutnya. Kolom pembantu cepat yang mencatat apakah data asli dimulai dengan tanda plus atau nol ganda akan mempermudah hal ini.

Langkah 3: Hapus awalan trunk dan tambahkan kode negara

Ini adalah langkah yang memerlukan keputusan per negara, jadi kerjakan satu negara dalam satu waktu.

• Sudah internasional. Jika data asli dimulai dengan tanda plus atau awalan nol ganda, digit yang mengikutinya adalah kode negara dan nomor. Hapus awalan nol ganda dan letakkan tanda plus di depan.
• Lokal dengan awalan trunk. Banyak negara menulis nomor nasional dengan angka nol di depan yang dihilangkan dalam bentuk internasional. Hapus satu digit di depan tersebut, lalu tambahkan tanda plus dan kode negara.
• Lokal tanpa awalan trunk. Beberapa rencana nasional tidak memiliki awalan trunk, sehingga digit tetap seperti apa adanya dan hanya tanda plus serta kode negara yang ditambahkan.

Untuk lembar dengan kolom negara, tabel pencarian nama negara ke kode negara, ditambah kolom yang mencatat apakah negara tersebut menggunakan digit trunk di depan, akan menjalankan rumusnya. Hasilnya adalah satu kolom baru: tanda plus, kemudian kode, kemudian nomor dengan digit trunk dihapus jika berlaku.

Jangan menebak negara untuk nomor yang tidak mencantumkannya. Daftar singkat baris tanpa negara yang jelas lebih baik disisihkan daripada diberi nilai default yang mengirimkannya ke grup yang salah.

Langkah 4: Validasi panjang dan cari pencilan

Beberapa pemeriksaan cepat menangkap sebagian besar hal yang terlewatkan oleh rumus.

• Panjang. Setelah tanda plus, nomor tersebut harus maksimal 15 digit. Apa pun yang lebih panjang adalah kesalahan.
• Terlalu pendek. Hasil yang sangat pendek biasanya berarti kode area yang hilang atau ekstensi yang tertempel.
• Kode negara berulang. Nomor yang sudah berisi kodenya dan ditambahkan lagi akan dimulai dengan kode dua kali. Urutkan berdasarkan beberapa digit pertama untuk menemukannya.
• Negara campuran dalam file satu negara. Tugas telepon massal bekerja pada satu negara yang dipilih, jadi kelompokkan baris berdasarkan kode negara dan ekspor satu file per negara. Daftar tersebut harus pada dasarnya adalah negara yang dipilih, karena file dengan porsi besar kode negara lain akan ditolak.

Simpan tab penolakan dengan nilai asli, nilai yang dikonversi, dan alasan kegagalannya. Tab tersebut adalah daftar kerja untuk perbaikan manual.

Langkah 5: Ekspor untuk pemeriksaan waktu nyata atau untuk file massal

Tentukan rute berdasarkan ukuran daftar.

Untuk kumpulan kecil, jalankan Pemeriksaan Pendaftaran Telegram waktu nyata. Rute REST adalah POST /api/v1/check, diautentikasi dengan X-API-Key, dengan satu nomor E.164 dan tipe layanan tg, dan POST /api/v1/batch-check menerima hingga 100 nomor dalam satu permintaan. Tab Batch Check dasbor menerima hingga 500 nomor yang ditempel. Semua ini kembali dalam sesi yang sama.

Untuk daftar yang jauh lebih besar dari itu, ekspor TXT atau CSV dengan satu nomor per baris, unggah sebagai tugas massal untuk negara yang dipilih, tunggu tugas tersebut, dan unduh result.csv. Batas per layanan yang tepat ada dalam dokumentasi API saat ini dan halaman harga, jadi periksa sebelum menjalankan tugas besar.

Nomor untuk Tiongkok daratan, Hong Kong, dan Makau dapat diperiksa satu per satu dalam volume kecil pada pemeriksaan tunggal waktu nyata, tetapi file massal asinkron tidak mendukung wilayah tersebut, jadi jangan sertakan dalam ekspor massal.

Apa yang diberikan dan tidak diberikan oleh file E.164 yang bersih

Format yang bersih menghilangkan penyebab paling umum dari input yang tidak dapat dibaca, tetapi tidak mengubah arti pemeriksaan. Hasil pendaftaran adalah sinyal keberadaan akun khusus platform pada saat pemeriksaan. Ini tidak menunjukkan aktivitas, identitas, kepemilikan, persetujuan, atau kemungkinan balasan, jadi tetap gunakan aturan izin dan relevansi normal Anda setelah pemeriksaan.

Kebiasaan akhir yang berguna adalah menyimpan kolom yang dikonversi di sebelah data asli di lembar utama, dengan tanggal konversi, sehingga impor nanti dapat dicocokkan tanpa mengulangi pekerjaan tersebut.

FAQ

Bagaimana tim dapat mengonversi nomor telepon lokal ke E.164 di lembar kerja?

Tim dapat menghapus karakter non-digit, menghapus awalan trunk nasional, lalu menambahkan tanda plus dan kode negara. Mengerjakan satu negara dalam satu waktu dengan tabel pencarian membuat rumus tetap sederhana.

Berapa panjang maksimum nomor E.164?

Nomor E.164 memiliki maksimal 15 digit setelah tanda plus, tanpa spasi atau tanda baca. Hasil yang lebih panjang biasanya menunjukkan kode negara yang terduplikasi.

Bagaimana tim dapat menghentikan lembar kerja agar tidak menghapus tanda plus di depan?

Format kolom telepon sebagai teks biasa sebelum memasukkan atau mengimpor nilai, dan impor file CSV dengan kolom telepon yang diketik sebagai teks agar tanda plus dan angka nol di depan tetap terjaga.

Apakah file Telegram massal memerlukan satu negara?

Ya. Tugas telepon massal bekerja pada satu negara yang dipilih, jadi kelompokkan baris berdasarkan kode negara dan ekspor satu file per negara; file dengan porsi besar kode negara lain akan ditolak.

Pelajari Lebih Lanjut

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

• Lihat dokumentasi produk →
• Hubungi tim →