Flusso alleato su Discord
La pipeline Alleato è il modo canonico per qualcuno di una gilda partner di fare domanda come alleato su Discord. È il gemello strutturale del Flusso candidatura — un clic del candidato apre un ticket di revisione privato, un revisore esegue una breve procedura guidata per verificare con quale personaggio stanno facendo domanda, e una trascrizione archiviata arriva in un forum alla chiusura.
Questa pagina percorre l'intera pipeline dal posto di ciascun ruolo — owner che la configura, candidato alleato che clicca il pulsante, revisore che esegue i comandi slash. La forma rispecchia da vicino candidatura; la sezione Differenze da candidatura vicino alla fine evidenzia cosa è specifico di Alleato.
Prerequisiti
- Il bot è collegato alla tua gilda AO Master — vedi Installa + collega.
- La tua gilda è al tier Pro o superiore (la pipeline Alleanza è limitata al tier).
- La persona che lo configura è il proprietario del server Discord o detiene il permesso Gestisci integrazioni in AO Master.
- Esiste un ruolo Discord che agirà da "revisore" — chiunque con quel ruolo può agire sui ticket. Creane uno in Discord prima se non ne hai già uno.
1. Owner — configura l'hub Alleato
L'hub Alleato viene provisionato dallo stesso canale #⚙️-guild-settings di candidatura. Il messaggio fissato Guild Settings ha ora quattro pulsanti nella prima riga: [🔍 View Config] [🎯 Manage Enlist] [💰 Manage Regear] [🤝 Enable Ally].
Clicca il pulsante verde 🤝 Enable Ally. Appare un pannello effimero con uno status "Not set up" e un unico pulsante funzionante — ⚙ Setup.
Procedura guidata di configurazione (2 passi)
La procedura guidata è identica nella forma a quella di candidatura (stesso schema a 2 passi documentato su Flusso candidatura):
- Scegli i ruoli Discord revisori — dropdown multi-selezione dei ruoli Discord del tuo server con contatori live dei membri. La procedura guidata rifiuta
@everyonee i ruoli bot gestiti. Chiunque con uno dei ruoli scelti vedrà i ticket alleato e potrà eseguire/ally review//ally reject//ally done. - Conferma — card di conferma breve che elenca cosa viene creato: canale
#🤝-ally-here+ categoria🤝 Ally, più il pulsante fissato[Apply as Ally]. Clicca ✅ Confirm.
Dopo ~5 secondi il pannello si ri-renderizza nel dashboard completo Manage Ally.
Dashboard Manage Ally
Il pannello post-configurazione rispecchia il dashboard Manage Enlist con gli extra specifici di Alleato in fondo. I pulsanti includono:
- ⚙ Reconfigure — esegui nuovamente il selettore ruoli recruiter.
- ? Edit Questions — cambia le domande di candidatura a cui vengono chieste i candidati alleati. (Editor condiviso; le stesse domande appaiono anche sulla pagina web
/ally/<code>.) - 📝 Edit Template / ✏️ Edit Ally Message / ✏️ Edit Ticket Message / ✏️ Edit Ally Button — personalizza il corpo del messaggio fissato, il messaggio di benvenuto dentro ogni ticket, l'etichetta del pulsante.
- 📋 Map Ally Channel / 📂 Map Ticket Category — punta il pulsante fissato o i nuovi ticket a canali / categorie Discord esistenti invece di quelli creati automaticamente.
- 🚫 Pause Ally — smetti di accettare nuovi candidati ma mantieni aperti i ticket in corso.
- 🔄 Refresh Pinned — ri-renderizza il messaggio fissato
[Apply as Ally]in#🤝-ally-here. - 🎮 Auto-Name: OFF / ON — attiva/disattiva la rinomina del nickname Discord all'approvazione (predefinito ON).
- 🔧 Rebuild — auto-rifiuta ogni candidato alleato in attesa + cancella il canale
#🤝-ally-heree la categoria🤝 Ally+ li ricrea da capo. I ruoli revisori + le personalizzazioni dei messaggi sono preservati. - 🗑 Disable Ally — cancella l'intera configurazione lato Discord di Alleato. I canali Discord rimangono ma diventano non gestiti. Reversibile eseguendo nuovamente la configurazione.
Ogni impostazione può anche essere modificata sul web su #Integrazione Discord → Integrations → Alleato (vedi Impostazioni → Integrazione Discord). Le modifiche si sincronizzano in tempo reale in entrambe le direzioni.
2. Candidato alleato — clicca [Apply as Ally]
Per tutti fuori dalla gilda, l'unico canale che possono vedere nella categoria 🤝 Ally è #🤝-ally-here. Il messaggio fissato ha il pulsante [Apply as Ally] (o la tua etichetta personalizzata).
Quando un candidato clicca il pulsante:
- Il bot crea un canale privato nominato secondo il Template nome canale ticket (default
🤝-ally-<discord-username>). Solo il candidato + i ruoli revisori possono vederlo. - Il bot pubblica il Messaggio di benvenuto in cima al ticket — l'intro personalizzata dell'ospitante + le domande di candidatura che l'ospitante ha impostato.
- Il bot risponde con un messaggio effimero che indirizza il candidato a rispondere alle domande nel ticket.
Il candidato digita le sue risposte come normali messaggi Discord. I revisori vedono quei messaggi nel ticket; le risposte non vengono memorizzate nel database AO Master (vivono solo nella trascrizione Discord).
3. Revisore — /ally review, /ally reject, /ally done
Tre comandi slash coprono l'intero lato revisore. Tutti e tre sono limitati ai ruoli revisori impostati nel pannello Manage Ally.
/ally review
Eseguilo dentro un canale ticket alleato. Apre una procedura guidata:
- Scegli personaggio dall'alleanza — un dropdown che elenca i personaggi delle tue gilde partner dell'alleanza. Il candidato dichiara con quale personaggio sta facendo domanda; il selettore è limitato alle gilde partner dell'alleanza così un revisore non può approvare accidentalmente qualcuno di una gilda non partner.
- Conferma — una card di riepilogo mostra il personaggio scelto + la loro gilda partner di origine (risolta in tempo reale dall'API di Albion). Clicca ✅ Confirm.
Alla conferma:
- La riga alleato viene aggiunta a
#Alleatisul lato web AO Master (status: Linked). - Il bot aggiunge il ruolo AO Ally all'account Discord del candidato (creato automaticamente la prima volta che abiliti Alleato; colorato per corrispondere al chip Ally Role che hai configurato).
- Se esiste un mapping Ruolo partner per la gilda di origine scelta, il bot concede anche quel ruolo (es. un candidato da "Cozy Chilipi" ottiene sia AO Ally + un ruolo Cozy Chilipi).
- Se Auto-Name è ON, il bot rinomina il nickname Discord del candidato per corrispondere al personaggio Albion scelto.
/ally reject
Eseguilo ovunque i revisori possano postare (tipicamente dentro il ticket). Utilizzo:
/ally reject user:@<candidato> reason:<motivo opzionale>- La richiesta di accesso in attesa del candidato passa a Rejected.
- Il bot invia un DM al candidato con il motivo (o uno predefinito se lo hai saltato).
- Il ticket si chiude immediatamente; la trascrizione NON viene archiviata (le chiusure di rifiuto saltano il forum di archivio per design — i ticket rifiutati sono rumore).
/ally done
Eseguilo dentro il ticket DOPO che /ally review ha approvato il candidato. 2 cose accadono:
- L'intera conversazione del ticket viene rispecchiata — con nomi + avatar degli autori originali + ogni file allegato — in un thread del forum privato dentro il canale forum
🗄-ally-archive. Il forum + il webhook che il bot usa per postare vengono creati automaticamente la prima volta che viene eseguito/ally done(una gilda che non archivia mai non porta in giro un forum vuoto). - Il canale ticket viene eliminato.
Il titolo del thread di archivio corrisponde al nome del canale ticket così i revisori possono cercare nel forum in seguito per username.
4. Differenze da candidatura
I due flussi condividono la struttura portante, ma Alleato ha alcuni dettagli che non esistono nel lato candidatura:
| Aspetto | candidatura | Alleato |
|---|---|---|
| Limite tier | Tier Free e superiori | Tier Pro e superiori |
| Selettore personaggio | Ricerca libera su Albion | Selettore roster alleanza (limitato alle gilde partner) |
| Concessione ruolo all'approvazione | Ruolo Discord dalla tabella di mapping | Ruolo universale AO Ally + Ruolo partner opzionale basato sulla gilda di origine |
| Marcatore visivo sul web | Ruolo AO Master regolare | Chip Ally Role (etichetta + colore) |
| Canale roster sul web | #Membri | #Alleati |
| Cron defezione | n/a | Controllo giornaliero; cambia status a Left alliance quando la gilda di origine dell'alleato lascia l'alleanza — vedi Ally Role Sync |
| Comandi slash | /enlist review, /enlist reject, /enlist done | /ally review, /ally reject, /ally done |
| Canale fissato predefinito | #📋-enlist-here | #🤝-ally-here |
| Prefisso canale ticket | 🎯-enlist-… | 🤝-ally-… |
| Forum archivio | apply-archive | 🗄-ally-archive |
Tutto ciò che non è nella tabella funziona allo stesso modo — stessa forma procedura guidata, stesso layout pannello, stesso flusso trascrizione archivio, stessa semantica Pausa / Ricostruisci / Disabilita.
5. Quando la funzionalità Alleanza è "in attesa"
Alleanza è limitata al tier Pro. Se la tua gilda scende da Pro a un tier inferiore (abbonamento scaduto, downgrade), la pipeline entra in modalità attesa:
- Il pulsante 🤝 Enable Ally su
#⚙️-guild-settingsviene sostituito con uno stato[🔒 Alliance — Pro tier needed]in grigio. - I ticket alleato esistenti rimangono aperti ma nessun nuovo candidato può fare domanda.
- Il cron di defezione si mette in pausa (il tuo roster non si sfalda solo perché hai perso un tier).
- Gli alleati esistenti mantengono il loro ruolo AO Ally e la riga nel roster.
Ripristinare il tier Pro rimette automaticamente la pipeline in attivo — non è necessaria nessuna riconfigurazione.
6. Mirror lato web
Ogni impostazione nel pannello Discord Manage Ally vive anche su #Integrazione Discord → Integrations → Alleato sul web (vedi Impostazioni → Integrazione Discord). Le impostazioni cross-surface (toggle Ricevi nuovi candidati, Domande di candidatura personalizzate, chip Ally Role) vivono su Impostazioni → Candidature (scheda esterna Alleato) e sono anche visibili nella sotto-pagina Alleato di Integrazione Discord sotto una card Impostazioni correlate.
Scegli qualsiasi superficie sia comoda — si sincronizzano in tempo reale sullo stesso canale.
Cross-link
- Flusso candidatura su Discord — l'equivalente lato membro (con screenshot Discord per ogni passo; la forma Alleato li rispecchia).
- Impostazioni → Candidature — scheda esterna Alleato (domande di candidatura + chip Ally Role + codici di invito).
- Impostazioni → Integrazione Discord — hub stato collegamento (la sotto-pagina Alleato vive sotto la scheda Integrations).
- Riferimento canale #Alleati — la pagina roster lato ospitante.
- Membri — Alleanza — la vista lato candidato.
- Discord — Appendice comandi slash — riferimento completo di ogni comando slash, inclusi
/ally review//ally reject//ally done.