Caso de uso

Moderación con IA para el chat de Twitch que conoce las reglas de tu canal

Un chat de Twitch lleno va más rápido de lo que cualquier moderador puede leer. VigiMod revisa cada mensaje junto con los anteriores, en 26 idiomas, y según las reglas de tu canal, para que tu bot borre lo que las rompe y deje en paz las bromas.

Obtén una clave API gratuitaLee la documentación

Qué lo hace difícil

Rápido y lleno de bromas internas

Emotes, copypastas y piques entre habituales parecen insultos fuera de contexto. Leer los mensajes anteriores evita la mayoría de las marcas erróneas.

Reglas que ningún filtro conoce

«Nada de spoilers del juego», «Nada de backseat», «Nada de autopromoción»: cada canal tiene las suyas y las listas de palabras no las detectan.

Espectadores de todas partes

Los canales grandes reciben chat en muchos idiomas, y las listas de palabras hay que reescribirlas para cada uno. VigiMod se entrenó con 26 idiomas.

Cómo funciona con VigiMod

  1. 1

    Tu bot lee el chat (IRC o EventSub) y guarda los últimos diez mensajes.

  2. 2

    Cada mensaje nuevo va a VigiMod con ese contexto, el id del autor y las reglas del canal.

  3. 3

    Si la respuesta viene marcada, el bot borra el mensaje con la API de Twitch, o da un timeout al usuario tras varias marcas.

Reglas para copiar

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

{
  "rules": {
    "no-spoilers": "Nada de spoilers del juego que se está jugando",
    "no-backseating": "No decirle al streamer cómo jugar si no lo pide",
    "no-self-promo": "Nada de promocionar tu propio canal o redes",
    "spanish-only": "En el chat solo español"
  }
}

Ejemplo

Un bot en Node.js: tmi.js lee el chat, VigiMod revisa cada mensaje y la API de Twitch lo borra si está marcado (el token necesita el scope moderator:manage:chat_messages).

JavaScript (Node.js)

// npm install tmi.js  (Node 18+)
// tmi.js reads the chat; the Twitch API deletes a message (token scope: moderator:manage:chat_messages)
import tmi from "tmi.js";

const { VIGIMOD_KEY, TWITCH_TOKEN, TWITCH_CLIENT_ID, BROADCASTER_ID, MODERATOR_ID } = process.env;
const RULES = { "no-spoilers": "No spoilers about the game being played" };
const recent = [];                       // the last messages of the chat, sent as context

const client = new tmi.Client({ channels: ["your_channel"] });

client.on("message", async (channel, tags, text, self) => {
  if (self) return;
  const res = await fetch("https://api.vigimod.com/moderate", {
    method: "POST",
    headers: { "X-API-Key": VIGIMOD_KEY, "Content-Type": "application/json" },
    body: JSON.stringify({
      text: text.slice(0, 2000), context: [...recent], rules: RULES,
      user_id: tags["user-id"], scope: channel,
    }),
    signal: AbortSignal.timeout(2000),
  }).catch(() => null);                  // slow or down: let the message through
  recent.push(text.slice(0, 2000));
  if (recent.length > 10) recent.shift();
  if (!res?.ok) return;

  const result = await res.json();
  if (result.flagged) {
    const q = new URLSearchParams({ broadcaster_id: BROADCASTER_ID, moderator_id: MODERATOR_ID, message_id: tags.id });
    await fetch(`https://api.twitch.tv/helix/moderation/chat?${q}`, {
      method: "DELETE",
      headers: { Authorization: `Bearer ${TWITCH_TOKEN}`, "Client-Id": TWITCH_CLIENT_ID },
    });
  }
});

client.connect();

Consejos

  • Mantén AutoMod activado: retiene los mensajes antes de que aparezcan; VigiMod añade después tus reglas, el contexto y otros idiomas.
  • Borra a la primera marca, pero da timeout solo tras varias marcas del mismo usuario en poco tiempo.
  • Envía user_id y el canal como scope: los mensajes repetidos y el flood de un mismo usuario suben la puntuación de spam.

Preguntas

¿VigiMod sustituye a AutoMod de Twitch?
No, funciona junto a él. AutoMod viene integrado en Twitch y retiene mensajes antes de mostrarlos; VigiMod revisa tus propias reglas, lee el contexto y cubre 26 idiomas.
¿Es lo bastante rápido para el chat en directo?
Cada mensaje es una llamada HTTP. Ponle un timeout corto (unos dos segundos) y, si una llamada falla o tarda, deja pasar el mensaje para que el chat siga.
¿Y los canales con mucho tráfico?
La beta gratuita permite 120 mensajes por minuto por clave API. Si tu chat va más rápido, escribe a soporte con tu volumen y se puede subir el límite.
¿Sirve para VODs o clips?
VigiMod revisa solo texto. Puedes revisar títulos, repeticiones del chat y comentarios, pero no el vídeo ni el audio.

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