Cấu trúc tham số buttons
* Tính năng chỉ hiển thị trên Zalo Mobile
- type: JSON Array
Hiện tại Zalo API hỗ trợ tối đa 5 button .
Example request
{
"recipient": {
"user_id": "2440805291994947133"
},
"message": {
"text": "Tin nhắn đính kèm button",
"attachment": {
"type": "template",
"payload": {
"buttons": [
{
"title": "OPEN URL",
"payload": {
"url": "https://developers.zalo.me/"
},
"type": "oa.open.url"
},
{
"title": "QUERY SHOW",
"type": "oa.query.show",
"payload": "#callback_data"
},
{
"title": "QUERY HIDE",
"type": "oa.query.hide",
"payload": "#callback_data"
},
{
"title": "OPEN SMS",
"type": "oa.open.sms",
"payload": {
"content": "alo",
"phone_code": "84919018791"
}
},
{
"title": "OPEN PHONE",
"type": "oa.open.phone",
"payload": {
"phone_code": "84919018791"
}
}
]
}
}
}
}
Cấu trúc tham số button
Tham số | Kiểu dữ liệu | Mô tả |
|---|---|---|
title | String | Tiêu đề của button |
type | String | Loại action sẽ thực hiện khi người dùng bấm vào |
payload | Dữ liệu của action. Cấu trúc của payload phải phù hợp với từng loại action và đư ợc cho ở bảng bên dưới |
Cấu trúc payload cho các loại action được hỗ trợ
Giá trị type | Kiểu dữ liệu của payload | Giá trị payload và kết quả khi người dùng bấm vào |
|---|---|---|
oa.open.url | String | Data là một Url sẽ được mở trong ứng dụng Zalo khi người dùng bấm vào button. Ví dụ:
|
oa.query.show | String | Data là một chuỗi ký tự ví dụ “#callback_data”. Khi người dùng bấm vào button, hệ thống sẽ gửi một tin nhắn có nội dung chứa trong data từ người dùng đến Official Account. Tin nhắn này sẽ hiện trên cửa sổ chat trên máy của người dùng. Ví dụ:
|
oa.query.hide | String | Data là một chuỗi ký tự ví dụ “#callback_data”. Khi người dùng bấm vào button, hệ thống sẽ gửi một tin nhắn có nội dung chứa trong data từ người dùng đến Official Account. Tin nhắn này sẽ bị ẩn trên cửa sổ chat trên máy của người dùng. Ví dụ:
|
oa.open.sms | json object | Data đối tượng json chứa 2 thuộc tính “content” và “phoneCode”. Ví dụ: Khi người dùng click vào button, cửa sổ sms trên điện thoại của người dùng sẽ được mở với 2 thông tin sẵn có là phone code và nội dung tin nhắn trong data.
|
oa.open.phone | Json Object | Data số điện thoại sẽ nhập vào khi bật ứng dụng gọi điện, ví dụ: Khi người dùng click vào button, cửa sổ call trên điện thoại của người dùng sẽ được mở với thông tin sẵn có là phone number trong data.
|