Hệ thống Autoresponder (Phản hồi tự động)

Autoresponder (AR) giúp bot tự trả lời khi có người gõ một từ khóa: câu chào, bảng giá, hướng dẫn, hoặc thẻ hồ sơ của player.

Quyền hạn yêu cầu: Supporter trở lên. Lệnh chính: b.autoresponder (viết tắt b.ar). Gõ b.ar để mở bảng trợ giúp có nút bấm.

Trang này hướng dẫn tạo autores và lên profile bằng lệnh nhập tay. Để player điền thông tin và ảnh theo mẫu có sẵn, xem Hồ sơ Player → Wizard.

Profile tạo bằng form cũng có trong b.ar list và dùng được với b.ar set <tên> | <@user>. Nếu profile hoạt động đã tạo trước đây còn thiếu trong danh sách, chạy b.ar list hoặc gán trực tiếp bằng b.ar set để bổ sung. Profile tạm ẩn không trả lời qua autores; xóa bằng b.ar delete hoặc /player-profile delete sẽ xóa cả hồ sơ và phản hồi cùng tên.

1. Chọn Hướng Dẫn Theo Nhu Cầu

Ba hướng dẫn dưới đây độc lập; chọn mục đúng với kết quả bạn cần:

Chọn Prefix trên thanh điều hướng để các lệnh dùng tiền tố máy chủ bạn. Gửi từng lệnh riêng và chờ bot báo thành công. Từ khóa gọi autores như moonu, ere1, moonu-anh không cần prefix.

1. Chỉ Ping

Tạo một autores có từ khóa moonu và nội dung trả lời là mention của Moonu:

b.ar add moonu | @moonu

Khi nhập lệnh, gõ @ và chọn đúng tài khoản Moonu trong danh sách Discord để tạo mention thật. Không chỉ dán chữ @moonu.

Sau khi bot báo tạo thành công, gửi một tin nhắn mới chỉ có:

moonu

Kết quả: bot trả lời bằng mention @moonu. Autores mới mặc định khớp chính xác, nên hãy gửi đúng từ khóa để thử. Đến đây là xong nếu chỉ cần ping; không cần gắn player bằng set hay thêm ảnh.

2. Lên Profile Bằng Lệnh

Dùng lại ví dụ Asteron, loại hồ sơ ere, trong hướng dẫn wizard. Ở đây Supporter tự chọn tên ere1, nhập phần giới thiệu đã điền sẵn và dùng b.ar set để gắn tài khoản Asteron thay cho việc để player nhập form. Lệnh set gắn player với hồ sơ; nội dung và ảnh được đặt bằng các lệnh riêng bên dưới. Mỗi khối lệnh là một tin nhắn riêng; chờ bot báo thành công rồi làm bước tiếp theo.

Trước khi bắt đầu:

• Chọn Prefix trên thanh điều hướng để các ví dụ dùng tiền tố máy chủ bạn.
• ere là loại hồ sơ, ere1 là tên để gọi hồ sơ, còn Asteron là tên player. Khác với wizard tự cấp số, bạn chọn số còn trống; nếu dùng số khác thì sửa cả tên hồ sơ và số trong mẫu giới thiệu bên dưới.
• Gửi b.ar list để kiểm tra ere1 còn trống. Nếu tên đã thuộc hồ sơ khác, chọn tên mới. Nếu đang sửa đúng hồ sơ có sẵn của Asteron thì bỏ qua bước tạo, hoặc dùng b.ar edit ere1.
• Giữ dấu | trong các ví dụ có dấu này. Không sao chép các tiêu đề bước vào tin nhắn.

Bước 1: Tạo autores nếu chưa có

b.ar add ere1 | @Asteron

Chọn mention thật của Asteron trong danh sách Discord. Phần sau dấu | là văn bản ngoài thẻ; phần giới thiệu bên trong thẻ được đặt ở bước 3. Ví dụ này bắt đầu từ tên mới, không cần làm hướng dẫn chỉ ping trước đó.

Bước 2: Gắn autores cho đúng player

b.ar set ere1 | @Asteron

Gõ @, nhập tên Asteron rồi chọn đúng tài khoản trong danh sách Discord hiện ra. Không chỉ dán chữ @Asteron rồi gửi. Kiểm tra thông báo của bot đã gắn ere1 cho đúng người. Ghi mention trong content chỉ quyết định dòng bot trả lời; lệnh set mới gắn tài khoản player với hồ sơ.

