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