Info di base bot
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.
Iil bot considererà come target del comando il primo utente identificato con una delle seguenti tecniche:
- l'utente taggato con tag "per nome" (quindi non per username), ovvero il tag che Telegram manda quando si cerca di taggare qualcuno che non ha uno username impostato
- l'utente indicato tramite hashtag utente, tipo #id1234567. Questo hashtag non è 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
Questi sono i modi che il bot utilizza per capire a chi è diretto un comando. Non sono in ordine di priorità, e non è datto che vengano utilizzati tutti: dipende dal comando. Ad esempio, con /warn si può taggare l'utente, ma non funziona per #id. Invece /uinfo, che funziona solo nelle chat dello staff, non funziona in risposta.
Per username:
Rispondendo ad un messaggio che contiene lo username:
Per hashtag:
Rispondendo ad un messaggio ricevuto da un utente:
