Bỏ qua nội dung

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

  1. Mở giao diện quản lí button:

    /buttons
  2. 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:

BucketScript
{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)

  1. Tạo layout qua /layout create
  2. Thêm button vào layout thông qua giao diện quản lí
  3. Sử dụng {layout:tên_layout} trong tin nhắn

Với Autoresponder

  1. Tạo button qua /buttons

  2. Tạo autoresponder:

    /autoresponder add trigger:help ignorecase:True
  3. 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ăngButtonSelect
Số lượng tối đa/server103
Số lựa chọn/component115
Hiển thịLuôn hiệnThu gọn trong select
Phù hợp choHành động đơn giảnNhiều lựa chọn phân loại
URL supportKhông