WA Lookup

Apa yang terjadi selama pemeriksaan WhatsApp?

WA Lookup memeriksa satu nomor dalam satu waktu: kirim nomor dalam format E.164 dan pilih service_type (parameter yang memilih produk), lalu hasilnya kembali dalam respons HTTP yang sama. Dalam respons yang berhasil, registered=true berarti nomor terdaftar di WhatsApp dan registered=false berarti tidak terdaftar. Hasil lainnya dikembalikan sebagai kode error dan biaya pemeriksaan dikembalikan.

Menyelesaikan satu pemeriksaan

Bagian ini membahas pemeriksaan real-time: dasbor SaaS dan endpoint REST sinkron berbagi satu layanan pemeriksaan dan satu arti respons. Daftar yang sangat besar memiliki opsi massal asinkron, yang dibahas di akhir halaman ini.

  1. 1

    Kirim nomor

    Kirim nomor yang perlu Anda periksa, menggunakan format yang disyaratkan oleh dokumentasi API.

  2. 2

    Pilih produk

    ws untuk pendaftaran, ws_avatar menambahkan field avatar, ws_business menambahkan field akun Business. Untuk hari aktif, pemeriksaan massal asinkron memiliki produk yang sesuai.

  3. 3

    Baca hasilnya

    Baca registered dalam respons yang sama. Jalankan pemeriksaan baru jika Anda membutuhkan status terbaru.

Format nomor yang harus dikirim

WA Lookup menerima satu nomor per pemeriksaan, ditulis dalam format E.164: tanda plus, kode negara, lalu nomor pelanggan tanpa spasi atau tanda baca — misalnya +17253100591. Ini adalah format yang sama dengan yang disimpan aplikasi WhatsApp secara internal, sehingga nomor dalam bentuk ini memetakan tepat ke satu akun. Nomor tanpa kode negara tidak dapat diperiksa secara andal: digit yang sama ada di banyak negara.

  • Selalu sertakan kode negara; jangan mengandalkan negara akun Anda sendiri.
  • Hapus spasi, tanda hubung, tanda kurung, dan angka nol di depan yang digunakan untuk panggilan domestik — sisakan hanya + dan digit.
  • Nomor dengan format yang salah ditolak sebelum ada tagihan; format yang ditolak bukan hasil "tidak terdaftar".

Apa arti registered?

registered adalah jawaban dari pemeriksaan WhatsApp. Field ini hanya muncul dalam respons yang berhasil, dan bernilai boolean: true berarti nomor terdaftar di WhatsApp pada saat permintaan, false berarti tidak terdaftar. Hal lain — batas waktu habis, hasil yang tidak dapat ditentukan, nomor yang tidak valid — dikembalikan sebagai kode error, dan WA Lookup mengembalikan biaya pemeriksaan tersebut secara otomatis. Jadi, field registered yang tidak ada tidak pernah berarti "tidak terdaftar"; artinya pemeriksaan tidak menghasilkan hasil. Nilainya mencerminkan saat Anda bertanya: akun dibuat dan dihapus setiap saat, jadi perbarui pemeriksaan sebelum Anda bertindak berdasarkan hasil lama, alih-alih menyimpannya dalam cache selama berminggu-minggu.

  • registered=true berarti terdaftar.
  • registered=false berarti tidak terdaftar.
  • Tangani hasil lain sesuai kode respons API; jangan menyimpulkan registered sendiri.

Pilih produk sesuai kebutuhan

Pilih produk real-time terkecil yang menjawab pertanyaan Anda; dokumentasi API memuat definisi field lengkap.

  • ws mengembalikan status pendaftaran.
  • ws_avatar juga mengembalikan field avatar; avatar_url berupa string kosong jika tidak ada avatar yang tersedia.
  • ws_business juga mengembalikan field akun Business.

Gunakan hasil sesuai cakupannya

Pemeriksaan mencerminkan status pada saat permintaan. Ini bukan verifikasi identitas atau izin untuk menghubungi seseorang.

  • Tidak memastikan siapa pemilik nomor, apakah mereka sedang online saat ini, atau isi pesan apa pun; produk aktivitas massal mengembalikan jumlah hari sejak terakhir aktif, bukan kehadiran langsung.
  • Hasil terdaftar tidak menetapkan persetujuan untuk menghubungi nomor tersebut.
  • Jalankan pemeriksaan baru jika keputusan bisnis membutuhkan status terkini.

Daftar yang sangat besar: opsi asinkron

Pemeriksaan multi di dasbor dan endpoint multi API mencakup sebagian besar daftar. Hanya jika daftar jauh melebihi batas tersebut, masuk akal untuk mengirim seluruh file sebagai satu tugas massal asinkron — Anda memilih negara asal daftar, dan daftar tersebut sebaiknya pada dasarnya berasal dari satu negara itu.

  • Unggah file .txt atau .csv dengan satu nomor E.164 per baris, dari halaman pemeriksaan massal atau melalui API.
  • Pilih negara asal nomor saat mengirim; daftar sebaiknya pada dasarnya berasal dari satu negara itu. Terlalu banyak nomor dari negara lain membuat tugas gagal saat file sedang disiapkan — tugas tidak dikirim untuk diperiksa dan dikembalikan sepenuhnya.
  • Saldo dicadangkan untuk baris yang valid saat pengiriman, Anda hanya ditagih untuk nomor yang mengembalikan hasil, dan selisihnya dikembalikan.
  • Tugas berjalan di latar belakang; unduh file hasil setelah selesai. Tugas yang gagal dikembalikan sepenuhnya.

Standar terkait