API Foto Profil WhatsApp: Analisis Avatar Realtime berdasarkan Nomor Telepon

Panduan pengembang untuk API foto profil WhatsApp: apa yang dikembalikan oleh alat berbasis URL, perbedaan antara permintaan avatar WhatsApp realtime tunggal dan multi sinkron dari AvatarLookup, serta cara menyimpan dan mencoba ulang hasil.

API foto profil WhatsApp mengambil nomor telepon dan mengembalikan informasi tentang foto profil publik di baliknya. Banyak alat hanya berhenti pada URL gambar sementara yang harus Anda unduh dan interpretasikan sendiri. Analisis avatar WhatsApp dari AvatarLookup mengembalikan hasil terstruktur sebagai gantinya: pemeriksaan tunggal realtime melalui POST /api/v1/check, atau pemeriksaan multi sinkron melalui POST /api/v1/batch-check dengan 1–100 nomor per permintaan. Atribut penampilan dalam hasil adalah estimasi algoritmik. Hanya avatar publik yang dianalisis, sehingga kontak yang membatasi foto mereka hanya untuk kontak yang disimpan akan menunjukkan tidak ada gambar publik, dan hasil Tidak dapat ditentukan harus dicoba ulang nanti alih-alih dibaca sebagai vonis tentang akun tersebut.

Tiga jenis API foto profil WhatsApp

Hasil pencarian untuk frasa ini mencampuradukkan tiga hal yang berbeda, dan memilih yang salah akan membuang waktu integrasi.

Pengaturan bisnis resmi adalah untuk foto akun Anda sendiri, bukan untuk mencari nomor lain. Alat berbasis URL mengembalikan tautan yang biasanya kedaluwarsa, sehingga tim akhirnya mengunduh, menyimpan, dan melabeli gambar sendiri. Analisis avatar melewati langkah penanganan gambar dan mengembalikan data yang sesuai dengan catatan kontak. Ketiganya dibatasi oleh aturan yang sama: foto harus terlihat secara publik.

Pemeriksaan tunggal realtime dengan POST /api/v1/check

Gunakan pemeriksaan tunggal saat satu nomor memerlukan jawaban dalam alur interaktif, seperti agen dukungan yang membuka catatan kontak.

1. Normalisasi nomor. Ubah menjadi format internasional dengan kode negara, mengikuti struktur ITU-T Recommendation E.164, dan hapus spasi, tanda hubung, serta tanda kurung.
2. Kirim satu permintaan terautentikasi ke POST /api/v1/check dengan menyebutkan produk avatar WhatsApp dan nomornya. Ikuti dokumentasi API untuk isi permintaan yang tepat; jangan menebak nama bidang.
3. Baca respons sekali dan simpan dengan tanggal pemeriksaan dan label sumber WhatsApp.
4. Cabangkan berdasarkan hasil: avatar publik ditemukan, tidak ada avatar publik, atau tidak dapat ditentukan.

Jaga agar panggilan tetap berada di luar jalur pemblokiran yang ditunggu oleh pelanggan. Jika pemeriksaan lambat atau tidak dapat ditentukan, catatan harus tetap tersimpan, dengan bidang avatar dibiarkan kosong dan tanda bahwa pemeriksaan di kemudian hari diperlukan. Nomor dari Tiongkok Daratan, Hong Kong, dan Makau hanya didukung melalui pemeriksaan tunggal realtime, jadi arahkan ke sini alih-alih ke file massal.

Pemeriksaan multi sinkron dengan POST /api/v1/batch-check

Pemeriksaan multi menangani daftar pendek dalam satu panggilan. Setiap permintaan menerima 1–100 pengenal dari satu jenis produk dan mengembalikan hasil sebagai JSON berurutan, sesuai dengan urutan yang Anda kirim.

Aturan praktis untuk permintaan multi:

• Jangan mencampur produk. Kirim nomor WhatsApp dalam satu permintaan dan alamat Gmail, Yandex, atau Mail.ru yang didukung dalam permintaan lain.
• Andalkan urutan, lalu verifikasi. Hasil mengikuti urutan input; tetap cocokkan setiap hasil kembali ke nomor inputnya sebelum menulis ke basis data Anda.
• Pecah daftar yang lebih panjang. Bagi daftar 350 nomor menjadi empat permintaan hingga 100 nomor.
• Gunakan tugas massal untuk file besar. Jika daftar jauh lebih besar, produk massal WhatsApp asinkron menerima file TXT atau CSV dan mengembalikan satu CSV untuk tugas tersebut.

