Bỏ qua nội dung

Form (Biểu mẫu)

Form (Biểu mẫu) là một hệ thống thu thập thông tin cho phép bạn tạo các modal với câu hỏi tùy chỉnh để thu thập dữ liệu từ người dùng.

Khi người dùng hoàn tất việc điền form, bot sẽ gửi dữ liệu đã thu thập đến kênh được chỉ định trước với định dạng embed đẹp mắt.

Form có thể được sử dụng với:

  • Button: Tạo nút để mở form khi bấm
  • Select: Tạo lựa chọn để mở form khi chọn

Lệnh quản lí Form

/forms

Mở giao diện quản lí các biểu mẫu (form) trong server

Ví dụ sử dụng

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

    /forms
  2. Thêm form mới: Bấm nút ➕ Thêm

    • Nhập thông tin form:
      • ID Form: Tên định danh (chỉ chữ cái thường, số, dấu gạch _)
      • Tiêu đề: Tiêu đề hiển thị của form
      • Miêu tả form: Mô tả ngắn về form
      • Kênh trả form: Kênh nhận dữ liệu khi form được gửi
      • Tin nhắn: Tin nhắn kèm theo khi gửi dữ liệu
  3. Thêm câu hỏi: Sau khi tạo form, chọn form và bấm ➕ Thêm câu hỏi

    • Nhập thông tin câu hỏi:
      • Nội dung: Câu hỏi hiển thị
      • Miêu tả: Placeholder cho ô trả lời (không bắt buộc)
      • Câu trả lời có dài không: Chọn loại ô nhập (ngắn/dài)
      • Bắt buộc: Có bắt buộc trả lời hay không

Sau khi form được tạo hoàn tất, bạn có thể:

  • Chỉnh sửa form: Chọn form từ dropdown và bấm ✏️ Tiêu đề/miêu tả
  • Chỉnh sửa câu hỏi: Chọn câu hỏi từ dropdown “Chọn câu hỏi cần sửa”
  • Xóa câu hỏi: Chọn câu hỏi từ dropdown “Xóa một câu hỏi”
  • Xóa form: Bấm nút ➖ Xóa và chọn form cần xóa

Sử dụng Form với Button/Select

Với Button

  1. Tạo form qua /forms

  2. Tạo button qua /buttons và chọn loại “Trả biểu mẫu”

  3. Chọn form đã tạo từ danh sách

  4. Sử dụng button trong tin nhắn:

    {button:report_form}

Với Select

  1. Tạo form qua /forms

  2. Tạo select qua /bucketscript selects

  3. Thêm lựa chọn và chọn loại “Trả biểu mẫu”

  4. Chọn form đã tạo từ danh sách

  5. Sử dụng select trong tin nhắn:

    {select:support_category}

Với Autoresponder

  1. Tạo form và button/select như trên

  2. Tạo autoresponder:

    /autoresponder add trigger:report ignorecase:True
  3. Trong phản hồi, sử dụng:

    Báo cáo vấn đề: {button:report_form}

Ví dụ thực tế

Form báo cáo lỗi

Cấu hình Form:

  • ID: bug_report
  • Tiêu đề: Báo cáo lỗi
  • Miêu tả: Báo cáo lỗi trong bot
  • Kênh trả form: #reports
  • Tin nhắn: 🐛 Đã nhận được báo cáo lỗi mới!

Câu hỏi:

  1. Mô tả lỗi

    • Miêu tả: Mô tả chi tiết lỗi bạn gặp phải
    • Loại: Dài (paragraph)
    • Bắt buộc: Có
  2. Cách tái hiện

    • Miêu tả: Các bước để tái hiện lỗi
    • Loại: Dài (paragraph)
    • Bắt buộc: Có
  3. Discord ID

    • Miêu tả: ID Discord của bạn
    • Loại: Ngắn (short)
    • Bắt buộc: Không

Form đăng ký sự kiện

Cấu hình Form:

  • ID: event_register
  • Tiêu đề: Đăng ký sự kiện
  • Miêu tả: Đăng ký tham gia sự kiện server
  • Kênh trả form: #event-registrations
  • Tin nhắn: 🎉 Có người đăng ký sự kiện mới! {user_mention}

Lưu ý quan trọng


Khác biệt với Button/Select

Tính năngButton/SelectForm
Chức năngPhản hồi tức thìThu thập thông tin
Tương tácMột lần bấm/chọnĐiền nhiều câu hỏi
Dữ liệuPhản hồi cố địnhDữ liệu từ user
Kết quảTin nhắn phản hồiGửi về kênh chỉ định
Sử dụngHành động đơn giảnThu thập thông tin chi tiết