Identitas ID WhatsApp Pengguna

/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.

Membaca

Panggilan GET ke endpoint ini mengambil hash identitas terbaru untuk pengguna.

Contoh

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 
    }
}
  

Kolom yang Dikembalikan

Objek tanggapan contacts berisi informasi berikut tentang identitas pengguna.

NamaDeskripsi

acknowledged

jenis: String

Status penerimaan notifikasi sistem user_identity_changed terbaru.

created_timestamp

jenis: int

Cap waktu saat klien API WhatsApp Business mendeteksi bahwa pengguna mungkin berubah.

hash

jenis: String

Pengidentifikasi untuk notifikasi sistem user_identity_changed terbaru.

Membuat

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.

Contoh

Permintaan:

PUT /v1/contacts/users-whatsapp-id/identity
  {
    “hash”: “Rc/eg9RQ0JA=”
  }

Tanggapan:

Tanggapan yang berhasil adalah 200 OK dengan isi pesan null atau {}.

Parameter

NamaDeskripsi

hash

jenis: String

Pengidentifikasi notifikasi sistem user_identity_change yang diterima untuk kontak ini