/v1/contacts/{users-whatsapp-id}/identity
Anda dapat menerima notifikasi dari WhatsApp ketika pengguna yang Anda ajak berkomunikasi berpotensi berubah nomornya. Gunakan edge /v1/contacts ini untuk mengelola identitas pengguna. Lihat Memahami Perubahan Identitas untuk WhatsApp Business untuk informasi selengkapnya.
Untuk informasi selengkapnya tentang notifikasi sistem yang dikirim dari WhatsApp, lihat Pesan Sistem Masuk — Contoh: Pengguna Mungkin Berubah. Tanggapan atas notifikasi sistem dikelola oleh bisnis Anda.
Panggilan GET
ke endpoint ini mengambil hash identitas terbaru untuk pengguna.
Permintaan:
GET /v1/contacts/users-whatsapp-id/identity
Tanggapan:
Jika berhasil, permintaan Anda mengembalikan 200 OK
dan badan pesan berisi objek contacts
. Contoh, tanggapan lengkap, termasuk objek contacts
, mungkin terlihat seperti ini:
{ "contacts": { "hash": "UKD6Y/5SqDU=", "created_timestamp": 1600132094000, "acknowledged": true } }
Objek tanggapan contacts
berisi informasi berikut tentang identitas pengguna.
Nama | Deskripsi |
---|---|
jenis: String | Status penerimaan notifikasi sistem |
jenis: int | Cap waktu saat klien API WhatsApp Business mendeteksi bahwa pengguna mungkin berubah. |
jenis: String | Pengidentifikasi untuk notifikasi sistem |
Gunakan panggilan PUT
ke endpoint ini untuk memberi tanda terima notifikasi sistem user_identity_changed
terbaru.
Sampai panggilan API identity
berhasil dibuat setelah menerima notifikasi user_identity_changed
, semua pesan keluar kepada pengguna ini akan diblokir jika pengaturan show_security_notifications
diaktifkan di pengaturan aplikasi.
Permintaan:
PUT /v1/contacts/users-whatsapp-id/identity { “hash”: “Rc/eg9RQ0JA=” }
Tanggapan:
Tanggapan yang berhasil adalah 200 OK
dengan isi pesan null
atau {}
.
Nama | Deskripsi |
---|---|
jenis: String | Pengidentifikasi notifikasi sistem |