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
-
Mở giao diện quản lí form:
/forms -
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
- Nhập thông tin form:
-
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
- Nhập thông tin câu hỏi:
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
-
Tạo form qua
/forms
-
Tạo button qua
/buttons
và chọn loại “Trả biểu mẫu” -
Chọn form đã tạo từ danh sách
-
Sử dụng button trong tin nhắn:
{button:report_form}
Với Select
-
Tạo form qua
/forms
-
Tạo select qua
/bucketscript selects
-
Thêm lựa chọn và chọn loại “Trả biểu mẫu”
-
Chọn form đã tạo từ danh sách
-
Sử dụng select trong tin nhắn:
{select:support_category}
Với Autoresponder
-
Tạo form và button/select như trên
-
Tạo autoresponder:
/autoresponder add trigger:report ignorecase:True -
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:
-
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ó
- Miêu tả:
-
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ó
- Miêu tả:
-
Discord ID
- Miêu tả:
ID Discord của bạn
- Loại: Ngắn (short)
- Bắt buộc: Không
- Miêu tả:
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ăng | Button/Select | Form |
---|---|---|
Chức năng | Phản hồi tức thì | Thu thập thông tin |
Tương tác | Một lần bấm/chọn | Điền nhiều câu hỏi |
Dữ liệu | Phản hồi cố định | Dữ liệu từ user |
Kết quả | Tin nhắn phản hồi | Gửi về kênh chỉ định |
Sử dụng | Hành động đơn giản | Thu thập thông tin chi tiết |