Format Nomor Telepon E.164: Cara Konversi dan Validasi

Mengapa API SMS dan WhatsApp memerlukan E.164?

Karena perutean bergantung pada nomor yang tidak ambigu. Nomor tanpa kode negara bisa milik banyak negara, sehingga platform dapat mengirim ke pasar yang salah, menerapkan aturan sender ID yang salah, dan menagih tarif yang salah. Tarif, registrasi sender ID, dan jam kirim promosi semuanya diterapkan per negara tujuan, dan kode negara adalah cara mengidentifikasi tujuan itu.

Apa kata Meta tentang nomor WhatsApp?

Dokumentasi Meta tentang format nomor telepon pengguna WhatsApp menyatakan bahwa tanda plus, tanda hubung, tanda kurung, dan spasi didukung dalam permintaan kirim pesan, dan sangat menyarankan menyertakan tanda plus serta kode panggilan negara. Jika tanda plus tidak ada, kode panggilan negara pengirim ditambahkan ke nomor, yang dapat menyebabkan pesan terkirim ke nomor yang salah. Contoh Meta: untuk pengirim di India (kode 91), (631) 555-1234 terkirim ke +916315551234, sedangkan +1 (631) 555-1234 terkirim dengan benar. Meta juga mencatat bahwa untuk Brasil dan Meksiko, Cloud API dapat mengubah awalan tambahan yang muncul pada sebagian nomor, dan menyebut ini perilaku standar.

Pendekatan yang aman: simpan E.164 yang bersih dan kirim persis itu.

Bagaimana dengan SMS?

API SMS juga mengharapkan nomor internasional lengkap. Sebagian meminta digit tanpa tanda plus; formatnya berbeda antar API dan protokol, jadi periksa dokumentasi API yang Anda gunakan dan uji dengan nomor Anda sendiri. Lihat kirim SMS lewat API dan kirim pesan WhatsApp lewat API untuk contoh yang berfungsi.

Bagaimana cara memvalidasi dan menormalisasi nomor di kode?

Gunakan regex untuk pemeriksaan bentuk yang cepat dan pustaka untuk validasi yang sesungguhnya.

Pemeriksaan bentuk E.164 yang umum:

// Plus, a non-zero first digit, then 1 to 14 more digits: 15 digits at most
const E164 = /^\+[1-9]\d{1,14}$/;

function looksLikeE164(value) {
  return E164.test(value);
}

looksLikeE164("+971501234567"); // true
looksLikeE164("0501234567");    // false: no plus or country code
looksLikeE164("+0501234567");   // false: country codes do not start with 0

Regex hanya memeriksa panjang dan karakter. Regex ini menerima +99999999999 padahal nomor seperti itu tidak ada. Untuk validasi yang sesungguhnya, gunakan libphonenumber, pustaka sumber terbuka milik Google untuk mengurai, memformat, dan memvalidasi nomor telepon internasional, tersedia untuk Java, C++, dan JavaScript, dengan port komunitas di bahasa lain. README-nya menjelaskan isValidNumber sebagai validasi penuh untuk suatu wilayah dengan memakai informasi panjang dan awalan, serta menunjukkan cara memformat nomor yang sudah diurai sebagai E.164.

# pip install phonenumbers  (a Python port of libphonenumber)
import phonenumbers

def to_e164(raw, default_region):
    try:
        number = phonenumbers.parse(raw, default_region)  # e.g. "AE", "SA", "GB"
    except phonenumbers.NumberParseException:
        return None
    if not phonenumbers.is_valid_number(number):
        return None
    return phonenumbers.format_number(number, phonenumbers.PhoneNumberFormat.E164)

print(to_e164("050 123 4567", "AE"))   # +971501234567 if the number is valid for the UAE
print(to_e164("+44 7700 900123", "GB"))

Port ditulis oleh pengembang luar, jadi nilai kualitas port yang Anda pilih. Urai dengan wilayah default yang diambil dari negara pelanggan Anda, lalu simpan hasil E.164-nya. Simpan juga masukan mentahnya, agar Anda dapat mengurai ulang jika aturan berubah.

