Saturn Studio – X

📌 ¿Qué es este módulo?

Este módulo integra X (antes Twitter), la plataforma de medios sociales, directamente en Saturn Studio. Permite a los robots interactuar con la red social para automatizar tareas como la publicación de tuits, la búsqueda de contenido, el monitoreo de menciones y la obtención de información sobre usuarios y sus publicaciones.

Con esta integración, puedes conectar la gestión de tus redes sociales con otros procesos de negocio. Por ejemplo, un robot puede publicar automáticamente en X las nuevas entradas de un blog, monitorear la opinión pública sobre una marca buscando palabras clave, o crear alertas cuando un cliente importante tuitee sobre un tema específico.

📚 Descripción de los comandos

A continuación se detallan los comandos disponibles para la integración con X:

✍️ Create Tweet

Crea un tuit en X.

Parámetro	Descripción	Ejemplo
Credential	Credencial de X necesaria para crear tuits.	credential
Message	El mensaje que será enviado.	Hello Rocketbot
Assign result to variable	Variable donde se almacenará el resultado.	{“data”: {“id”: “1460323737035677698”, “text”: “Hello Rocketbot”}}

🔍 Search Tweets

Busca tuits en X.

Parámetro	Descripción	Ejemplo
Credential	Credencial de X necesaria para buscar tuits.	credential
Search type	recent: últimos 7 días. all: histórico completo.	Recent
Search	El término o frase que se desea buscar.	Rocketbot_es
Total results	Número de tuits a devolver (por defecto, 10).	10
Assign result to variable	Variable donde se almacenará el resultado.	{“data”: [{“id”: “1293593516040269825”, “text”: “RT @Rocketbot_es: ¡Estamos aprendiendo sobre automatización!”}], “meta”: {“newest_id”: “1293593516040269825”, “result_count”: 1}}

🆔 Get User ID

Obtiene el ID de un usuario a partir de su nombre de usuario.

Parámetro	Descripción	Ejemplo
Credential	Credencial de X necesaria para obtener el usuario.	credential
Username	El nombre de usuario cuyo ID se desea obtener.	Rocketbot_es
Assign result to variable	Variable donde se almacenará el resultado.	{“data”: {“id”: “2244994945”, “name”: “Rocketbot”, “username”: “Rocketbot_es”}}

🗣️ Get Mentions

Obtiene los tuits que mencionan a un usuario específico por su ID.

Parámetro	Descripción	Ejemplo
Credential	Credencial de X necesaria para obtener menciones.	credential
Total results	Número de menciones a devolver (por defecto, 10).	10
User ID	El ID del usuario cuyas menciones se desean obtener.	2244994945
Assign result to variable	Variable donde se almacenará el resultado.	{“data”: [{“id”: “1460323737035677698”, “text”: “@Rocketbot_es, ¡su plataforma es increíble!”}], “meta”: {“result_count”: 1}}

📄 Get User Timeline

Obtiene la cronología (timeline) de un usuario.

Parámetro	Descripción	Ejemplo
Credential	Credencial de X necesaria para obtener la cronología.	credential
Total results	Número de tuits a devolver (por defecto, 10).	10
User ID	El ID del usuario cuya cronología se desea obtener.	2244994945
Assign result to variable	Variable donde se almacenará el resultado.	{“data”: [{“id”: “1293593516040269825”, “text”: “¡Hola, mundo!”}], “meta”: {“result_count”: 1}}

🔁 Retweet

Retuitea un tuit.

Parámetro	Descripción	Ejemplo
Credential	Credencial de X necesaria para retuitear.	credential
Tweet ID	El ID del tuit que se desea retuitear.	1293593516040269825
Assign result to variable	Variable donde se almacenará el resultado.	{“data”: {“retweeted”: true}}

ℹ️ Get Tweet Information

Obtiene la información de un tuit a partir de su ID.

Parámetro	Descripción	Ejemplo
Credential	Credencial de X necesaria para obtener información.	credential
Tweet ID	El ID del tuit del que se desea obtener información.	1293593516040269825
Assign result to variable	Variable donde se almacenará el resultado.	{“data”: {“id”: “1293593516040269825”, “text”: “Este es el contenido del tuit.”, “author_id”: “2244994945”, “created_at”: “2025-06-23T10:00:00.000Z”}}

🧪 Ejemplo de uso

• Monitoreo de Marca: Utilizar “Search Tweets” para buscar menciones del nombre de una empresa o producto y analizar el sentimiento de los comentarios.
• Publicación Automática: Programar un robot que use “Create Tweet” para publicar noticias o actualizaciones del blog de la empresa a una hora específica.
• Atención al Cliente: Emplear “Get Mentions” para identificar cuando un usuario menciona la cuenta de soporte y crear automáticamente un ticket en un sistema de gestión de incidencias.
• Análisis de Competencia: Ejecutar “Get User Timeline” sobre las cuentas de la competencia para recopilar y analizar sus últimos tuits y estrategias de comunicación.

🧩 Requisitos

1. Tener una cuenta de desarrollador en la plataforma X (Twitter).
2. Crear una aplicación en el Portal de Desarrollador de X para obtener las credenciales de la API (API Key, API Key Secret, Access Token y Access Token Secret).
3. La credencial en Saturn Studio se debe configurar con las claves y tokens obtenidos.
4. Asegurarse de que la aplicación creada en X tenga los permisos (scopes) necesarios para realizar las acciones deseadas (ej: tweet.read, tweet.write, user.read).