Saltar al contenido principal
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. 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. Guía oficial: Activity API.

​
Crearlo en el proveedor

  1. En 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. 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, 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 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.