Discord에서의 Ally 흐름
Ally 파이프라인은 파트너 길드 멤버가 Discord에서 Ally로 신청하는 정식 방법입니다. 구조적으로 참가 신청 흐름의 쌍둥이입니다 — 지원자가 한 번 클릭하면 비공개 검토 티켓이 열리고, 리뷰어가 짧은 마법사를 통해 신청 캐릭터를 확인하며, 닫힐 때 보관 기록이 포럼에 저장됩니다.
이 페이지는 파이프라인 전체를 각 역할의 관점에서 설명합니다 — 설정하는 길드장, 버튼을 클릭하는 Ally 지원자, 슬래시 명령어를 실행하는 리뷰어. 구조는 참가 신청과 매우 유사하며, 끝 가까이의 참가 신청과의 차이점 섹션에서 Ally에만 있는 항목을 설명합니다.
사전 조건
- 봇이 AO Master 길드에 연결되어 있어야 합니다 — 설치 + 연결 참조.
- 길드가 Pro 티어 이상이어야 합니다 (얼라이언스 파이프라인은 티어 제한이 있습니다).
- 설정하는 사람이 Discord 서버 소유자이거나 AO Master에서 Manage Integrations 권한을 보유해야 합니다.
- "리뷰어" 역할을 할 Discord 역할이 하나 존재해야 합니다 — 해당 역할이 있는 모든 사람이 티켓에서 행동할 수 있습니다. 없으면 Discord에서 먼저 만드세요.
1. 길드장 — Ally 허브 설정
Ally 허브는 참가 신청과 동일한 #⚙️-guild-settings 채널에서 프로비저닝됩니다. 고정된 Guild Settings 메시지의 첫 번째 행에는 이제 4개의 버튼이 있습니다: [🔍 View Config] [🎯 Manage Enlist] [💰 Manage Regear] [🤝 Enable Ally].
초록색 🤝 Enable Ally 버튼을 클릭합니다. "Not set up" 상태와 단일 작동 버튼 — ⚙ Setup — 이 있는 임시 패널이 나타납니다.
설정 마법사 (2단계)
마법사는 참가 신청 설정과 동일한 구조입니다 (참가 신청 흐름의 동일한 2단계 패턴):
- 리뷰어 Discord 역할 선택 — 라이브 멤버 수와 함께 서버의 Discord 역할 다중 선택 드롭다운. 마법사는
@everyone및 관리 봇 역할을 거부합니다. 선택된 역할 중 하나를 가진 모든 사람이 Ally 티켓을 보고/ally review//ally reject//ally done을 실행할 수 있습니다. - 확인 — 생성될 항목 목록이 있는 짧은 확인 카드:
#🤝-ally-here채널 +🤝 Ally카테고리, 그리고 고정된[Apply as Ally]버튼. ✅ Confirm을 클릭합니다.
약 5초 후 패널이 전체 Manage Ally 대시보드로 다시 렌더링됩니다.
Manage Ally 대시보드
설정 후 패널은 하단에 Ally 전용 추가 항목이 있는 Manage Enlist 대시보드를 미러링합니다. 버튼 포함:
- ⚙ Reconfigure — 리뷰어 역할 선택기를 다시 실행합니다.
- ? Edit Questions — Ally 지원자에게 물어볼 지원 질문을 변경합니다. (공유 편집기; 동일한 질문이 web
/ally/<code>페이지에도 표시됩니다.) - 📝 Edit Template / ✏️ Edit Ally Message / ✏️ Edit Ticket Message / ✏️ Edit Ally Button — 고정 메시지 본문, 각 티켓 내부 환영 메시지, 버튼 레이블을 커스터마이즈합니다.
- 📋 Map Ally Channel / 📂 Map Ticket Category — 자동 생성된 것 대신 기존 Discord 채널/카테고리로 고정 버튼 또는 새 티켓을 지정합니다.
- 🚫 Pause Ally — 새 지원자 접수를 중지하되 진행 중인 티켓은 열어 둡니다.
- 🔄 Refresh Pinned —
#🤝-ally-here의 고정된[Apply as Ally]메시지를 다시 렌더링합니다. - 🎮 Auto-Name: OFF / ON — 승인 시 Discord 닉네임 변경을 토글합니다 (기본값 ON).
- 🔧 Rebuild — 모든 대기 중인 Ally 지원자를 자동 거부 +
#🤝-ally-here채널과🤝 Ally카테고리를 초기화하고 새로 재생성합니다. 리뷰어 역할과 메시지 커스터마이즈는 유지됩니다. - 🗑 Disable Ally — 전체 Ally Discord 측 구성을 초기화합니다. Discord 채널은 그대로 유지되지만 관리되지 않게 됩니다. 설정을 다시 실행하면 되돌릴 수 있습니다.
각 설정은 web의 #Discord 연동 → Integrations → Ally에서도 편집할 수 있습니다 (Discord 연동 참조). 변경사항은 실시간으로 양방향 동기화됩니다.
2. Ally 지원자 — [Apply as Ally] 클릭
길드 외부의 모든 사람에게 🤝 Ally 카테고리 내부에서 볼 수 있는 유일한 채널은 #🤝-ally-here입니다. 고정 메시지에는 [Apply as Ally] 버튼(또는 커스텀 레이블)이 있습니다.
지원자가 버튼을 클릭하면:
- 봇이 Ticket channel name template에 따라 이름 지정된 비공개 채널을 생성합니다 (기본값
🤝-ally-<discord-username>). 지원자와 리뷰어 역할만 볼 수 있습니다. - 봇이 티켓 상단에 Welcome message를 게시합니다 — 호스트의 커스터마이즈된 소개 + 호스트가 설정한 지원 질문.
- 봇이 지원자에게 티켓의 질문에 답변하도록 안내하는 임시 메시지를 보냅니다.
지원자는 일반 Discord 메시지로 답변을 입력합니다. 리뷰어가 티켓에서 해당 메시지를 볼 수 있으며, 답변은 AO Master 데이터베이스에 저장되지 않습니다 (Discord 기록에만 존재합니다).
3. 리뷰어 — /ally review, /ally reject, /ally done
3개의 슬래시 명령어가 전체 리뷰어 측을 커버합니다. 세 가지 모두 Manage Ally 패널에서 설정된 리뷰어 역할이 필요합니다.
/ally review
Ally 티켓 채널 내부에서 실행합니다. 마법사가 열립니다:
- 얼라이언스에서 캐릭터 선택 — 얼라이언스 파트너의 캐릭터 드롭다운. 지원자가 어떤 캐릭터로 신청하는지 선언하며, 리뷰어가 비파트너 길드의 누군가를 실수로 승인하지 않도록 파트너 길드로 범위가 제한됩니다.
- 확인 — 선택된 캐릭터 + 원래 파트너 길드 (Albion API에서 실시간 확인)가 있는 요약 카드. ✅ Confirm을 클릭합니다.
확인 시:
- Ally 행이 AO Master web 측
#Allies에 추가됩니다 (상태: Linked). - 봇이 지원자의 Discord 계정에 AO Ally 역할을 추가합니다 (Ally를 처음 활성화할 때 자동 생성되며, 구성한 Ally Role chip 색상과 일치하는 색상).
- 선택된 소속 길드에 Partner Role 매핑이 있으면 봇이 해당 역할도 부여합니다 (예: "Cozy Chilipi" 출신 지원자는 AO Ally + Cozy Chilipi 역할 모두 받음).
- Auto-Name이 ON이면 봇이 선택된 Albion 캐릭터에 맞게 지원자의 Discord 닉네임을 변경합니다.
/ally reject
리뷰어가 게시할 수 있는 곳 어디서든 실행합니다 (보통 티켓 내부). 사용법:
/ally reject user:@<applicant> reason:<선택적 이유>- 지원자의 대기 중인 참가 요청이 Rejected로 전환됩니다.
- 봇이 지원자에게 이유(또는 생략한 경우 기본 이유)와 함께 DM을 보냅니다.
- 티켓이 즉시 닫힙니다; 기록은 보관되지 않습니다 (거부 닫기는 의도적으로 보관 포럼을 건너뜁니다 — 거부된 티켓은 불필요한 데이터입니다).
/ally done
/ally review로 지원자를 승인한 후 티켓 내부에서 실행합니다. 두 가지가 일어납니다:
- 전체 티켓 대화가 — 원본 작성자 이름 + 아바타 + 모든 첨부 파일 포함 —
🗄-ally-archive포럼 채널의 비공개 포럼 스레드에 미러링됩니다. 포럼과 봇이 사용하는 웹훅은/ally done이 처음 실행될 때 자동 생성됩니다 (한 번도 보관하지 않은 길드에는 빈 포럼이 생기지 않습니다). - 티켓 채널이 삭제됩니다.
보관 스레드 제목은 티켓 채널 이름과 일치하므로 리뷰어가 나중에 사용자명으로 포럼을 검색할 수 있습니다.
4. 참가 신청과의 차이점
두 흐름은 구조적 뼈대를 공유하지만, Ally에는 참가 신청 측에 없는 몇 가지 특이점이 있습니다.
| 항목 | 참가 신청 | Ally |
|---|---|---|
| 티어 제한 | Free 티어 이상 | Pro 티어 이상 |
| 캐릭터 선택기 | Albion 전체 자유 텍스트 검색 | 얼라이언스 로스터 선택기 (파트너 길드로 범위 제한) |
| 승인 시 역할 부여 | 매핑 테이블의 Discord 역할 | AO Ally 보편 역할 + 소속 길드 기반 선택적 Partner Role |
| web에서의 시각적 마커 | 일반 AO Master 역할 | Ally Role chip (레이블 + 색상) |
| web에서의 로스터 채널 | #회원 | #Allies |
| 이탈 감지 크론 | 해당 없음 | 일일 확인; Ally의 소속 길드가 얼라이언스를 떠나면 상태를 Left alliance로 전환 — Ally Role Sync 참조 |
| 슬래시 명령어 | /enlist review, /enlist reject, /enlist done | /ally review, /ally reject, /ally done |
| 기본 고정 채널 | #📋-enlist-here | #🤝-ally-here |
| 티켓 채널 접두사 | 🎯-enlist-… | 🤝-ally-… |
| 보관 포럼 | apply-archive | 🗄-ally-archive |
표에 없는 모든 것은 동일하게 작동합니다 — 동일한 설정 마법사 구조, 동일한 패널 레이아웃, 동일한 보관 기록 흐름, 동일한 일시 중지/재구축/비활성화 의미론.
5. 얼라이언스 기능이 "보류" 상태일 때
얼라이언스는 Pro 티어로 티어 제한됩니다. 길드가 Pro에서 더 낮은 티어로 내려가면 (구독 만료, 다운그레이드), 파이프라인이 보류 모드로 진입합니다:
#⚙️-guild-settings의 🤝 Enable Ally 버튼이 회색[🔒 Alliance — Pro tier needed]상태로 대체됩니다.- 기존 Ally 티켓은 열려 있지만 새 지원자는 신청할 수 없습니다.
- 이탈 감지 크론이 일시 중지됩니다 (티어가 내려갔다고 로스터가 변동되지 않습니다).
- 기존 Ally는 AO Ally 역할과 로스터 행을 그대로 유지합니다.
Pro 티어를 복구하면 파이프라인이 자동으로 활성으로 돌아옵니다 — 재설정이 필요하지 않습니다.
6. Web 측 미러
Manage Ally Discord 패널의 모든 설정은 web의 #Discord 연동 → Integrations → Ally에도 있습니다 (Discord 연동 참조). 교차 표면 설정 (Receive new applicants 토글, Custom apply questions, Ally Role chip)은 Settings → Recruitment (Ally 외부 탭)에 있으며, Discord 연동 Ally 서브 페이지의 Related settings 카드에서도 표시됩니다.
편한 표면을 사용하세요 — 동일한 채널을 통해 실시간으로 동기화됩니다.
관련 링크
- Discord에서의 참가 신청 흐름 — 멤버 측 동등 항목 (전체 Discord 스크린샷 포함; Ally 구조가 이를 미러링합니다).
- Settings → Recruitment — Ally 외부 탭 (지원 질문 + Ally Role chip + 초대 코드).
- Discord 연동 — 연결 상태 허브 (Ally 서브 페이지는 Integrations 탭 아래에 있음).
- #Allies 채널 참조 — 호스트 측 로스터 페이지.
- 멤버 — 얼라이언스 — 지원자 측 관점.
- Discord — 슬래시 명령어 부록 —
/ally review//ally reject//ally done포함 모든 슬래시 명령어 전체 참조.