Button (Nút)
Button là một thành phần tương tác (interactive component).
Nó tạo ra các nút có thể nhấn, cho phép người dùng tương tác trực tiếp, và khi được bấm thì bot sẽ nhận sự kiện tương tác (interaction), để bot phản hồi.
Button có thể trả về 2 loại phản hồi:
- Phản hồi bình thường: Bot trả về một phản hồi dạng BucketScript
- Phản hồi biểu mẫu (form): Bot yêu cầu người dùng điền vào một biểu mẫu, sau đó gửi dữ liệu đến kênh được chỉ định
Button có thể được sử dụng trong:
- Tin nhắn thường với BucketScript
- Layout mới (Component v2)
- Autoresponder
- Sticky Message
- Greeting/Farewell Message
Lệnh quản lí Button
/buttons
- Quản lí Button
Mở giao diện quản lí các nút (button) trong server
Ví dụ sử dụng
-
Mở giao diện quản lí button:
/buttons -
Thêm button mới: Bấm nút
➕ Thêm
- Chọn loại button (phản hồi bình thường hoặc biểu mẫu)
- Nhập thông tin button:
- ID Button: Tên định danh (chỉ chữ cái thường, số, dấu gạch _)
- Tên hiển thị: Chữ hiển thị trên button
- Emoji: Emoji cho button (không bắt buộc)
- Màu: Chọn màu cho button
- Phản hồi/Form: Nội dung phản hồi hoặc chọn form
Để chỉnh sửa button: Chọn button từ dropdown và chỉnh sửa
Để Xóa button: Bấm nút ➖ Xóa
và chọn button cần xóa
Sử dụng Button trong tin nhắn
Với BucketScript
Sử dụng function {button:tên_button}
để thêm button vào tin nhắn:
{button:support_ticket,report_bug}
Bạn có thể thêm nhiều button, bằng cách ngăn nhau bằng dấu phẩy: {button:button1,button2,button3,...}
Với Layout (Component v2)
- Tạo layout qua
/layout create
- Thêm button vào layout thông qua giao diện quản lí
- Sử dụng
{layout:tên_layout}
trong tin nhắn
Với Autoresponder
-
Tạo button qua
/buttons
-
Tạo autoresponder:
/autoresponder add trigger:help ignorecase:True -
Trong phản hồi, sử dụng:
Cần hỗ trợ? Bấm nút bên dưới nhé! {button:support_ticket}
Ví dụ thực tế
Button hỗ trợ đơn giản
Cấu hình:
- ID:
support
- Tên hiển thị:
Hỗ trợ
- Emoji:
🎫
- Màu: Xanh lá
- Phản hồi:
Đã gửi yêu cầu hỗ trợ! Staff sẽ liên hệ bạn sớm.
Button với Form
Cấu hình:
- ID:
report_bug
- Tên hiển thị:
Báo lỗi
- Emoji:
🐛
- Màu: Đỏ
- Form: Chọn form đã tạo từ
/forms
Button URL
Để tạo button dẫn đến link, chỉ cần đặt URL làm phản hồi:
- Phản hồi:
https://bot.tudubucket.dev/
Bot sẽ tự hiểu và tạo button dẫn link thay vì gửi tin nhắn.
Khác biệt với Select
Tính năng | Button | Select |
---|---|---|
Số lượng tối đa/server | 10 | 3 |
Số lựa chọn/component | 1 | 15 |
Hiển thị | Luôn hiện | Thu gọn trong select |
Phù hợp cho | Hành động đơn giản | Nhiều lựa chọn phân loại |
URL support | Có | Không |