Memperbaiki Kesalahan 'Nomor Telepon Harus dalam Format E.164'

Perbaiki kode negara, tanda plus, dan awalan nasional yang hilang sebelum mengirimkan nomor untuk Pemeriksaan Pendaftaran Telegram.

Kesalahan 'nomor telepon harus dalam format E.164' berarti nilai yang dikirimkan memerlukan nomor telepon dalam format internasional sebelum Pemeriksaan Pendaftaran Telegram dapat menggunakannya. Mulailah dengan kode negara dan nomor nasional yang benar, tambahkan tanda plus di depan, serta hapus tanda baca tampilan dan awalan panggilan nasional apa pun yang tidak termasuk dalam bentuk internasional. Validasi nilai yang telah diubah terhadap catatan sumber sebelum mengirimkannya kembali; nomor yang rapi secara sintaksis tetapi salah tetap merupakan input yang keliru.

Apa yang diperiksa oleh persyaratan E.164

E.164 adalah rencana penomoran internasional yang diterbitkan oleh International Telecommunication Union. Dalam input aplikasi sehari-hari, penyajian yang lazim dimulai dengan tanda plus, diikuti oleh kode negara dan nomor nasional yang signifikan. Tanda plus mewakili konteks panggilan internasional; spasi, tanda kurung, dan tanda hubung mungkin membantu seseorang membaca nomor telepon, tetapi karakter tersebut bukan bagian dari nilai ringkas yang diharapkan oleh API pemeriksaan.

Kesalahan format terjadi sebelum jawaban pendaftaran yang bermakna. Kesalahan ini tidak boleh dicatat sebagai “Tidak terdaftar di Telegram.” Pemeriksaan Pendaftaran Telegram secara realtime untuk satu nomor dari TG Validator memerlukan nomor telepon yang dikirimkan dalam bentuk E.164. Setelah input diterima, hasil yang diputuskan berkaitan dengan keberadaan akun Telegram untuk nomor yang dikirimkan tersebut pada saat pemeriksaan. Pemeriksaan format itu sendiri tidak memberikan informasi mengenai keberadaan akun, identitas, kepemilikan, atau izin kontak.

Gunakan nilai sumber asli dan negara yang diketahui secara bersamaan. Jangan menebak kode negara dari digit pertama nomor yang tidak lengkap atau dari negara di alamat surat kontak. Nomor nasional hanya dapat bermakna dengan konteks penomorannya. Jika negara tidak diketahui, simpan catatan tersebut untuk peninjauan data alih-alih membuat nomor internasional yang tampak masuk akal secara diam-diam.

Mendiagnosis kesalahan input yang paling umum

Mulailah dengan memeriksa string persis yang dikirim ke pemeriksaan, bukan hanya cara spreadsheet menampilkannya. Tanda plus yang hilang sering terjadi ketika sebuah kolom disimpan sebagai angka. Begitu pula dengan spasi, tanda kurung, dan tanda hubung yang disalin dari kartu kontak yang dapat dibaca manusia. Beberapa sumber mempertahankan awalan trunk nasional yang harus dihilangkan setelah kode negara ditambahkan. Sumber lain sudah menyertakan kode negara, sehingga menambahkannya lagi akan membuat duplikat.

Twilio E.164 error guide mengilustrasikan persyaratan sisi layanan yang umum untuk bentuk ringkas yang sama. Panduan tersebut tidak menentukan hasil pendaftaran TG Validator. Untuk transformasi khusus negara, konsultasikan panduan penomoran resmi; aturan umum “hapus setiap angka nol” tidak aman karena angka nol mungkin termasuk di dalam nomor nasional yang signifikan.

Melakukan normalisasi dalam urutan yang terkontrol

Pertama, simpan nilai mentah di kolom terpisah. Kedua, tetapkan negara atau wilayah penomoran tepercaya dari catatan sumber. Ketiga, hapus hanya karakter tampilan seperti spasi, tanda hubung, dan tanda kurung; jangan membuang digit hanya karena terlihat tidak biasa. Keempat, tentukan apakah nilai tersebut sudah memiliki tanda plus dan kode negara. Kelima, jika dalam format nasional, terapkan aturan nasional-ke-internasional yang relevan, termasuk apakah awalan trunk harus dihapus. Terakhir, periksa apakah output dimulai dengan satu tanda plus, berisi digit yang dimaksud, dan tidak memiliki ekstensi yang tertanam dalam nilai yang dikirimkan.

Sebagai contoh, nomor format nasional Inggris mungkin memiliki angka 0 di depan yang digunakan dalam panggilan domestik. Dalam representasi internasional, kode negara Inggris adalah +44 dan angka 0 trunk domestik tersebut biasanya dihilangkan. Transformasi harus didasarkan pada nomor Inggris yang terverifikasi; ini bukan aturan universal untuk semua negara. Definisi ITU tentang awalan trunk nasional menjelaskan mengapa string panggilan nasional dan nomor internasional bisa berbeda. Simpan nilai sumber dan nilai yang telah diubah secara berdampingan agar peninjau dapat mendeteksi kehilangan digit yang tidak disengaja.

