Danh tính nhận dạng trên WhatsApp của người dùng

/v1/contacts/{users-whatsapp-id}/identity

Bạn có thể nhận được thông báo từ WhatsApp khi người dùng giao tiếp với bạn có khả năng đã thay đổi. Sử dụng cạnh /v1/contacts này để quản lý danh tính của người dùng. Hãy xem bài viết Tìm hiểu về sự thay đổi danh tính trên WhatsApp Business để biết thêm thông tin.

Để biết thêm thông tin về thông báo hệ thống gửi từ WhatsApp, hãy xem phần Thông báo đến từ hệ thống - Ví dụ: Người dùng có khả năng đã thay đổi. Doanh nghiệp của bạn sẽ quản lý việc phản hồi thông báo hệ thống.

Đọc

Lệnh gọi GET đến điểm cuối này sẽ truy xuất hash danh tính mới nhất của người dùng.

Ví dụ

Yêu cầu:

GET /v1/contacts/users-whatsapp-id/identity

Nếu thành công, yêu cầu của bạn sẽ trả về 200 OK và nội dung tin nhắn chứa đối tượng contacts. Ví dụ: phản hồi đầy đủ (bao gồm cả đối tượng contacts) sẽ có dạng như sau:

{
    "contacts":
    {
        "hash": "UKD6Y/5SqDU=",
        "created_timestamp": 1600132094000,
        "acknowledged": true 
    }
}
  

Trường được trả về

Đối tượng phản hồi contacts chứa thông tin sau đây về danh tính của người dùng.

Tạo

Sử dụng lệnh gọi PUT đến điểm cuối này để xác nhận thông báo user_identity_changed mới nhất từ hệ thống.

Nếu bạn chưa thực hiện thành công lệnh gọi API identity sau khi nhận được thông báo user_identity_changed, tất cả thông báo gửi đến người dùng này sẽ bị chặn nếu tùy chọn cài đặt show_security_notifications đang bật trong phần cài đặt ứng dụng.

Ví dụ

Yêu cầu:

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

Phản hồi thành công là 200 OK, trong đó nội dung thông báo là null hoặc {}.

Thông số