Pengelolaan Username WhatsApp Business secara Terprogram

Panduan teknis untuk mengintegrasikan pemeriksaan registrasi, avatar, dan akun bisnis WhatsApp secara sinkron ke dalam alur kerja CRM menggunakan endpoint POST /api/v1/check.

Pemetaan identitas WhatsApp secara terprogram melibatkan penggunaan endpoint POST /api/v1/check yang terdokumentasi untuk memverifikasi status registrasi, ketersediaan avatar, dan jenis akun bisnis. Dengan mengirim nomor berformat E.164 beserta payload service_type yang sesuai, tim menerima data JSON sinkron dalam respons HTTP yang sama. Sinyal keberadaan akun ini membantu memperkaya catatan CRM, mendukung pembersihan daftar prospek, dan menjadi dasar alur perutean otomatis, sehingga tim operasional memiliki konteks yang diperlukan untuk menyegmentasikan kontak tanpa bergantung pada polling asinkron atau webhook.

Peran Pemeriksaan WhatsApp Terprogram

Mengintegrasikan sinyal keberadaan akun WhatsApp ke dalam operasi bisnis membantu tim menjaga basis data tetap bersih dan mendukung alur komunikasi yang lebih efisien. Ketika organisasi mengumpulkan nomor telepon melalui formulir pendaftaran, kampanye perolehan prospek, atau portal dukungan pelanggan, nomor-nomor tersebut sering kali tidak memiliki konteks tentang keberadaannya di platform perpesanan. Dengan memeriksa nomor-nomor ini secara terprogram sebelum memulai penjangkauan, tim operasional dapat menyegmentasikan daftar kontak berdasarkan registrasi platform yang aktif. Proses ini mendukung pembersihan daftar prospek dengan mengidentifikasi catatan mana yang terkait dengan akun WhatsApp dan mana yang tidak. Selain itu, proses ini menjadi dasar keputusan perutean otomatis. Pendekatan terprogram ini membantu menjaga akurasi data dan memberikan konteks yang diperlukan tim untuk menyusun saluran komunikasi secara efektif.

Memahami Sinyal Identitas WhatsApp

Platform menyediakan tiga jenis layanan yang berbeda melalui satu endpoint, sehingga pengembang dapat meminta tingkat detail spesifik yang dibutuhkan alur kerja mereka. Setiap jenis layanan mengendalikan field mana yang dikembalikan dalam respons JSON dan biaya saldo mana yang berlaku.

• Pemeriksaan Registrasi (ws): Ini adalah pemeriksaan dasar. Pemeriksaan ini mengevaluasi nomor E.164 yang dikirim dan mengembalikan field registered, yang memberikan sinyal keberadaan akun yang lugas di platform WhatsApp standar.
• Pemeriksaan Avatar (ws_avatar): Pemeriksaan ini mencakup status registrasi dasar dan menambahkan data pengayaan profil. Pemeriksaan ini mengembalikan boolean avatar yang menunjukkan apakah avatar tersedia, serta string avatar_url yang kosong jika URL tidak tersedia.
• Pemeriksaan Akun Bisnis (ws_business): Dirancang untuk segmentasi B2B, pemeriksaan ini mengembalikan status registrasi dasar bersama boolean business. Sinyal spesifik ini membantu tim mengidentifikasi apakah kontak menggunakan akun WhatsApp Business.

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.

Mengimplementasikan Alur Kerja API Sinkron

Integrasi teknis bergantung pada kontrak permintaan sinkron yang sederhana. Karena hasilnya sinkron, hasil dikembalikan dalam respons HTTP yang sama dengan permintaan. CRM dapat menyimpan catatan di memori, melakukan panggilan API, dan langsung menerapkan sinyal yang dikembalikan ke alur kerja. Kontrak permintaan yang terdokumentasi mensyaratkan pengiriman permintaan ke endpoint POST /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 dua field:

• service_type: Nilai string ws, ws_avatar, atau ws_business.
• identifier: Nomor telepon yang diformat sesuai standar E.164.

Untuk mendukung integrasi ini, dasbor platform menyediakan alat administratif yang lengkap. Tim pengembangan dan operasional dapat mengelola kunci API, memantau saldo, meninjau riwayat pemeriksaan, dan mengakses pelaporan per produk. Dasbor juga menampilkan pemeriksaan terbaru, metrik pengeluaran saldo, dan aktivitas akun untuk membantu memantau penggunaan API dan volume alur kerja.

Praktik Terbaik untuk Integritas Data dan Perutean

Saat mengintegrasikan pemeriksaan terprogram ke lingkungan produksi, sangat penting untuk menetapkan ekspektasi yang akurat tentang apa yang direpresentasikan oleh data. Hasil terdaftar melaporkan field status WhatsApp yang tersedia tepat pada waktu pemeriksaan. Hasil ini berfungsi murni sebagai sinyal keberadaan akun. Hasil ini tidak memverifikasi status online, stempel waktu terakhir dilihat, riwayat pesan, atau persetujuan kontak. Pemeriksaan yang gagal, habis waktu, dan tidak dapat ditentukan tidak dikenai biaya. Lihat halaman harga untuk detail penagihan terkini.

FAQ

Apa perbedaan antara pemeriksaan registrasi dan pemeriksaan akun bisnis?

Pemeriksaan registrasi standar (menggunakan jenis layanan ws) mengembalikan sinyal keberadaan akun yang menunjukkan apakah nomor E.164 yang dikirim terdaftar di WhatsApp. Pemeriksaan akun bisnis (menggunakan jenis layanan ws_business) mengembalikan status registrasi yang sama tetapi menambahkan field boolean business, yang menunjukkan apakah akun menggunakan WhatsApp Business.

Apakah saya perlu menyiapkan webhook untuk pemeriksaan WhatsApp?

Tidak. Semua pemeriksaan bersifat sinkron. Hasilnya dikembalikan dalam respons HTTP yang sama dengan permintaan awal, sehingga tidak perlu mengonfigurasi webhook atau mengimplementasikan logika polling asinkron di aplikasi Anda.

Format apa yang harus digunakan untuk nomor telepon di API?

Semua nomor telepon yang dikirim harus diformat sesuai standar rencana penomoran telepon internasional E.164.

Apakah status terdaftar berarti saya dapat mengirim pesan kepada pengguna?

Hasil terdaftar murni merupakan sinyal keberadaan akun yang tersedia pada waktu pemeriksaan. Hasil ini tidak melaporkan kehadiran langsung, riwayat pesan, persetujuan kontak, atau apakah nomor tersebut dapat berhasil menerima pesan.

Bagaimana pemeriksaan yang gagal atau tidak dapat ditentukan ditagih?

Pemeriksaan yang gagal, habis waktu, dan tidak dapat ditentukan tidak dikenai biaya. Lihat halaman harga untuk detail penagihan terkini.