Caso de uso

Moderación con IA para grupos de Telegram, en cualquier idioma

Los grupos grandes de Telegram atraen spam, estafas y peleas, a menudo en varios idiomas a la vez. Un pequeño bot con VigiMod revisa cada mensaje según las categorías habituales y las reglas de tu grupo, y borra lo que las rompe.

Obtén una clave API gratuitaLee la documentación

Qué lo hace difícil

Oleadas de spam y estafas

Cuentas nuevas publican los mismos enlaces de cripto o para adultos una y otra vez. Con user_id y el grupo como scope, los mensajes repetidos llevan el spam a 1.

Grupos en muchos idiomas

En los grupos de Telegram se mezclan español, italiano, ucraniano, portugués y más. El modelo se entrenó con 26 idiomas.

Reglas de tema

«Solo preguntas sobre el curso», «Nada de compraventa»: VigiMod revisa reglas escritas con palabras normales, en cualquier idioma.

Cómo funciona con VigiMod

  1. 1

    Crea un bot con BotFather y añádelo al grupo como admin con el permiso «Eliminar mensajes».

  2. 2

    Por cada mensaje de texto, el bot envía a VigiMod el texto, los últimos diez mensajes del grupo, el id del autor y tus reglas.

  3. 3

    Si la respuesta viene marcada, el bot borra el mensaje; tras varias marcas puede silenciar o expulsar al usuario.

Reglas para copiar

Envíalas en el campo rules: cada una vuelve con su propia puntuación, como una categoría integrada.

{
  "rules": {
    "no-ads": "Nada de publicidad ni enlaces a otros grupos o canales",
    "no-trading": "Nada de compraventa ni intercambios",
    "on-topic": "Solo mensajes sobre aprender italiano",
    "no-crypto": "Nada de ofertas de inversión en cripto ni señales de trading"
  }
}

Ejemplo

Un bot en Python con python-telegram-bot: guarda los últimos diez mensajes de cada grupo y borra los marcados.

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()

Consejos

  • Los bots de Telegram ven todos los mensajes de un grupo solo si son admins (o con el modo privacidad desactivado en BotFather).
  • Revisa con más rigor los primeros mensajes de los miembros nuevos: bájales los umbrales de spam y publicidad.
  • Guarda un registro de los mensajes borrados para que los admins lo revisen: un vistazo rápido mantiene la confianza del grupo en el bot.

Preguntas

¿El bot tiene que ser admin?
Sí. Para leer todos los mensajes y borrarlos, el bot debe ser admin del grupo con el permiso «Eliminar mensajes».
¿Puede moderar también canales de Telegram?
Los canales los escriben sus admins; lo que suele necesitar moderación es el grupo de debate vinculado al canal, que funciona como cualquier grupo.
¿Se guardan los mensajes?
No. VigiMod revisa cada mensaje y lo descarta; solo se guardan contadores de uso por hora y por clave API.
¿Cuánto cuesta?
Es gratis durante la beta, con 120 mensajes por minuto por clave API, suficiente para la mayoría de los grupos.

Otros casos de uso

Sigue aprendiendo

Todas las guías

Casos de uso

¿Vienes de otra API?

Pruébalo en tu comunidad

Crea una clave API gratuita en dos minutos. Sin tarjeta y sin periodo de prueba.

Obtén una clave API gratuitaLee la documentación