> ## Documentation Index
> Fetch the complete documentation index at: https://docs.famulor.io/llms.txt
> Use this file to discover all available pages before exploring further.

# Twitch

> Responder a @menciones del chat de Twitch y a susurros opcionales

Twitch permite que el asistente responda cuando alguien menciona al bot con @ en el chat de un canal. Los susurros son opcionales y necesitan un token de usuario adicional.

## Cuándo usarlo

Úsalo para un canal en directo donde los espectadores ya preguntan en el chat. La cuenta del bot es un usuario de Twitch aparte. Cada emisor debe conceder **channel:bot** al bot o hacerlo moderador.

## Qué oye el asistente

El asistente oye **channel.chat.message** solo después de que suscribes ese evento de EventSub a la URL de Famulor. Famulor no crea la suscripción de EventSub. La devolución de llamada debe ser HTTPS en el puerto 443.

## Dónde conseguir las claves

La guía del proveedor enlazada muestra las pantallas de estos clics. Sigue los clics de abajo junto con esas imágenes.

Inventas el secreto de EventSub (de 10 a 100 caracteres) antes de suscribir, así que existe antes que la URL de Famulor. Registra la aplicación en [dev.twitch.tv/console/apps](https://dev.twitch.tv/console/apps). El Client ID está en la aplicación y el Client Secret se muestra al generarlo. Los clics y la forma de la petición están en [Handling webhook events](https://dev.twitch.tv/docs/eventsub/handling-webhook-events). Los alcances del chat son `user:read:chat`, `user:write:chat` y `user:bot`.

## Crearlo en el proveedor

1. Entra en [dev.twitch.tv/console/apps](https://dev.twitch.tv/console/apps).
2. Elige **Register Your Application**. Pon la redirección OAuth en `http://localhost`, elige **Confidential** y créala.
3. Copia el **Client ID**. Genera un **Client Secret** y cópialo enseguida.
4. Inventa un secreto de EventSub de 10 a 100 caracteres.
5. Usa una cuenta de bot aparte. Su nombre de inicio de sesión es el valor que pide Famulor. Anota el ID numérico si lo tienes.
6. Solo para susurros, crea también un token de acceso de usuario y un token de actualización. Las @menciones del chat no los necesitan.

## Conectarlo en Famulor

Tu plan incluye este canal. Abre **Settings → Channels**, elige la tarjeta, ponle nombre a la conexión, selecciona un asistente y guarda. Los ajustes de conversación compartidos — retraso de respuesta (5 segundos por defecto) e inactividad (30 minutos por defecto) — están en la página de [canales de mensajería](https://docs.famulor.io/es/channels/messaging.md).

En la tarjeta **Twitch** pega **Application Client ID**, **Application Client Secret**, **EventSub webhook secret** y **Bot account login**. **Bot numeric user ID**, **User access token for whispers** y **Refresh token for whispers** se quedan vacíos salvo que uses susurros.

Después de guardar, abre el menú de la conexión y elige **Copy webhook URL**. Pega esa dirección exacta en el proveedor. Un dominio personalizado verificado ya forma parte de la dirección que muestra Famulor.

## Apuntar el proveedor a Famulor

1. Copia la URL de webhook de Famulor.
2. Suscribe EventSub **channel.chat.message** a esa URL HTTPS en el puerto 443, con el mismo secreto. Usa el token del bot que tenga `user:read:chat`, `user:write:chat` y `user:bot`.
3. En cada canal, añade el bot como moderador o haz que el emisor conceda **channel:bot**.
4. Menciona al bot con @ en el chat. El mensaje aparece en el historial.

## Historial

Abre el [historial](https://docs.famulor.io/es/monitoring/history.md) y filtra por **Twitch**. El hilo, la respuesta del asistente y el análisis, si existe, aparecen ahí. Puedes pausar el asistente y responder tú.

## API, MCP y línea de comandos

La misma conexión se crea con la API pública, la herramienta MCP `create_messaging_connector` o la línea de comandos. Sustituye los ejemplos por tus propios valores.

```bash theme={null}
famulor create-messaging-connector --platform twitch --name "Support" \
  --assistant-id ASSISTANT_UUID --client-id CLIENT_ID --client-secret CLIENT_SECRET --webhook-secret YOUR_10_TO_100_CHAR_SECRET --bot-username my_twitch_bot
```


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.