Bot referral per Discord: tieni traccia degli inviti, premia i membri, blocca i join falsi

Un bot referral dà a ogni membro un proprio link di invito, registra chi è entrato tramite quel link e assegna i ruoli premio quando qualcuno ha portato abbastanza persone. La parte difficile non è contare i join, ma rifiutarsi di contare quelli falsi. Il modulo referral di Noxyr fa entrambe le cose, è gratuito e si attiva con un solo comando. Questa guida spiega come funziona l'attribuzione, le quattro regole anti-farming e le impostazioni da scegliere prima di annunciare un concorso referral.

Come funziona davvero l'attribuzione degli inviti su Discord

Discord non dice mai a un bot quale invito ha usato un nuovo membro. Ciò che invece espone è il conteggio degli utilizzi di ogni invito del server. Un bot referral tiene questi conteggi in memoria e, nel momento in cui qualcuno entra, cerca l'invito il cui conteggio è aumentato di uno. Per questo il bot ha bisogno del permesso Gestisci server (per leggere gli inviti) e dell'intent gateway Inviti; senza uno dei due, i join semplicemente non vengono attribuiti, ma nient'altro si rompe.

Noxyr aggiunge un altro elemento: /referrals link crea un invito personale per il membro che lo esegue, generato dal bot, così il join viene attribuito a quel membro anche se non ha mai usato la finestra degli inviti di Discord. I membri condividono quel link e ogni join tramite esso conta per loro.

Cosa blocca il farming dei referral

Qualsiasi premio legato ai referral verrà aggirato entro un'ora, se le regole non sono integrate. Noxyr ne applica quattro:

• Un solo referral per membro, per sempre. Un membro che esce e rientra tramite un link diverso non viene contato due volte. Il record è unico per membro e per server, in modo definitivo.
• Niente auto-inviti, niente bot. Invitare il proprio alt o un account bot non conta mai.
• Età minima dell'account. Imposta min_account_age (da 0 a 365 giorni): gli account più giovani di così vengono respinti perché probabilmente sono alt.
• Un timer di permanenza. Attiva hold e un referral attende hold_hours (da 1 a 720) prima di essere conteggiato, e viene conteggiato solo se il nuovo membro è ancora nel server alla fine del periodo. Chi invita ed esce non guadagna nulla.

Due modi per registrare i referral: log o ticket

Ogni referral viene annunciato. In modalità log un embed viene inviato in un canale a tua scelta: chi ha invitato chi, e se è stato conteggiato o è in attesa del timer di permanenza. In modalità ticket ogni referral apre un canale privato per lo staff con i pulsanti Approva e Rifiuta, così una persona lo conferma prima che venga contato. La modalità ticket è la scelta giusta quando i referral danno diritto a un premio di valore; la modalità log basta per un ruolo puramente estetico.

Ruoli premio

/referrals reward-add count:5 role:@Recruiter assegna automaticamente un ruolo nel momento in cui un membro raggiunge cinque referral conteggiati. Puoi aggiungere quante soglie vuoi (fino a 1.000 referral ciascuna), impilarle per creare dei livelli e rimuoverne una con /referrals reward-remove. Poiché i premi sono ruoli, tutto ciò che Discord permette di fare con un ruolo (accesso ai canali, un colore, un nome in evidenza) diventa un vantaggio per i referral senza altra configurazione.

Configurazione

• 1. Assicurati che Noxyr abbia il permesso Gestisci server (il permesso Amministratore lo include).
• 2. Esegui /referrals setup enabled:true mode:log log_channel:#referrals, oppure apri Community → Referral nella dashboard e compila gli stessi campi.
• 3. Scegli le regole: hold:true hold_hours:24 e min_account_age:7 sono un'impostazione predefinita sensata per un server pubblico.
• 4. Aggiungi i livelli premio con /referrals reward-add.
• 5. Dì ai membri di eseguire /referrals link e condividerlo. /referrals me mostra il loro totale e quanti sono ancora in attesa; /referrals top è la classifica.

Lo staff può controllare un membro qualsiasi con /referrals user, e /referrals settings mostra la configurazione attuale e il totale dei referral conteggiati finora.

Idee per una campagna referral

• Un ruolo mensile “miglior reclutatore” più un ringraziamento negli annunci, usando /referrals top.
• Un buono sconto per lo shop per i primi cinque referral, distribuito dallo staff dalla modalità ticket. Vedi codici sconto.
• Accesso anticipato a un lancio di prodotto per chiunque abbia il ruolo premio, dato che i ruoli controllano l'accesso ai canali.

Domande frequenti

Funziona con gli URL personalizzati? I join tramite un URL personalizzato non sono collegati a un membro, quindi non vengono attribuiti a nessuno.

Cosa succede se un invito raggiunge il limite di utilizzi con quel join? Un invito che scompare perché il suo ultimo utilizzo è appena stato consumato viene comunque riconosciuto, quindi anche i link a utilizzo limitato vengono contati.

Posso vedere i referral in attesa? Sì: /referrals me e /referrals user mostrano separatamente i numeri dei conteggiati e quelli in attesa.

È gratuito? Sì, come ogni modulo di Noxyr.

Attivalo dalla dashboard e abbinalo alle candidature allo staff per trasformare i tuoi migliori reclutatori in moderatori.