Bước 3: Viết phần giới thiệu trên thẻ

b.ar desc ere1 | # <:emoji_366:1559978833648812072> 𝐄𝐫𝐞𝐧 𝟏 <:emoji_366:1559978833648812072>
# <:emoji_369:1559983267430666330> *Asteron*

<a:2whitebuom:1438237893955948545> *Nơi ở: Hà Nội*
<a:2whitebuom:1438237893955948545> *Thích chơi game cùng bạn*
<a:2whitebuom:1438237893955948545> *Game: Valorant*
<a:2whitebuom:1438237893955948545> *Cam: Deal*

Gửi toàn bộ khối trên trong một tin nhắn. Trên Discord máy tính, nhấn Shift + Enter để xuống dòng, nhấn Enter khi đã nhập xong để gửi. Đây là nội dung đã điền từ ví dụ wizard; lệnh desc không tự áp dụng Bio Template hay thay {name}, {info}, {number.fancy}. Thay tên, số, thông tin và emoji bằng mẫu của máy chủ bạn.

Lệnh b.ar desc thay toàn bộ phần giới thiệu hiện tại. Khi sửa lại sau này, hãy nhập đầy đủ những dòng muốn giữ.

Bước 4: Thêm ảnh chính

b.ar iurl ere1

Gõ lệnh nhưng chưa gửi. Bấm dấu + cạnh ô chat để chọn ảnh, kiểm tra ảnh đính kèm đã xuất hiện cùng lệnh, rồi gửi. Lệnh và ảnh phải nằm trong cùng một tin nhắn; không gửi ảnh thành tin nhắn tiếp theo.

Bot cập nhật ảnh lớn của hồ sơ. Cách tải ảnh trực tiếp này không cần lấy link ảnh.

Bước 5: Thêm ảnh đại diện và album (tùy chọn)

Ảnh đại diện nhỏ:

b.ar turl ere1

Thêm ảnh vào album để khách lật xem:

b.ar addpic ere1

Với mỗi lệnh, đính kèm ảnh cùng tin nhắn chứa lệnh, như bước 4. Có thể bỏ qua bước này nếu chỉ cần ảnh chính.

Bước 6: Xem hồ sơ vừa tạo

Gửi riêng tên hồ sơ trong kênh được server cho phép gọi hồ sơ:

ere1

Bot hiện hồ sơ với giới thiệu và ảnh vừa nhập. Các nút Book / Donate chỉ xuất hiện khi server bật tính năng tương ứng. Gửi b.ar view ere1 nếu muốn kiểm tra thông tin và album.

Nếu chưa làm được:

3. Gọi Autores Có Ảnh + Ping

Ví dụ độc lập này dùng từ khóa moonu-anh để bot gửi ảnh kèm ping Moonu, không cần lên hồ sơ player.

Bước 1: Tạo từ khóa và nội dung ping

b.ar add moonu-anh | @moonu

Gõ @ rồi chọn đúng tài khoản Moonu trong danh sách Discord. Nếu từ khóa đã tồn tại và là autores bạn muốn sửa, dùng b.ar content moonu-anh | @moonu để đặt lại nội dung thay vì tạo mới.

Bước 2: Thêm ảnh

Có hai cách tùy kết quả bạn muốn:

Đặt ảnh lớn bằng iurl:

b.ar iurl moonu-anh <link-ảnh-Discord>

Thay <link-ảnh-Discord> bằng link ảnh đã tải lên Discord, không gõ dấu < >. Hoặc gõ b.ar iurl moonu-anh, đính kèm file ảnh rồi gửi lệnh và ảnh trong cùng tin nhắn. Nội dung @moonu vẫn được giữ; khi gọi moonu-anh, bot gửi mention cùng phần ảnh đã đặt.

Để mention và link ngay trong nội dung trả lời:

b.ar content moonu-anh | @moonu <link-ảnh-Discord>

