Format E.164 untuk Pemeriksaan API WhatsApp: Mengapa Format Lokal Menyebabkan Kesalahan Pencarian

Menjelaskan format E.164, menunjukkan kesalahan format lokal yang menghasilkan hasil pemeriksaan WhatsApp yang salah, serta menyusun rutinitas normalisasi untuk alur kerja API dan file.

E.164 adalah format penomoran internasional ITU: kode negara diikuti oleh nomor nasional, maksimal 15 digit, ditulis dalam bentuk kanonik dengan tanda plus di depan tanpa spasi, tanda hubung, atau awalan trunk. Pemeriksaan API WhatsApp mengharapkan nomor dalam bentuk internasional ini karena format lokal seperti 07700 900123 tidak menunjukkan negara asalnya. Menormalisasi setiap nomor ke E.164 sebelum pemeriksaan memastikan hasil tetap terikat pada nomor yang Anda maksud.

Apa itu format E.164

ITU-T Recommendation E.164 mendefinisikan rencana penomoran telekomunikasi publik internasional. Untuk pekerjaan data praktis, nomor E.164 memiliki tiga properti:

• Dimulai dengan kode panggilan negara yang terdiri dari satu hingga tiga digit, seperti 1, 44, 55, atau 971.
• Dilanjutkan dengan nomor signifikan nasional, tanpa awalan trunk domestik (seringkali berupa angka 0 di depan).
• Panjang total tidak lebih dari 15 digit, dan bentuk penulisan kanoniknya adalah tanda plus diikuti hanya oleh angka, contohnya +447700900123.

Hal yang tidak disertakan dalam E.164 sama pentingnya dengan apa yang disertakan: tidak ada awalan panggilan internasional seperti 00 atau 011, tidak ada tanda kurung, tidak ada spasi, dan tidak ada ekstensi.

Bagaimana format lokal merusak pemeriksaan API WhatsApp

Sebagian besar halaman yang membahas topik ini hanya berhenti pada definisi. Masalah praktisnya adalah bagaimana data CRM biasa berubah menjadi pencarian yang salah. Berikut adalah pola yang menyebabkannya:

Panduan WhatsApp user phone number format guidance dari Meta menunjukkan risiko tersebut dengan jelas pada sisi pengiriman: tanpa tanda plus dan kode negara, kode negara bisnis itu sendiri dapat ditambahkan di depan, sehingga "(631) 555-1234" yang dikirim dari nomor bisnis India dapat terdeteksi sebagai +916315551234 alih-alih nomor AS yang dimaksud. Ambiguitas yang sama berlaku untuk setiap pemeriksaan. Jika pemeriksaan berjalan terhadap nomor yang salah, hasilnya akan mendeskripsikan orang lain.

Rutinitas normalisasi sebelum memeriksa nomor

Jalankan langkah-langkah ini sebelum melakukan pemeriksaan WhatsApp apa pun, baik nomor tersebut melalui API maupun ke dalam file.

1. Simpan nomor sebagai teks. Sel angka pada spreadsheet akan menghapus tanda plus dan angka nol di depan, serta nilai yang panjang dapat berubah menjadi notasi ilmiah.
2. Simpan negara bersama data. Normalisasi memerlukan wilayah default untuk nomor yang dimasukkan dalam format lokal; ambil dari kolom negara kontak, bukan dari lokasi tim penjualan.
3. Urai dengan pustaka yang terawat. libphonenumber dari Google mengurai string mentah ditambah wilayah menjadi kode negara dan nomor nasional, lalu memformatnya ke E.164. Fungsi isPossibleNumber miliknya adalah pemeriksaan panjang saja, sementara isValidNumber juga menggunakan informasi awalan untuk wilayah tersebut.
4. Karantina kegagalan. Nilai yang tidak dapat diurai atau gagal validasi dikirim ke antrean peninjauan, bukan ke pemeriksa.
5. Hapus duplikat setelah normalisasi. "07700 900123" dan "+44 7700 900123" hanya menjadi nomor yang sama setelah langkah ini.

