X Reader

X Reader es el componente de X (antes Twitter) que consulta información sin publicar nada: los datos de una publicación, las publicaciones recientes que hablan de un tema, las publicaciones de una cuenta, quién ha dado me gusta o ha retuiteado una publicación y quién la ha citado.

Es útil para seguir lo que se dice de tu marca, analizar la respuesta a una campaña o dar a un agente de IA información actual de X.

Cuándo usarlo

Quieres un resumen diario de lo que se publica en X sobre tu marca o tu sector.
Quieres saber quién ha compartido o citado la publicación de una campaña.
Quieres guardar en una hoja de cálculo las últimas publicaciones de una cuenta.
Un agente de IA prepara informes y necesita consultar publicaciones de X.

Configuración

Necesitas una credencial X API con las claves de un proyecto del portal de desarrolladores de X: X API Key, X API Secret Key, X Bearer Token, X Access Token y X Access Token Secret. Consulta Credenciales.

Campo	Qué hace
Credential (obligatorio)	La credencial X API con la que se consulta.
Operation (obligatorio)	Lo que hace el componente. Ver Operaciones. Por defecto, `Get Tweet`.
Mode	En todas las operaciones salvo `Get Tweet`. `Basic` usa el número de resultados por defecto; `Advanced` muestra Max Results para elegirlo. Por defecto, `Basic`.
Tweet ID	Solo en `Get Tweet`, `Get Liking Users`, `Get users who retweet` y `Get Quote Tweets`. El identificador de la publicación, el número que aparece al final de su enlace. Obligatorio.
Query	Solo en `Get Recent Tweets`. Las palabras o el filtro que deben cumplir las publicaciones, por ejemplo el nombre de tu marca. Obligatorio.
Username	Solo en `Get User Timeline` y `Get Tweets By User`. El nombre de usuario de la cuenta, sin la @. Obligatorio.
Max Results	Con `Advanced`. Cuántos resultados traer como máximo, hasta 100. X pone un mínimo según la operación: 10 en `Get Recent Tweets` y `Get Quote Tweets`, y 5 en `Get User Timeline` y `Get Tweets By User`. Por defecto, 5.

Operaciones

Operación	Qué hace
`Get Tweet`	Trae los datos de una publicación.
`Get Recent Tweets`	Busca las publicaciones recientes que cumplen Query.
`Get User Timeline`	Trae las publicaciones recientes de la cronología de la cuenta de la credencial, sin respuestas ni retuits. Escribe en Username el usuario de esa misma cuenta.
`Get Tweets By User`	Trae las publicaciones de la cuenta de Username.
`Get Liking Users`	Trae las cuentas que han dado me gusta a una publicación.
`Get users who retweet`	Trae las cuentas que han retuiteado una publicación.
`Get Quote Tweets`	Trae las publicaciones que citan una publicación.

Resultado

La salida Data devuelve un elemento por cada resultado: una publicación (con su identificador y su texto, y en algunas operaciones su autor, su fecha y sus cifras de interacción) o una cuenta (con su identificador, su nombre y su nombre de usuario).

Puedes conectar el resultado a un agente para que lo resuma, a una hoja de cálculo o a un componente de mensajería. Para responder o compartir una publicación, usa su identificador con X Poster. El componente también se puede conectar a un Agente como herramienta. Ver Tool Mode.

Ejemplo

Una cadena de cafeterías quiere saber cada mañana qué se dice de ella en X.

Añade X Reader con la operación Get Recent Tweets y la credencial X API de la empresa.
En Query escribe el nombre de la cadena.
En Mode elige Advanced y pon Max Results en 50.
Conecta la salida Data a un agente que resuma los comentarios y separe los positivos de los negativos.
Envía el resumen al equipo de marketing y programa el flujo para que se ejecute cada mañana.

Buenas prácticas

Lo que puedes consultar depende del plan de acceso que tengas en el portal de desarrolladores de X. Si una operación da error de permisos, revisa allí tu plan.
Get Recent Tweets solo busca entre publicaciones recientes, no en todo el historial de X.

Componentes relacionados

X Poster: publicar, responder, dar me gusta y retuitear en X.