API WhatsApp Lookup: Penjelasan Pemeriksaan Pendaftaran Realtime

Pelajari bagaimana API WhatsApp lookup menangani pemeriksaan pendaftaran realtime sinkron, parsing respons, dan alur kerja volume tinggi untuk saluran komunikasi yang bersih.

API WA Lookup menyediakan verifikasi realtime sinkron untuk mengonfirmasi apakah suatu nomor telepon terdaftar di WhatsApp pada saat kueri dilakukan. Dengan melakukan kueri ke endpoint REST khusus, tim akan menerima sinyal keberadaan akun secara langsung dalam respons HTTP yang diinisiasi. Arsitektur ini mendukung pemeriksaan nomor tunggal dan permintaan multi sinkron, membantu organisasi membersihkan antrean perutean, melindungi alur kerja pengiriman, dan menghindari pengiriman pesan ke nomor yang tidak teralokasi.

Memahami Sinyal Pendaftaran WhatsApp

Pemeriksaan pendaftaran mengevaluasi apakah pengidentifikasi tertentu memiliki akun di platform pada saat pemeriksaan dilakukan. Sinyal keberadaan platform ini memberikan konteks keterjangkauan teknis sebelum memulai komunikasi.

Nomor telepon harus mengikuti format telekomunikasi publik internasional yang dijelaskan dalam ITU-T Recommendation E.164, yang mewajibkan kode negara dan membatasi panjang nomor hingga 15 digit. Mengevaluasi nomor dalam struktur E.164 menstandardisasi data input di seluruh sistem internasional.

Dari perspektif operasional, data pendaftaran menginformasikan perutean audiens, bukan menetapkan identitas, kepemilikan saluran, atau persetujuan penerima. Organisasi yang melakukan penjangkauan komersial harus menyimpan catatan persetujuan opt-in yang terpisah untuk mematuhi WhatsApp Business Messaging Policy. Menyelaraskan pemeriksaan keberadaan akun dengan persyaratan minimalisasi data dalam GDPR Article 5 (Regulation (EU) 2016/679) memastikan sistem hanya memproses indikator keterjangkauan teknis yang diperlukan untuk alur kerja pengiriman.

Alur Kerja Verifikasi Realtime Sinkron

API WhatsApp lookup mengekspos endpoint sinkron yang dirancang untuk alur keputusan langsung dan in-line. Karena endpoint ini beroperasi secara sinkron, permintaan HTTP yang diinisiasi menerima atribut verifikasi secara langsung dalam payload respons tanpa memerlukan siklus polling sekunder.

Pemeriksaan Nomor Tunggal

Untuk peristiwa transaksional seperti formulir pendaftaran atau input prospek tunggal, integrasi memanggil POST /api/v1/check menggunakan header autentikasi X-API-Key. Permintaan ini mengirimkan string telepon E.164 dan memilih jenis layanan target.

Pemeriksaan Multi Sinkron

Ketika alur kerja memerlukan validasi antrean yang lebih kecil secara bersamaan, POST /api/v1/batch-check menerima hingga 100 nomor telepon dalam satu panggilan. Endpoint ini mengevaluasi seluruh batch secara sinkron dan mengembalikan kumpulan hasil terpadu dalam respons yang diinisiasi.

Pengembang yang mengelola volume permintaan harus meninjau dokumentasi resmi untuk parameter konkurensi dan timeout per pengguna, karena platform mengelola kapasitas melalui kontrol konkurensi, bukan batas permintaan per menit yang tetap.

Membandingkan Jenis Pemeriksaan Layanan Realtime

API lookup menyusun kueri pendaftaran ke dalam tiga jenis layanan realtime khusus untuk mendukung persyaratan risiko dan pengayaan yang berbeda.

Memilih ws memberikan indikator keterjangkauan inti. Untuk alur kerja yang memerlukan pengayaan profil, ws_avatar menambahkan ketersediaan avatar dan tautan gambar yang dihosting saat dapat diakses. Opsi ws_business mengidentifikasi apakah telepon yang terdaftar beroperasi pada platform WhatsApp Business, mendukung segmentasi antara akun konsumen dan komersial.

Menginterpretasikan Kode Status dan Konsumsi Saldo

Respons API publik memformat pemeriksaan yang telah selesai menggunakan bidang amplop standar yang berisi code, msg, dan data. Melakukan parsing yang benar terhadap hasil yang diputuskan versus kesalahan layanan sangat penting untuk alur data yang andal.

Pemeriksaan yang selesai menghasilkan kode respons sukses dengan data.registered yang diatur ke true atau false. Baik catatan yang diputuskan true maupun false mewakili lookup yang selesai dan mengonsumsi saldo sebagaimana mestinya.

Status yang belum ditentukan atau gangguan layanan upstream mengembalikan kode bisnis non-nol, bukan nilai registered=false. Sistem downstream harus mengisolasi kode non-nol untuk logika percobaan ulang alih-alih memperlakukannya sebagai nomor telepon yang tidak teralokasi. Pengguna terdaftar dapat menghubungi dukungan untuk menerima 100 pemeriksaan gratis guna memvalidasi penanganan respons di seluruh lingkungan pengembangan.

Tugas Massal Asinkron untuk Pemrosesan Daftar

Meskipun endpoint sinkron menangani interaksi pelanggan secara langsung, migrasi data besar memerlukan alur kerja asinkron. Untuk validasi berbasis file, tim menggunakan POST /api/v1/bulk-tasks untuk mengirimkan dataset dan GET /api/v1/bulk-tasks/{id} untuk melacak kemajuan pemrosesan.

File tugas massal harus dikirimkan sebagai dokumen TXT atau CSV yang berisi satu nomor telepon per baris. File harus berfokus pada satu tujuan negara, karena daftar dengan 10% atau lebih nomor di luar negara target akan memicu penolakan pra-pemeriksaan. Batas file per produk berlaku, dan tim harus berkonsultasi dengan dokumentasi resmi untuk aturan ukuran file saat ini.

Cakupan regional juga berbeda antar alur kerja. Pemeriksaan nomor tunggal realtime mendukung nomor dari Tiongkok daratan (+86), Hong Kong (+852), dan Makau (+853) pada volume yang lebih rendah, sedangkan tugas file massal asinkron mengecualikan tujuan tersebut. Cakupan Taiwan tetap belum dikonfirmasi di semua mode pemrosesan.

FAQ

Apa perbedaan pemeriksaan sinkron realtime dengan tugas massal asinkron?

Pemeriksaan realtime mengirimkan nomor secara langsung ke POST /api/v1/check atau POST /api/v1/batch-check dan memberikan hasil segera dalam respons HTTP yang sama. Tugas massal asinkron menerima file terformat melalui POST /api/v1/bulk-tasks, mengembalikan ID tugas terlebih dahulu, dan menghasilkan CSV hasil yang dapat diunduh setelah pemrosesan selesai.

Bagaimana API menangani biaya untuk pemeriksaan yang belum ditentukan?

Baik evaluasi yang selesai terdaftar maupun tidak terdaftar akan dikenakan penggunaan pemeriksaan standar. Sebaliknya, hasil yang belum ditentukan atau kesalahan layanan mengembalikan kode status non-nol alih-alih hasil false, dan pemeriksaan yang gagal tidak mengonsumsi saldo.

Pelajari Lebih Lanjut

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

• Lihat dokumentasi produk →
• Hubungi tim kami →