Skip to content

Luồng Ally trên Discord

Pipeline Ally là cách chính thức để ai đó từ guild đối tác nộp đơn ally trên Discord. Đây là cấu trúc song sinh của Luồng Enlist — một click của applicant mở ticket review riêng tư, reviewer chạy wizard ngắn để xác minh nhân vật nào đang nộp đơn, và transcript lưu trữ được đưa vào forum khi đóng.

Trang này hướng dẫn toàn bộ pipeline từ vị trí của từng vai — chủ guild cài đặt, applicant ally click nút, reviewer chạy slash command. Cấu trúc mirror Enlist chặt chẽ; phần Điểm khác biệt so với Enlist gần cuối nêu bật những gì đặc trưng của Ally.

Yêu cầu trước khi bắt đầu

  • Bot đã được ghép đôi với guild AO Master của bạn — xem Cài đặt + ghép đôi.
  • Guild của bạn đang ở tier Pro trở lên (pipeline Alliance được tier-gate).
  • Người cài đặt là chủ server Discord hoặc có quyền Manage Integrations trong AO Master.
  • Tồn tại một Discord role sẽ đóng vai "reviewer" — bất kỳ ai có role đó có thể xử lý ticket. Tạo một cái trong Discord trước nếu bạn chưa có.

1. Chủ guild — cài đặt hub Ally

Hub Ally được cấp phép từ cùng channel #⚙️-guild-settings như Enlist. Tin nhắn Guild Settings pinned giờ có bốn nút ở hàng đầu: [🔍 View Config] [🎯 Manage Enlist] [💰 Manage Regear] [🤝 Enable Ally].

Click nút 🤝 Enable Ally màu xanh lá. Một panel ephemeral xuất hiện với trạng thái "Not set up" và một nút hoạt động duy nhất — ⚙ Setup.

Wizard cài đặt (2 bước)

Wizard giống hệt về hình thức với cài đặt Enlist (cùng mẫu 2 bước được ghi tại Luồng Enlist):

  1. Chọn Discord role reviewer — dropdown multi-select các Discord role của server kèm số lượng thành viên trực tiếp. Wizard từ chối @everyone và managed bot role. Bất kỳ ai có một trong các role đã chọn sẽ thấy ticket ally và được phép chạy /ally review / /ally reject / /ally done.
  2. Xác nhận — thẻ xác nhận ngắn liệt kê những gì được tạo ra: channel #🤝-ally-here + category 🤝 Ally, cộng với nút [Apply as Ally] pinned. Click ✅ Confirm.

Sau ~5 giây, panel re-render thành dashboard Manage Ally đầy đủ.

Dashboard Manage Ally

Panel sau cài đặt mirror dashboard Manage Enlist với các extra đặc trưng của Ally ở phía dưới. Các nút bao gồm:

  • ⚙ Reconfigure — chạy lại bộ chọn recruiter-role.
  • ? Edit Questions — thay đổi câu hỏi đơn mà applicant ally được hỏi. (Editor dùng chung; cùng câu hỏi hiển thị trên trang web /ally/<code> cũng vậy.)
  • 📝 Edit Template / ✏️ Edit Ally Message / ✏️ Edit Ticket Message / ✏️ Edit Ally Button — tùy chỉnh nội dung tin nhắn pinned, tin nhắn chào mừng trong mỗi ticket, nhãn nút.
  • 📋 Map Ally Channel / 📂 Map Ticket Category — trỏ nút pinned hoặc ticket mới đến Discord channel / category hiện có thay vì các kênh được tạo tự động.
  • 🚫 Pause Ally — ngừng nhận applicant mới nhưng giữ nguyên ticket đang xử lý.
  • 🔄 Refresh Pinned — re-render tin nhắn pinned [Apply as Ally] trong #🤝-ally-here.
  • 🎮 Auto-Name: OFF / ON — toggle đổi tên Discord khi duyệt (mặc định BẬT).
  • 🔧 Rebuild — auto-reject mọi applicant ally đang chờ + xóa channel #🤝-ally-here và category 🤝 Ally + tạo lại mới. Reviewer role + tùy chỉnh tin nhắn được bảo toàn.
  • 🗑 Disable Ally — xóa toàn bộ cấu hình phía Discord của Ally. Channel Discord vẫn còn nhưng trở thành un-managed. Có thể hoàn tác bằng cách chạy lại cài đặt.

Mỗi cài đặt cũng có thể chỉnh trên web tại #Discord Integration → Integrations → Ally (xem Discord Integration). Thay đổi đồng bộ hai chiều trong thời gian thực.


2. Applicant ally — click [Apply as Ally]

Đối với mọi người bên ngoài guild, channel duy nhất họ thấy trong category 🤝 Ally#🤝-ally-here. Tin nhắn pinned có nút [Apply as Ally] (hoặc nhãn tùy chỉnh của bạn).

Khi applicant click nút:

  1. Bot tạo channel riêng tư được đặt tên theo Template tên channel ticket (mặc định 🤝-ally-<discord-username>). Chỉ applicant + reviewer role mới thấy.
  2. Bot đăng Welcome message ở đầu ticket — phần giới thiệu tùy chỉnh của host + bất kỳ câu hỏi đơn nào host đã đặt.
  3. Bot trả lời ephemeral hướng applicant đến trả lời câu hỏi trong ticket.

Applicant gõ câu trả lời dưới dạng tin nhắn Discord thông thường. Reviewer thấy các tin nhắn đó trong ticket; câu trả lời không được lưu trong database AO Master (chúng chỉ tồn tại trong transcript Discord).