Jangan gunakan kecocokan Regex saja sebagai gerbang kualitas akhir. Regex dapat menangkap tanda baca yang jelas atau tanda plus yang hilang, tetapi tidak dapat menentukan apakah negaranya benar atau apakah aturan penomoran lokal diterapkan dengan benar. Pengurai yang sadar negara dapat membantu, namun data sumber tim tetap perlu ditinjau jika informasi negara atau kepemilikan tidak pasti.

Memeriksa apa yang sebenarnya disimpan oleh spreadsheet atau CRM

Excel dan alat serupa dapat mengubah nilai yang menyerupai nomor telepon secara diam-diam ketika kolom diperlakukan sebagai numerik. Microsoft merekomendasikan pemformatan sel sebagai teks sebelum entri, karena nomor telepon adalah pengidentifikasi, bukan kuantitas untuk aritmatika. Format kustom yang terlihat benar mungkin hanya mengubah tampilan dan meninggalkan nilai dasar yang berbeda. Jika digit awal hilang sebelum sel menjadi teks, mengubah format setelahnya tidak akan memulihkannya.

Sebelum mengirim batch, ekspor sampel kecil dan periksa TXT atau CSV mentah di penampil teks biasa. Konfirmasi baris pertama dan terakhir, beberapa entri dengan awalan nasional, dan beberapa entri internasional. Hitung digit dalam nilai sumber dan nilai yang diubah untuk sampel tersebut. Jika baris berisi ekstensi, simpan di kolom CRM terpisah; itu bukan nomor telepon yang dikirimkan untuk Pemeriksaan Pendaftaran Telegram.

Jika sumbernya adalah formulir, kumpulkan negara dan nomor telepon di kolom yang berbeda dan tervalidasi jika memungkinkan. Jika itu adalah daftar lama, tandai baris yang tidak pasti untuk ditinjau alih-alih menerapkan konversi luas yang dapat mengubah ribuan nomor secara tidak benar. Hal ini sangat penting ketika daftar berisi beberapa negara.

Mengirimkan kembali alur kerja yang benar setelah memperbaiki input

Untuk satu catatan, gunakan dasbor Pemeriksaan Tunggal TG Validator atau pemeriksaan pendaftaran REST realtime setelah normalisasi. Pemeriksaan tunggal REST adalah jalur POST /api/v1/check yang didokumentasikan. Pemeriksaan yang diputuskan mengembalikan hasil pendaftaran dalam sesi permintaan yang sama. Pemeriksaan yang belum diputuskan adalah hasil terpisah dengan kode bisnis bukan nol; hasil ini tidak boleh diklasifikasikan ulang sebagai kesalahan format atau sebagai hasil pendaftaran negatif.

Untuk kumpulan kecil, rute batch realtime dapat memeriksa hingga 100 nomor melalui API, dan Pemeriksaan Batch Realtime dasbor dapat menerima hingga 500 nomor yang ditempel. Daftar siap pakai yang jauh lebih besar mengikuti alur kerja bulk-file asinkron yang terpisah, dengan input TXT atau CSV, pemantauan tugas, dan pengunduhan hasil. Tinjau TG Validator API documentation saat ini sebelum memilih rute atau menyandikan detail permintaan. Alur kerja ini berbeda, tetapi masing-masing mendapatkan manfaat dari proses normalisasi yang menjaga sumber yang sama.

Setelah koreksi, catat catatan mana yang diubah dan mengapa. Jika pemeriksaan sebelumnya menggunakan nomor yang salah, jangan edit hasil historis tersebut seolah-olah merujuk pada nomor yang dikoreksi. Jalankan pemeriksaan baru untuk nilai yang dikoreksi dan pertahankan jejak audit yang jelas. Tujuannya adalah hasil mengenai nomor yang dimaksud, bukan sekadar hilangnya kesalahan input.

FAQ

Bagaimana tim dapat memperbaiki tanda plus yang hilang dalam kesalahan E.164?

Konfirmasi nomor sumber dan negara, lalu buat nilai internasional dengan satu tanda plus di depan dan kode negara yang benar. Jangan menambahkan kode tebakan ke catatan yang tidak pasti.

Haruskah tim menghapus setiap angka nol di depan dari nomor telepon?

Tidak. Terapkan aturan penomoran dari negara tertentu. Awalan trunk nasional dapat dihilangkan secara internasional, tetapi angka nol lainnya bisa menjadi digit yang bermakna.

Apa yang harus dilakukan terhadap catatan yang masih gagal setelah normalisasi?

Simpan nilai mentah dan nilai yang telah diubah, periksa data negara dan sumber, lalu arahkan catatan tersebut untuk ditinjau. Kegagalan format bukanlah hasil pendaftaran Telegram.

Pelajari Lebih Lanjut

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

• Lihat dokumentasi produk →
• Hubungi tim →