Sự kiện người dùng click nút “Nhắn tin” trên Official Account

Lưu ý

Quyền cần có: Sự kiện người dùng click nút “Nhắn tin” trên Official Account

Khi người dùng click nút “Nhắn tin" trên Official Account, hệ thống Zalo sẽ gửi một request HTTP đến Webhook Url đã đăng ký của ứng dụng. Sự kiện này chỉ gửi 1 lần / 1 user / 1 OA và user đó chưa từng có lịch sử chat với OA. Sau khi người dùng nhấn nút “Nhắn tin" thì OA có thể gửi tin nhắn chủ động đến người dùng đó.

URL: Webhook Url của ứng dụng
Method: POST
Content Type: application/json
X-ZEvent-Signature: mac = sha256(appId + data + timeStamp + OAsecretKey), với data là chuỗi json trả về dưới đây.

Ví dụ

{
    "app_id": "834173419644127119",
    "event_name": "user_click_chatnow",
    "oa_id": "3970966762224483791",
    "user_id": "8309215952164870311",
    "user_id_by_app": "9028998061845239436",
    "timestamp": "1636707354448"
}

Mô tả thuộc tính

Thuộc tính	Kiểu dữ liệu	Mô tả
oa_id	String	Official Account Id mà user đã click chat ngay
user_id	String	Id của User nhất nút nhắn tin Official Account
user_id_by_app	String	Trường này chỉ có khi app_id và oa_id trên đang liên kết với nhau. Id này có thể sử dụng cho social_api
event_name	String	Thuộc tính xác định loại event.
app_id	String	Id của ứng dụng bên thứ 3
timestamp	String	Thời điểm request được gửi, tính bằng milisecond

Ví dụ​

Mô tả thuộc tính​

Ví dụ

Mô tả thuộc tính