Conceptos básicos¶
Permisos: los de Telegram mandan¶
Leoward no tiene su propio sistema de rangos. Cada comando exige el permiso de administrador de Telegram que corresponde a lo que hace:
| Permiso de Telegram | Comandos |
|---|---|
| Cambiar información del grupo | todos los ajustes (/setwelcome, /lock, /addblocklist, /setflood…) |
| Borrar mensajes | /del, /purge, /spurge |
| Banear usuarios | /ban, /mute, /kick, /warn, /approve |
| Fijar mensajes | /pin, /unpin, /permapin |
| Añadir administradores | /promote, /demote |
| Gestionar temas | /newtopic, /closetopic… |
El dueño del grupo puede hacerlo todo. Algunos comandos destructivos (/unapproveall, /stopall, /clearall, /reset, /import, /joinfed) son solo para el dueño.
Si eres administrador anónimo, el bot te pedirá pulsar un botón para verificar tus permisos antes de ejecutar un comando de administración (/anonadmin on desactiva esa verificación, no recomendado).
Aprobados¶
Un usuario aprobado (/approve) es inmune a todas las acciones automáticas: bloqueos, listas negras, antiflood, CAPTCHA… sin necesidad de hacerlo administrador. Los administradores siempre están exentos.
Acciones y modos¶
Muchas funciones castigan automáticamente. En todas se usa el mismo vocabulario:
| Modo | Efecto |
|---|---|
nothing |
solo borrar el mensaje |
warn |
advertir (ver Advertencias) |
kick |
expulsar; puede volver a entrar |
ban |
banear |
tban 2d |
banear por un tiempo |
mute |
silenciar |
tmute 1h |
silenciar por un tiempo |
Anteponiendo s (sban, skick, smute, swarn) la acción es silenciosa: no se anuncia en el chat. Las acciones silenciosas automáticas requieren activar /silentactions on, que a su vez exige un canal de registro para que los administradores sigan enterándose.
Orden de evaluación de un mensaje¶
- Eventos: entradas, salidas, botones, solicitudes de entrada.
- Anti-spam (solo para no exentos): bloqueos → listas negras → antiflood. Los bloqueos tienen prioridad sobre las listas negras.
- Comandos.
- Pasivo: filtros,
#notas,@admin.
Historial y registro¶
Cada acción de moderación (manual o automática) queda en el historial del usuario (/history) y, si lo configuras, en el canal de registro con categorías (settings, admin, user, automated, reports, other).
Conexiones¶
/connect vincula tu chat privado con un grupo: todo lo que envíes al bot en privado se aplica a ese grupo, con los mismos permisos que tendrías dentro. Ideal para no interrumpir la conversación. /connection, /reconnect y /disconnect completan el conjunto.
Temas (foros)¶
Los ajustes son compartidos por todos los temas de un foro. Las bienvenidas se envían al tema de acción (/setactiontopic).