Normalisasikan di titik masuk, yaitu di formulir pendaftaran, impor CRM, atau API, bukan saat pengiriman. Nomor yang ditulis dua cara menjadi dua kontak yang masing-masing menerima kampanye yang sama.

Bagaimana cara memperbaiki nomor telepon di spreadsheet?

Format kolom telepon sebagai Teks sebelum Anda memasukkan atau menempelkan nomor. Masalah yang umum adalah:

Microsoft mendokumentasikan bahwa Excel menghapus nol di depan dan mengubah angka besar menjadi notasi ilmiah, dan bahwa nomor yang dimasukkan sebelum format Teks diterapkan harus dimasukkan ulang. Saat Anda membuka file CSV secara langsung, Excel menerapkan format default pada setiap kolom, jadi gunakan Text Import Wizard atau From Text/CSV untuk menandai kolom telepon sebagai teks.

Untuk daftar seluler UEA yang tersimpan sebagai 050 123 4567 di kolom A, rumus ini membentuk E.164 sebagai teks:

="+971"&RIGHT(SUBSTITUTE(A2," ",""),9)

Rumus ini mengambil sembilan digit terakhir setelah spasi dihapus, jadi hanya cocok untuk nomor dengan bentuk seperti itu. Salin hasilnya dan tempel sebagai nilai sebelum menyimpan ke CSV. Pemformat nomor telepon mengonversi nomor tanpa rumus, dan panduan kami tentang mengirim SMS massal dari Excel atau CSV menunjukkan alur unggah yang lengkap.

Contoh kasus: membersihkan daftar pelanggan

"Souq Rafiq" (fiktif), peritel di Dubai, mengekspor 8.000 kontak dari tiga sistem dengan nomor seperti 0501234567, 971 50 123 4567, +971-50-123-4567, dan 00971501234567.

1. Analis menambahkan kolom negara dari negara penagihan tiap pelanggan.
2. Sebuah skrip mengurai setiap baris dengan negara sebagai wilayah default, sehingga keempat format menjadi +971501234567.
3. Baris yang gagal validasi masuk ke lembar tinjauan, bukan dikirim.
4. Duplikat dihapus setelah normalisasi, yang menyatukan keempat format menjadi satu kontak.
5. Pencarian HLR menandai nomor tidak aktif sebelum kampanye. Lihat HLR lookup dijelaskan.
6. Kolom yang sudah bersih disimpan sebagai Teks lalu diunggah.

Normalisasi lebih dulu adalah yang membuat pemeriksaan duplikat berfungsi; sebelumnya, pelanggan yang sama tampak seperti empat orang.

Apa saja kesalahan yang umum terjadi?

• Selalu membuang nol di depan. Sebagian negara, seperti Italia, tidak memiliki awalan trunk.
• Mempertahankan nol dan menambahkan kode negara, menghasilkan +9710501234567.
• Mengirim tanpa tanda plus ke WhatsApp, sehingga kode negara pengirim ditambahkan.
• Memakai regex sebagai validasi. Regex memeriksa bentuk, bukan validitas.
• Membiarkan Excel memperlakukan nomor telepon sebagai angka, sehingga nol hilang atau berubah menjadi notasi ilmiah.
• Menormalisasi saat pengiriman alih-alih saat data masuk.
• Mengira format yang valid berarti nomor dapat dihubungi. Nomor yang dipindahkan operator atau diputus tetap gagal.
• Memercayai tabel statis. Rencana penomoran berubah; gunakan pustaka yang dipelihara.

Bagaimana OmniChannels.ai membantu

OmniChannels.ai menerima nomor internasional untuk SMS dan WhatsApp melalui satu REST API, dan kampanye-nya menerima unggahan Excel dan CSV dengan pratinjau dan penyaringan duplikat. BroadNet menyediakan HLR dan pencarian nomor, sehingga Anda dapat memeriksa apakah nomor yang berformat benar itu aktif. Baca dokumentasi API SMS dan dokumentasi API WhatsApp untuk kolom permintaan yang tepat, atau hubungi tim kami mengenai onboarding.