Caso d'uso

Moderazione AI per gruppi Telegram, in qualsiasi lingua

I gruppi Telegram grandi attirano spam, truffe e litigi, spesso in più lingue insieme. Un piccolo bot con VigiMod controlla ogni messaggio sulle categorie solite e sulle regole del tuo gruppo, e cancella quello che le viola.

Ottieni una chiave API gratuitaLeggi la documentazione

Cosa lo rende difficile

Ondate di spam e truffe

Account nuovi pubblicano gli stessi link crypto o per adulti di continuo. Con user_id e il gruppo come scope, i messaggi ripetuti portano il punteggio spam a 1.

Gruppi in tante lingue

Nei gruppi Telegram si mescolano italiano, spagnolo, ucraino, portoghese e altro. Il modello è addestrato su 26 lingue.

Regole sull'argomento

«Solo domande sul corso», «Niente compravendite»: VigiMod controlla regole scritte a parole, in qualsiasi lingua.

Come funziona con VigiMod

  1. 1

    Crea un bot con BotFather e aggiungilo al gruppo come admin con il permesso «Elimina messaggi».

  2. 2

    Per ogni messaggio di testo, il bot invia a VigiMod il testo, gli ultimi dieci messaggi del gruppo, l'id dell'autore e le tue regole.

  3. 3

    Se la risposta è segnalata, il bot cancella il messaggio; dopo più segnalazioni può silenziare o rimuovere l'utente.

Regole da copiare

Inviale nel campo rules: ognuna torna con il suo punteggio, come una categoria predefinita.

{
  "rules": {
    "no-ads": "Niente pubblicità o link ad altri gruppi o canali",
    "no-trading": "Niente compravendite o scambi",
    "on-topic": "Solo messaggi sullo studio dello spagnolo",
    "no-crypto": "Niente offerte di investimento in crypto o segnali di trading"
  }
}

Esempio

Un bot Python con python-telegram-bot: tiene gli ultimi dieci messaggi di ogni gruppo e cancella quelli segnalati.

Python

# pip install python-telegram-bot httpx
# The bot must be an admin of the group with the "Delete messages" permission.
import os
from collections import defaultdict, deque

import httpx
from telegram import Update
from telegram.ext import Application, ContextTypes, MessageHandler, filters

RULES = {"no-ads": "No advertising or links to other groups or channels"}
history = defaultdict(lambda: deque(maxlen=10))   # last messages of each group, sent as context
vigimod = httpx.AsyncClient(base_url="https://api.vigimod.com", timeout=3,
                            headers={"X-API-Key": os.environ["VIGIMOD_KEY"]})

async def check(update: Update, context: ContextTypes.DEFAULT_TYPE) -> None:
    msg, chat = update.effective_message, str(update.effective_chat.id)
    text = msg.text[:2000]
    try:
        r = await vigimod.post("/moderate", json={
            "text": text, "context": list(history[chat]), "rules": RULES,
            "user_id": str(msg.from_user.id), "scope": chat,
        })
        flagged = r.is_success and r.json()["flagged"]
    except httpx.HTTPError:
        flagged = False                     # slow or down: let the message through
    history[chat].append(text)
    if flagged:
        await msg.delete()

app = Application.builder().token(os.environ["TELEGRAM_TOKEN"]).build()
app.add_handler(MessageHandler(filters.TEXT & ~filters.COMMAND & filters.ChatType.GROUPS, check))
app.run_polling()

Consigli

  • I bot Telegram vedono tutti i messaggi di un gruppo solo se sono admin (o con la privacy mode disattivata in BotFather).
  • Controlla i primi messaggi dei nuovi membri in modo più severo: abbassa per loro le soglie di spam e pubblicità.
  • Registra i messaggi cancellati perché gli admin li possano rivedere: un controllo veloce mantiene la fiducia del gruppo nel bot.

Domande

Il bot deve essere admin?
Sì. Per leggere tutti i messaggi e cancellarli, il bot deve essere admin del gruppo con il permesso «Elimina messaggi».
Può moderare anche i canali Telegram?
I canali li scrivono i loro admin; di solito va moderato il gruppo di discussione collegato al canale, che funziona come qualsiasi gruppo.
I messaggi vengono salvati?
No. VigiMod controlla ogni messaggio e lo scarta; teniamo solo contatori orari di utilizzo per chiave API.
Quanto costa?
È gratis durante la beta, con 120 messaggi al minuto per chiave API, abbastanza per la maggior parte dei gruppi.

Altri casi d'uso

Continua a imparare

Tutte le guide

Casi d'uso

Arrivi da un'altra API?

Provalo sulla tua community

Crea una chiave API gratuita in due minuti. Niente carta, niente periodo di prova.

Ottieni una chiave API gratuitaLeggi la documentazione