Chọn lại mention thật và thay phần link bằng link ảnh của bạn. Lệnh content thay toàn bộ nội dung trả lời; nó không đặt ảnh lớn hoặc thêm ảnh vào album như iurl / addpic. Discord có thể hiện bản xem trước của link tùy quyền và cài đặt. Bạn cũng có thể tạo mới ngay từ đầu bằng b.ar add moonu-anh | @moonu <link-ảnh-Discord> nếu từ khóa chưa tồn tại.

Ảnh đặt qua iurl, turl, addpic chỉ nhận file tải lên Discord hoặc link ảnh Discord CDN.

Bước 3: Gọi thử autores

Gửi một tin nhắn mới chỉ có:

moonu-anh

Kết quả: bot gửi mention Moonu kèm ảnh đã đặt. Dùng b.ar view moonu-anh để xem các phần đã lưu. Đến đây là xong; không cần chạy b.ar set nếu chỉ muốn ảnh + ping.

Ví Dụ Khác: Tin Hỗ Trợ Và Lời Chào

Muốn từ khóa xuất hiện ở đâu trong tin cũng được, dùng b.ar matchmode sup | includes. Chỉ muốn trả lời khi tin nhắn đúng bằng từ khóa thì giữ exact. Xem các chế độ khớp và biến tự động bên dưới.

Ví Dụ: Sửa Hồ Sơ Đã Tạo Bằng Form Hoặc b.ar

Hồ sơ tạo bằng form vẫn sửa bằng b.ar được, không cần tạo lại. Ví dụ bot đã cấp tên hồ sơ l51:

b.ar edit l51

Bấm phần cần sửa trên bảng, nhập nội dung rồi gửi biểu mẫu. Kiểm tra thẻ xem trước và bấm Lưu thay đổi trong vòng 3 phút. Gửi biểu mẫu chưa phải là lưu hồ sơ.

Nếu chỉ đổi ảnh chính, gửi b.ar iurl l51 kèm ảnh mới trong cùng tin nhắn. Các lệnh sửa nhanh như b.ar desc, b.ar iurl, b.ar turl lưu ngay khi bot báo thành công.

Quên tên hồ sơ của Moonu? Gửi b.pp list @moonu, chọn đúng tài khoản Discord. Nếu form cấp tên khác l51, dùng đúng tên đó trong các lệnh sửa. Hướng dẫn tạo mới bằng form nằm ở Hồ sơ Player → Wizard.

2. Chỉnh Sửa (b.ar edit)

Hệ thống hỗ trợ 2 cách chỉnh sửa: qua giao diện nút bấm tương tác (Live Preview) hoặc câu lệnh trực tiếp (CLI).

Sửa Có Xem Trước (Components V2)

b.ar edit <tên>

Bot gửi bản xem trước kèm bảng điều khiển Components V2 gồm các nút: Nội dung, Tiêu đề, Mô tả, Màu sắc, Thumbnail, Ảnh lớn. Mỗi nút mở một Modal để nhập dữ liệu; bản xem trước tự động cập nhật ngay lập tức. Bấm Lưu thay đổi để lưu hoặc Hủy để bỏ.

Phiên chỉnh sửa tương tác tự động hết hạn sau 3 phút. Xem trước chưa phải là đã lưu; bạn bắt buộc phải bấm Lưu thay đổi.

Sửa Nhanh Một Dòng (CLI)

b.ar content <tên> | <nội dung văn bản>
b.ar title <tên> | <tiêu đề>
b.ar desc <tên> | <mô tả>
b.ar color <tên> | <mã màu hex, ví dụ #5865F2>
b.ar iurl <tên> | <link ảnh lớn hoặc file đính kèm>
b.ar turl <tên> | <link ảnh nhỏ hoặc file đính kèm>

• Xóa giá trị một trường: Để trống phần sau dấu | (ví dụ: b.ar title <tên> |) để xóa tiêu đề hoặc màu.
• Quy tắc ảnh: Chỉ chấp nhận ảnh tải lên Discord hoặc link từ Discord CDN (cdn.discordapp.com).
• Hệ thống tự động phân biệt và đồng bộ giữa Autoresponder thông thường và Player Profile.

Thay Ảnh Trong Album

b.ar replacepic adm1 2

Gửi kèm một hoặc nhiều ảnh trong cùng tin nhắn, hoặc nhập nhiều link attachment Discord sau số thứ tự. Ảnh mới đầu tiên thay ảnh số 2; ảnh mới còn lại chèn ngay sau đó. Các ảnh cũ phía sau được giữ nguyên.