Tim non-teknis dapat menggunakan dasbor sebagai gantinya, yang menerima hingga 500 pengenal dan memprosesnya satu per satu. Bagaimanapun, hanya WhatsApp dan domain email yang didukung yang memiliki pemeriksaan realtime dan multi; Telegram, Viber, MAX, LINE, dan Zalo hanya tersedia untuk produk massal.

Menangani hasil tidak dapat ditentukan dan tidak ada avatar

Sebagian besar bug integrasi berasal dari penggabungan hasil yang berbeda menjadi satu nilai kosong. Jaga agar tetap terpisah:

• Hasil diproduksi. Respons multi menandai setiap item di mana hasil diproduksi. Tanda itu berarti hasil ada untuk permintaan tersebut, bukan berarti akun WhatsApp ada.
• Hasil tidak diproduksi. Ini mencakup item yang tidak valid, tidak dapat ditentukan, atau gagal. Ini bukan vonis negatif tentang akun atau avatarnya, jadi jadwalkan percobaan ulang nanti alih-alih menghapus kontak.
• Tidak ada avatar publik. Hasil yang selesai dapat menunjukkan bahwa tidak ada gambar publik yang tersedia. Pengaturan privasi WhatsApp memungkinkan pengguna menampilkan foto profil mereka kepada Semua orang, Kontak saya, Kontak saya kecuali orang tertentu, atau Tidak ada siapa pun, jadi gambar publik yang hilang sering kali hanya merupakan pilihan privasi.

Tulis setiap status ke nilainya sendiri, seperti publik, tidak ada, atau coba ulang, dan catat alasan untuk percobaan ulang. Model status yang bersih juga membuat pelaporan menjadi jujur: jumlah "tidak ada avatar" di dasbor tidak boleh menyertakan item yang hanya tidak dapat ditentukan.

Menyimpan hasil sebagai estimasi

Atribut penampilan, seperti jenis gambar, rentang usia, atau warna rambut, mendeskripsikan gambar, bukan orang di balik nomor tersebut. Kartun, hewan peliharaan, logo, atau foto grup semuanya bisa menjadi foto profil yang valid, dan analisis terhadapnya tetap merupakan jawaban yang lengkap.

Pola penyimpanan sederhana:

Jauhkan bidang-bidang ini dari keputusan kelayakan, kredit, perekrutan, atau penetapan harga, dan dari penyaringan apa pun yang memperlakukan orang secara berbeda berdasarkan estimasi usia atau jenis kelamin. Avatar publik adalah sinyal data kontak; ini tidak memverifikasi identitas, kepemilikan akun, atau persetujuan untuk dihubungi. Tetapkan interval peninjauan, karena pengguna mengubah gambar mereka, dan hapus estimasi lama sesuai kebijakan retensi normal Anda.

FAQ

Bagaimana tim bisa mendapatkan file gambar sebenarnya alih-alih bidang analisis?

Analisis avatar dirancang untuk mengembalikan hasil terstruktur tentang avatar publik, bukan untuk bertindak sebagai pengunduh gambar. Jika alur kerja benar-benar perlu menampilkan gambar, pertimbangkan apakah itu diperlukan untuk tujuan tersebut dan bagaimana file akan disimpan serta dihapus. Banyak alur kerja data kontak hanya perlu mengetahui apakah avatar publik ada dan jenis gambar apa itu, yang sudah dijawab oleh analisis.

Bagaimana pengembang harus mencoba ulang pemeriksaan WhatsApp yang tidak dapat ditentukan?

Kumpulkan nomor yang tidak dapat ditentukan dalam antrean coba ulang alih-alih mengirimnya kembali secara langsung dalam perulangan. Periksa kembali nanti dalam permintaan tunggal atau multi, dan batasi jumlah percobaan per nomor agar kegagalan yang persisten tidak berjalan selamanya. Setelah percobaan terakhir, simpan catatan sebagai tidak dapat ditentukan alih-alih mengubahnya menjadi tidak ada avatar, karena hasil tersebut berarti hal yang berbeda.

Bagaimana tim bisa memeriksa gambar yang sudah mereka miliki alih-alih nomor telepon?

Gunakan Analisis profil gambar. Ini menerima file JPEG, PNG, WebP, atau GIF dan dipanggil melalui endpoint profil gambar yang didokumentasikan dengan unggahan file multipart. Ini mendeskripsikan gambar itu sendiri, mengembalikan jenis gambar dan atribut penampilan sebagai estimasi algoritmik, tanpa melibatkan nomor telepon atau akun. Ini cocok untuk gambar yang diunggah langsung oleh pelanggan, seperti foto profil yang dikirimkan melalui formulir.

Pelajari Lebih Lanjut

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

• Kunjungi situs web produk →