Bot: info di base

In questa pagina verranno raccolte delle info di base, o dei principi, su cui si basa il bot. Ad esempio, la logica che viene utilizzata per identificare l'utente target di un comando (es. /ban, /userinfo, altre cose nella documentazione)

Specificare la persona target di un comando

Esistono molti comandi che richiedono di specificare l'utente destinatario di un comando (esempio più lampante: /ban). Di seguito verrà spiegato come il bot decide chi è il target di questi comandi. Lo scrivo qui una sola volta per evitare di scriverlo ogni volta che serve nella documentazione dei singoli comandi.

In ordine di priorità, il bot considererà come target del comando:

l'utente taggato per tag per nome (quindi non per username), ovvero il tag che Telegram manda quando si cerca di taggare qualcuno che non ha uno username
l'utente indicato tramite hashtag utente, tipo #id1234567. Questo hashtag non è altro che un identificativo univoco dell'account Telegram (infatti è la concatenzazione di "#id" e l'id univoco dell'utente), è immutabile, e permette di cercare con certezza tutto ciò che riguarda un acocunt. Infatti ogni volta che il bot logga un qualcosa che ha a che fare con la moderazione o le richieste, include sempre questo hashtag. L'id Telegram di un account non è una cosa che le app mostrano, ma è facilmente reperibile dalle varie chat di log
l'utente taggato per username
se il comando è utilizzato in risposta ad un messaggio di un utente inoltrato dal bot in una delle chat riservate allo staff: l'utente che ci ha inviato quel messaggio
se il messaggio è una risposta ad un altro messaggio: vedi punto 1, ma il tag verrà cercato nel messaggio a cui si risponde
se il messaggio è una risposta ad un altro messaggio: vedi punto 2, ma l'hashtag verrà cercato nel messaggio a cui si risponde
se il messaggio è una risposta ad un altro messaggio: vedi punto 3, ma lo username verrà cercato nel messaggio a cui si risponde

Trattandosi di un elenco di priorità, nel caso in cui l'utente sia specificato in più di un modo (ad esempio, taggando l'utente per username e anche per hashtag), verrà presa in considerazione solo l'occorrenza con "priorità" maggiore.

Per username:

Rispondendo ad un messaggio che contiene lo username:

Per hashtag:

Rispondendo ad un messaggio ricevuto da un utente: