Cara Menyiapkan Daftar CSV atau TXT untuk Pemeriksaan Nomor WhatsApp Real-Time

Panduan alur kerja praktis untuk menyiapkan daftar nomor telepon dalam CSV atau TXT bagi pemeriksaan WhatsApp real-time: format E.164, memilih jenis layanan, dan mengambil sinyal keberadaan akun dari endpoint tunggal dan multi yang sinkron.

WA Lookup memeriksa keberadaan akun WhatsApp secara real-time: kirim satu nomor ke endpoint pemeriksaan sinkron, atau hingga 100 nomor ke endpoint multi sinkron POST /api/v1/batch-check, dan hasil yang sudah selesai dikembalikan dalam respons HTTP dari permintaan tersebut, tanpa job yang perlu ditunggu. Untuk memproses daftar CSV atau TXT melaluinya, format setiap identifier secara ketat sesuai standar penomoran internasional E.164, hapus karakter non-angka dan prefiks lokal, lalu pilih jenis layanan yang dibutuhkan alur kerja Anda: ws untuk status pendaftaran dasar, ws_avatar untuk menyertakan ketersediaan avatar, atau ws_business untuk mengidentifikasi akun WhatsApp Business. Seluruh file yang jauh melebihi satu permintaan real-time juga dapat diunggah sebagai tugas massal asinkron (unggah, tunggu, unduh).

Memahami Sinyal Verifikasi WhatsApp

Saat menyiapkan daftar CSV atau TXT untuk pemeriksaan real-time, langkah pertama adalah menentukan sinyal keberadaan akun mana yang mendukung alur kerja spesifik Anda. WA Lookup menyediakan tiga jenis layanan yang berbeda, semuanya diakses melalui endpoint sinkron yang sama. Parameter service_type menentukan kolom mana yang dikembalikan dalam respons.

Pemeriksaan Pendaftaran Dasar (ws)

Jenis layanan ws memastikan apakah nomor telepon yang dikirim saat ini terdaftar di WhatsApp. Pemeriksaan ini mengembalikan kolom registered, yang memberikan sinyal keberadaan akun yang lugas. Sinyal ini menjadi dasar keputusan internal tentang nomor mana di file CSV atau TXT Anda yang terkait dengan akun WhatsApp pada saat pemeriksaan.

Pemeriksaan Pengayaan Avatar (ws_avatar)

Jenis layanan ws_avatar mencakup pemeriksaan pendaftaran dasar dan menambahkan kemampuan pengayaan profil. Selain status registered, pemeriksaan ini mengembalikan nilai boolean avatar yang menunjukkan ketersediaan avatar dan string avatar_url. Kolom URL tersebut kosong jika tidak ada URL yang tersedia. Konteks tambahan ini dapat menjadi salah satu masukan di samping pemeriksaan lain saat meninjau profil pengguna.

Pemeriksaan Akun Bisnis (ws_business)

Jenis layanan ws_business memeriksa pendaftaran WhatsApp dan mengidentifikasi apakah akun tersebut menggunakan WhatsApp Business. Layanan ini mengembalikan nilai boolean business. Sinyal ini membantu tim menyegmentasikan daftar mereka dengan membedakan akun standar dari profil bisnis, sehingga mendukung perutean alur kerja yang lebih terarah.

Menyiapkan File Data Anda

Persyaratan paling penting untuk memproses daftar CSV atau TXT melalui pemeriksaan real-time adalah format data yang benar. WA Lookup mewajibkan semua nomor dikirim dalam format E.164. E.164 adalah rencana penomoran telepon internasional yang memberikan identifier unik secara global kepada setiap perangkat. Untuk menyiapkan file CSV atau TXT Anda:

1. Sertakan Kode Negara: Setiap nomor harus diawali dengan kode negara internasional yang sesuai.
2. Hapus Karakter Format: Buang spasi, tanda hubung, tanda kurung, dan karakter non-angka lainnya dari daftar Anda.
3. Hilangkan Angka Nol di Depan: Hapus prefiks trunk lokal (sering berupa angka nol di depan) yang bukan bagian dari kode panggilan internasional.