3. Reviewer — /ally review, /ally reject, /ally done

Ba slash command bao phủ toàn bộ phía reviewer. Cả ba đều được kiểm soát bởi reviewer role đặt trong panel Manage Ally.

/ally review

Chạy bên trong channel ticket ally. Mở wizard:

  1. Chọn nhân vật từ alliance — dropdown liệt kê các nhân vật từ các guild đối tác của bạn. Applicant khai báo nhân vật nào họ đang nộp đơn; bộ chọn được giới hạn trong các guild đối tác alliance để reviewer không vô tình duyệt ai đó từ guild không phải đối tác.
  2. Xác nhận — thẻ tóm tắt hiển thị nhân vật đã chọn + home guild đối tác của họ (được resolve trực tiếp từ Albion). Click ✅ Confirm.

Khi xác nhận:

  • Dòng ally được thêm vào #Allies trên phía web AO Master (trạng thái: Linked).
  • Bot thêm role AO Ally vào tài khoản Discord của applicant (tự động tạo lần đầu tiên bạn bật Ally; màu sắc khớp với chip Ally Role bạn đã cấu hình).
  • Nếu tồn tại Partner Role mapping cho home guild đã chọn, bot cũng cấp role đó (ví dụ applicant từ "Cozy Chilipi" nhận cả AO Ally + role Cozy Chilipi).
  • Nếu Auto-Name đang BẬT, bot đổi nickname Discord của applicant theo nhân vật Albion đã chọn.

/ally reject

Chạy bất kỳ đâu reviewer có thể đăng (thường bên trong ticket). Cú pháp:

/ally reject user:@<applicant> reason:<lý do tùy chọn>
  • Yêu cầu tham gia đang chờ của applicant chuyển thành Rejected.
  • Bot DM applicant với lý do (hoặc một lý do mặc định nếu bạn bỏ qua).
  • Ticket đóng ngay lập tức; transcript KHÔNG được lưu trữ (việc đóng từ chối bỏ qua forum lưu trữ theo thiết kế — ticket bị từ chối là nhiễu).

/ally done

Chạy bên trong ticket SAU KHI /ally review đã duyệt applicant. Hai điều xảy ra:

  1. Toàn bộ cuộc hội thoại ticket được mirror — với tên tác giả gốc + avatar + mọi file đính kèm — vào forum thread riêng tư bên trong forum channel 🗄-ally-archive. Forum + webhook bot dùng để đăng vào đó được tạo tự động lần đầu tiên /ally done chạy (guild không bao giờ lưu trữ sẽ không có forum rỗng).
  2. Channel ticket bị xóa.

Tiêu đề thread lưu trữ khớp với tên channel ticket để reviewer có thể tìm forum sau theo username.


4. Điểm khác biệt so với Enlist

Hai luồng chia sẻ cùng cấu trúc, nhưng Ally có một số điểm khác biệt không tồn tại phía Enlist:

Khía cạnhEnlistAlly
Tier gateFree tier trở lênPro tier trở lên
Bộ chọn nhân vậtTìm kiếm tự do khắp AlbionBộ chọn roster alliance (giới hạn trong guild đối tác)
Role cấp khi duyệtDiscord role từ bảng mappingRole AO Ally toàn cầu + Partner Role tùy chọn theo home guild
Dấu hiệu trực quan trên webAO Master role thườngChip Ally Role (nhãn + màu sắc)
Channel roster trên web#Members#Allies
Cron đào tẩukhông cóKiểm tra hàng ngày; đổi trạng thái sang Left alliance khi home guild của ally rời alliance — xem Đồng bộ Ally Role
Slash command/enlist review, /enlist reject, /enlist done/ally review, /ally reject, /ally done
Channel pinned mặc định#📋-enlist-here#🤝-ally-here
Tiền tố channel ticket🎯-enlist-…🤝-ally-…
Forum lưu trữapply-archive🗄-ally-archive

Mọi thứ không có trong bảng hoạt động giống nhau — cùng hình thức wizard cài đặt, cùng bố cục panel, cùng luồng transcript lưu trữ, cùng ngữ nghĩa Pause / Rebuild / Disable.


5. Khi tính năng Alliance bị "tạm giữ"

Alliance được tier-gate ở Pro. Nếu guild của bạn tụt từ Pro xuống tier thấp hơn (hết hạn đăng ký, hạ cấp), pipeline vào hold mode:

  • Nút 🤝 Enable Ally trên #⚙️-guild-settings được thay bằng trạng thái xám [🔒 Alliance — Pro tier needed].
  • Ticket ally hiện tại vẫn mở nhưng không có applicant mới nào có thể nộp đơn.
  • Cron đào tẩu tạm dừng (roster của bạn không bị xáo trộn chỉ vì bạn tụt tier).
  • Ally hiện có vẫn giữ role AO Ally và dòng roster.

Khôi phục tier Pro tự động chuyển pipeline về trạng thái hoạt động — không cần cài đặt lại.


6. Bản mirror phía web

Mọi cài đặt trên panel Manage Ally Discord cũng tồn tại tại #Discord Integration → Integrations → Ally trên web (xem Discord Integration). Các cài đặt cross-surface (toggle Nhận applicant mới, Câu hỏi đơn tùy chỉnh, chip Ally Role) nằm tại Settings → Recruitment (tab Ally bên ngoài) và cũng được hiển thị trên trang con Ally của Discord Integration dưới thẻ Cài đặt liên quan.

Chọn bề mặt nào thuận tiện — chúng đồng bộ trong thời gian thực qua cùng một kênh.