Ví dụ [A, B, C, D], thay số 2 bằng [X, Y] thành [A, X, Y, C, D]. Thay số 1 đồng thời đổi ảnh chính. Lệnh lưu ngay và chỉ tác động đúng tên đã nhập.

Tên có khoảng trắng dùng b.ar replacepic tên dài | 2. Xem số thứ tự bằng b.ar view adm1. Chỉ nhận file/link attachment Discord; ảnh mới trùng nhau được gộp, ảnh trùng vị trí khác trong album sẽ bị từ chối để giữ nguyên thứ tự cũ. Quyền Supporter trở lên.

Với player profile, cũng có thể dùng b.pp photo replace adm1 2 hoặc slash /player-profile photo action:replace name:adm1 position:2. Xem hướng dẫn ảnh profile.

3. Bảng Lệnh Quản Trị & Chế Độ Khớp

Các Chế Độ Khớp Từ Khóa (matchmode)

Lệnh b.ar matchmode <tên> | <chế độ> quyết định cách bot phát hiện từ khóa trong tin nhắn:

• exact: Khớp chính xác hoàn toàn (tin nhắn chỉ chứa đúng từ khóa, không thêm từ khác).
• includes: Khớp nếu tin nhắn chứa từ khóa ở bất kỳ vị trí nào.
• startsWith: Khớp nếu tin nhắn bắt đầu bằng từ khóa.
• endsWith: Khớp nếu tin nhắn kết thúc bằng từ khóa.

Sửa Hàng Loạt Bằng b.ar replace

b.ar replace <tiền tố> <tìm> | <thay thế> [trường]

• Thay thế hàng loạt emoji (kể cả emoji từ server khác), văn bản, title, bio hoặc color theo nhóm tiền tố profile (ví dụ: b.ar replace adm :star: | :heart: hoặc b.ar replace adm color #FF5733).
• Thêm line:<dòng> để chỉ thay trong dòng chỉ định (ví dụ: b.ar replace adm line:1 :star: | :heart: hoặc line:2-3).
• An toàn: Bot hiển thị bản xem trước Cũ / Mới của 1-2 profile đầu tiên; chỉ khi bạn bấm Áp dụng thì thay đổi mới được lưu vào database.

b.ar show <tiền tố> gửi các hồ sơ theo tiền tố. Màu profile dùng cùng cấu hình khi gọi trực tiếp: màu nhóm khi bật kế thừa, màu riêng khi tắt kế thừa, rồi màu server nếu chưa đặt. Không cần đặt lại màu sau khi dùng b.ar show.

4. Danh Sách Biến Tự Động (Placeholders)

Trong nội dung tin nhắn của Autoresponder, bạn có thể chèn các biến đặt trong dấu ngoặc nhọn {}. Khi bot trả lời, biến sẽ tự động được thay thế bằng thông tin thực tế:

Lưu và khôi phục ảnh

Khi bật Sao Lưu Ảnh Autores trong Anti-Raid và bot đã có kho lưu trữ, ảnh Discord của autores/hồ sơ được sao lưu và chuyển vào kênh riêng tư <tên bot>-media trước khi lệnh báo thành công. Bot cần quyền Manage Channels để tạo kênh, cùng quyền xem, gửi tin, đính kèm file và đọc lịch sử trong kênh đó. Không xoá kênh hoặc tin nhắn lưu ảnh. Thiếu quyền hay tải lên lỗi thì lệnh vẫn lưu link gốc; bạn nên giữ tin nhắn gốc và kiểm tra cảnh báo trong b.ar list.

Bot tự khôi phục ảnh có bản sao khi cần hiển thị hoặc trong lượt quét hằng ngày. Ảnh đã mất mà không có bản sao được bỏ khỏi tin nhắn gửi; b.ar list hiện N ảnh hỏng, cần tải lại. Hãy tải lại ảnh đó cho autores/hồ sơ. Xoá autores hoặc bỏ ảnh sẽ xoá cả tin nhắn kho và bản sao khi không còn autores, hồ sơ hoặc Star nào dùng chung ảnh. Chỉ ảnh tối đa 10 MB được sao lưu; video không được lưu, dung lượng dùng chung hạn mức 1 GB mỗi server với file Anti-Raid.