Langkah-langkah ini menjawab pertanyaan sempit: apakah string tersebut merupakan nomor internasional yang masuk akal untuk wilayahnya? Apakah nomor tersebut memiliki akun WhatsApp adalah pertanyaan terpisah yang hanya dijawab oleh Pemeriksaan Pendaftaran WhatsApp.

Menggunakan E.164 dengan API dan file WA Lookup

API realtime WA Lookup menerima satu nomor telepon yang dikirimkan dalam format E.164 untuk POST /api/v1/check, bersama dengan header X-API-Key dan service_type yang memilih Pemeriksaan Pendaftaran WhatsApp, Pemeriksaan Avatar WhatsApp, atau Pemeriksaan Akun WhatsApp Business. POST /api/v1/batch-check menerima hingga 100 nomor per permintaan, dan normalisasi yang sama berlaku untuk setiap nomor di dalamnya. Ikuti dokumentasi API saat ini untuk isi permintaan yang tepat.

Tugas file massal memiliki kebutuhan format tersendiri:

• Hanya TXT atau CSV, satu nomor dengan kode negara per baris.
• File tersebut pada dasarnya harus berisi satu negara yang dipilih. Ketika 10% atau lebih nomor berasal dari negara lain, pra-pemeriksaan akan menolak file tersebut, jadi pisahkan berdasarkan kode negara setelah normalisasi.
• Nomor Tiongkok Daratan (+86), Hong Kong (+852), dan Makau (+853) tidak diterima dalam file massal; pemeriksaan tunggal realtime terbatas mendukung wilayah tersebut.

Kesalahan E.164 umum yang perlu diperhatikan dalam peninjauan

• Mengasumsikan setiap nomor adalah domestik. Wilayah default adalah cadangan untuk input format lokal, bukan aturan untuk setiap baris.
• Menghapus tanda plus untuk penyimpanan. Simpan bentuk kanonik di CRM; konversi hanya jika sistem tertentu memerlukan representasi lain.
• Menyimpan ekstensi. Hapus teks ekstensi seperti "ext. 204" sebelum memeriksa; E.164 tidak memiliki tempat untuk itu.
• Menganggap normalisasi sebagai izin. Nomor yang diformat dengan benar dan terdaftar tetap memerlukan opt-in sebelum penjangkauan berdasarkan WhatsApp Business Messaging Policy.
• Mencampur format dalam satu kolom. Satu kolom yang dinormalisasi yang digunakan untuk memeriksa dan mengirim akan menghindari hasil yang melenceng dari data aslinya.

FAQ

Bagaimana tim dapat mengetahui apakah nomor yang tersimpan sudah dalam format E.164?

Nilai tersebut dimulai dengan tanda plus, hanya berisi angka setelahnya, tidak memiliki angka nol trunk setelah kode negara, dan memiliki 15 digit atau kurang. Mengurainya dengan pustaka seperti libphonenumber dan memformatnya kembali ke E.164 seharusnya menghasilkan string yang sama.

Apakah tanda plus di depan penting untuk pemeriksaan dan pesan WhatsApp?

Tanda tersebut menandai nomor sebagai internasional. Panduan Meta merekomendasikan untuk menyertakan tanda plus dan kode negara karena nomor tanpa tanda tersebut dapat diinterpretasikan dengan kode negara pengirim. Untuk WA Lookup, ikuti dokumentasi API saat ini untuk string yang tepat yang diharapkan dalam permintaan.

Apa yang harus dilakukan terhadap nomor yang gagal dinormalisasi?

Kirim nomor tersebut ke antrean peninjauan dengan nilai asli dan negara data tersebut. Memeriksa string yang ambigu atau salah format akan menghabiskan saldo dan dapat mengaitkan hasil ke nomor yang berbeda.

Mengapa file massal memerlukan nomor dari satu negara?

Tugas massal dikirimkan untuk negara yang dipilih, dan pra-pemeriksaan menolak file di mana 10% atau lebih nomor berasal dari negara lain. Menormalisasi ke E.164 terlebih dahulu memudahkan untuk membagi ekspor campuran berdasarkan kode negara.

Pelajari Lebih Lanjut

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

• Lihat dokumentasi produk →
• Hubungi tim →