Misalnya, nomor yang berbasis di AS harus diformat sebagai rangkaian angka tanpa jeda yang diawali kode negara (misalnya 1). Memastikan seluruh daftar Anda mematuhi standar E.164 membantu menghindari kesalahan format selama proses pemeriksaan sinkron. File masukan yang bersih dan terstandarisasi sangat penting untuk mengambil sinyal keberadaan akun yang akurat bagi setiap nomor yang dikirim.

Mengirim Daftar Anda untuk Verifikasi

Setelah daftar CSV atau TXT Anda diformat dengan benar, Anda dapat mengirim identifier ke platform WA Lookup. Jalur utamanya bersifat sinkron: hasil dikembalikan dalam respons HTTP yang sama dengan permintaan, bukan dikirim di kemudian waktu. Bagi tim teknis yang mengintegrasikan layanan ini, gunakan POST /api/v1/check untuk satu identifier atau endpoint multi sinkron POST /api/v1/batch-check untuk hingga 100 identifier. Kedua permintaan memerlukan header X-API-Key dan header Content-Type: application/json. Body pemeriksaan tunggal berisi service_type dan identifier; body multi berisi service_type dan identifiers. Ikuti panduan konkurensi dalam dokumentasi API. Seluruh file CSV atau TXT yang jauh melebihi satu permintaan real-time juga dapat diunggah sebagai tugas massal asinkron; Anda memilih negara asal nomor-nomor tersebut saat mengirim, dan daftar tersebut pada dasarnya harus berasal dari satu negara itu. Pemeriksaan yang gagal, melewati batas waktu, dan tidak dapat ditentukan tidak dikenakan biaya. Lihat halaman harga untuk detail penagihan yang berlaku saat ini.

Menafsirkan Hasil Anda

Untuk pemeriksaan WhatsApp yang selesai, data yang dikembalikan berisi service_type, identifier, dan registered; ws_avatar juga menyertakan avatar dan avatar_url, sedangkan ws_business menyertakan business. Kolom internal terkait catatan, transaksi, status, dan penagihan tidak dikembalikan. Hasil registered melaporkan kolom status WhatsApp yang tersedia tepat pada saat pemeriksaan. Penting untuk memahami batasan sinyal keberadaan akun ini. Selain itu, proses verifikasi tidak melaporkan kehadiran langsung (online), riwayat pesan, atau persetujuan kontak. Proses ini juga tidak menunjukkan apakah nomor tersebut dapat berhasil dihubungi atau apakah pesan akan terkirim. Sinyal ini hanya memberi informasi kepada basis data internal Anda tentang pendaftaran di platform, yang dapat menjadi salah satu masukan di samping pemeriksaan lain saat mengatur CRM atau merutekan data.

FAQ

Format apa yang diwajibkan untuk nomor telepon?

Semua nomor telepon harus dikirim secara ketat dalam format E.164. Rencana penomoran internasional ini mewajibkan kode negara dan penghapusan semua karakter non-angka, spasi, serta angka nol lokal di depan.

Bisakah saya memeriksa status WhatsApp Business untuk satu daftar?

Ya, dengan memilih jenis layanan ws_business, Anda dapat memeriksa status pendaftaran dasar sekaligus apakah akun tersebut menggunakan WhatsApp Business. Hasilnya berupa nilai boolean khusus yang menunjukkan keberadaan akun bisnis, baik untuk pemeriksaan tunggal maupun permintaan multi sinkron.

Apa yang terjadi jika pemeriksaan gagal?

Pemeriksaan yang gagal, melewati batas waktu, dan tidak dapat ditentukan tidak dikenakan biaya. Lihat halaman harga untuk detail penagihan yang berlaku saat ini.

Apakah hasil verifikasi dikirim secara asinkron?

Tidak pada jalur utama. Endpoint tunggal dan multi yang sinkron mengembalikan hasil yang sudah selesai dalam respons HTTP yang sama dengan permintaan. Tugas massal asinkron (unggah, tunggu, unduh) juga tersedia sebagai tambahan untuk seluruh daftar berukuran besar, tetapi untuk pemeriksaan sehari-hari, endpoint sinkron adalah pilihan yang tepat.