> ## 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.

# X

> Responder a menciones de posts y mensajes directos en X

X permite que el asistente responda cuando alguien menciona la cuenta conectada en un post, o le envía un mensaje directo. La respuesta se queda en X, y el hilo queda en el historial. Las imágenes y los archivos de este canal no se reciben como medios.

## Cuándo usarlo

Úsalo para un identificador público de soporte o una bandeja de mensajes directos en X. Conectar un asistente significa que esas menciones y mensajes directos se responden con sus instrucciones y herramientas, en lugar de esperar en la bandeja de X.

## Qué oye el asistente

El asistente oye las menciones de posts y los mensajes directos de la cuenta que autorizó la app. X comprueba el webhook con un desafío CRC, y Famulor responde a esa comprobación. Suscribe `post.mention.create`, `dm.received` y `dm.sent`.

## 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.

Crea un proyecto y una app en [developer.x.com](https://developer.x.com). En **Keys and tokens**, copia el **API Key Secret**. Ese es el campo **API Key Secret (consumer secret)** en la tarjeta de Famulor. Activa también la autenticación de usuario OAuth 2.0 con los alcances `tweet.read`, `tweet.write`, `users.read`, `dm.read`, `dm.write`, `like.write` y `offline.access`. Termina el inicio de sesión de la cuenta del bot y guarda o el token de acceso de usuario, o el ID de cliente junto con el token de actualización. El webhook en sí se registra en la [consola de desarrolladores de X](https://console.x.com). Guía oficial: [Activity API](https://docs.x.com/x-api/activity/introduction).

## Crearlo en el proveedor

1. En [developer.x.com](https://developer.x.com), crea un proyecto y una app.
2. Abre **Keys and tokens** y copia el **API Key Secret**.
3. Activa OAuth 2.0 para el usuario del bot con los alcances de arriba.
4. Termina el inicio de sesión y copia el token de acceso de usuario, o el ID de cliente y el token de actualización.
5. Opcional: copia el ID de usuario del bot y el @identificador si ya los tienes. Famulor puede guardar ambos en la tarjeta.

## 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 **X**, **API Key Secret (consumer secret)** es obligatorio. Pega también o **OAuth 2.0 user access token**, o a la vez **OAuth client ID (optional, managed refresh)** y **OAuth refresh token (optional)**. **Bot user ID (optional)** y **Bot @handle (optional)** pueden quedar vacíos.

## Apuntar el proveedor a Famulor

1. Copia la URL de webhook de Famulor desde el menú de la conexión. Tiene que ser HTTPS público, sin puerto en la dirección.
2. En la [consola de desarrolladores de X](https://console.x.com), registra esa URL como webhook de la Activity API. X envía un desafío CRC, y Famulor lo responde.
3. Suscribe `post.mention.create`, `dm.received` y `dm.sent`. La cuenta del bot tiene que haber autorizado la app antes.
4. Una mención nueva o un mensaje directo aparece en el historial.

## Historial

Abre el [historial](https://docs.famulor.io/es/monitoring/history.md) y filtra por **X**. 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

Crea esta conexión en el panel. La API pública y la línea de comandos no pueden enviar todos los valores que pide esta tarjeta, así que no pueden terminar esta configuración. La tarjeta necesita el API Key Secret, y una llamada pública de creación no acepta ese valor.


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