Mengintegrasikan WA Lookup: Kebersihan Data CRM dan Klasifikasi Akun Otomatis

Pelajari cara mengintegrasikan API WA Lookup sinkron untuk memverifikasi keberadaan akun WhatsApp, mengambil detail avatar, dan mengklasifikasikan akun bisnis demi kebersihan data CRM.

API WA Lookup memungkinkan sistem CRM melakukan verifikasi sinkron atas keberadaan akun WhatsApp. Dengan mengirim permintaan POST ke endpoint /api/v1/check beserta nomor telepon berformat E.164, pengembang dapat mengambil status registrasi, ketersediaan avatar, atau klasifikasi akun bisnis dalam respons HTTP yang sama. Data ini membantu menjaga kebersihan CRM dengan mengidentifikasi catatan valid yang terhubung ke WhatsApp tanpa memerlukan pemrosesan asinkron, polling, atau webhook.

Memahami Arsitektur API WA Lookup

Mengintegrasikan sinyal keberadaan akun ke dalam CRM memerlukan arsitektur yang mendukung perutean data dan pengambilan keputusan secara langsung. API WA Lookup dirancang di sekitar satu endpoint sinkron: POST /api/v1/check. Ketika sistem CRM atau platform operasional data mengirim permintaan, API memproses pemeriksaan dan mengirimkan hasilnya dalam respons HTTP yang sama. Arsitektur sinkron ini menghilangkan beban rekayasa yang terkait dengan pemrosesan asinkron, seperti mengonfigurasi webhook, mengelola URL callback, atau mengimplementasikan logika polling. Pengembang dapat mengintegrasikan API langsung ke alur kerja sinkron, seperti formulir penerimaan prospek atau pipeline pembersihan data real-time. 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. Field internal untuk catatan, transaksi, status, dan penagihan tidak dikembalikan.

Mengklasifikasikan Jenis Akun WhatsApp

Untuk mendukung berbagai kebutuhan kebersihan data CRM, API real-time menawarkan tiga jenis layanan yang berbeda. Ketiganya menggunakan endpoint sinkron yang sama, dengan parameter service_type yang mengendalikan field spesifik mana yang dikembalikan dalam respons dan biaya saldo mana yang berlaku untuk transaksi.

Membandingkan Jenis Layanan

WhatsApp Checker (ws) adalah jenis layanan dasar. Layanan ini hanya digunakan untuk mengonfirmasi apakah nomor telepon yang dikirim terdaftar di WhatsApp, dan hanya mengembalikan field registered. Layanan ini biasanya digunakan untuk pembersihan daftar dasar dan mengidentifikasi kontak CRM mana yang memiliki akun di WhatsApp. WhatsApp Avatar Checker (ws_avatar) memperluas pemeriksaan dasar dengan menambahkan kemampuan pengayaan profil. Selain status registrasi, layanan ini mengembalikan boolean avatar yang menunjukkan apakah foto profil telah diatur, serta string avatar_url. Field URL kosong jika URL tidak tersedia. Sinyal ini dapat membantu tim meninjau kelengkapan profil kontak. WhatsApp Business Checker (ws_business) dirancang untuk segmentasi CRM B2B. Layanan ini memeriksa registrasi WhatsApp dan mengembalikan boolean business yang menunjukkan apakah akun menggunakan WhatsApp Business. Hal ini memungkinkan manajer operasional data memisahkan akun pribadi dari akun bisnis di dalam basis data mereka.

Implementasi Teknis dan Kebersihan Data

Mengintegrasikan API ke dalam CRM atau pipeline data memerlukan kepatuhan pada kontrak permintaan yang terdokumentasi. API mengharapkan payload JSON dan header tertentu untuk mengautentikasi dan memproses permintaan dengan berhasil. Kontrak permintaan yang terdokumentasi mensyaratkan permintaan POST ke /api/v1/check. Permintaan harus menyertakan dua header: X-API-Key yang berisi kunci autentikasi Anda, dan Content-Type: application/json. Body JSON harus berisi tepat dua field:

1. service_type: Nilai string ws, ws_avatar, atau ws_business.
2. identifier: Nomor telepon yang akan diperiksa.

Yang terpenting, semua nomor telepon yang dikirim harus diformat sesuai rencana penomoran telepon internasional E.164. Sebagai contoh, nomor AS harus dikirim sebagai +17253100591. Tidak menggunakan format E.164 dapat mengakibatkan error parsing atau pemeriksaan yang tidak dapat ditentukan. Body JSON standar terlihat seperti ini: {"service_type": "ws_business", "identifier": "+17253100591"} Dengan menstandarkan input CRM ke E.164 dan merutekannya melalui pemeriksaan sinkron ini, pengembang dapat secara otomatis menandai nomor yang tidak valid, menyegmentasikan pengguna bisnis, dan menjaga standar kebersihan data yang tinggi. Karena responsnya langsung, pemeriksaan ini dapat diintegrasikan langsung ke formulir entri data, sehingga hanya sinyal keberadaan akun yang terverifikasi yang disimpan ke basis data.

Pelaporan Dasbor dan Manajemen Akun

Pengelolaan penggunaan API dan pemantauan operasi kebersihan data ditangani melalui dasbor platform. Dasbor menyediakan alat yang lengkap bagi administrator CRM dan pengembang untuk melacak kinerja integrasi dan mengelola autentikasi. Dasbor mendukung manajemen kunci API secara penuh, sehingga tim dapat merotasi kunci dengan aman. Untuk pengawasan operasional, dasbor memberikan visibilitas atas saldo akun saat ini, riwayat pemeriksaan yang terperinci, dan pelaporan per produk. Administrator dapat meninjau pemeriksaan terbaru, memantau pengeluaran saldo, dan menganalisis aktivitas akun untuk memahami bagaimana API digunakan di berbagai alur kerja CRM. 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. Field internal untuk catatan, transaksi, status, dan penagihan tidak dikembalikan.

FAQ

Apakah API WA Lookup sinkron atau asinkron?

API WA Lookup sepenuhnya sinkron. Ketika permintaan dikirim ke endpoint POST /api/v1/check, hasilnya dikembalikan dalam respons HTTP yang sama dengan permintaan.

Bisakah API ini memverifikasi apakah pengguna sedang online?

Tidak. Hasil terdaftar melaporkan field status WhatsApp yang tersedia pada saat pemeriksaan. Hasil ini hanya berfungsi sebagai sinyal keberadaan akun dan tidak melaporkan kehadiran langsung, riwayat pesan, persetujuan kontak, atau apakah nomor tersebut saat ini dapat dihubungi.

Apa perbedaan antara jenis layanan ws, ws_avatar, dan ws_business?

Ketiga jenis layanan menggunakan endpoint sinkron yang sama tetapi mengembalikan field yang berbeda. Jenis layanan ws mengonfirmasi registrasi WhatsApp dasar. Jenis layanan ws_avatar mengembalikan status registrasi bersama boolean avatar dan field URL avatar, yang kosong jika URL tidak tersedia. Jenis layanan ws_business mengembalikan status registrasi dan boolean yang menunjukkan apakah akun menggunakan WhatsApp Business.