Saltearse al contenido
Nappai Documentation

X Poster

El X Poster es un componente de Nappai que te permite publicar tweets, dar me gusta, retuitear, eliminar tweets y retweets, y modificar el contenido de un tweet existente. Con él puedes automatizar cualquier acción que normalmente realizarías en la plataforma X (Twitter) directamente desde tu dashboard de Nappai.

¿Cómo funciona?

El componente se conecta a la API oficial de X mediante una credencial que ya debe haber sido creada en la sección de credenciales de Nappai. Cuando seleccionas una operación, el componente envía la solicitud correspondiente a la API y devuelve los datos del tweet afectado. Si activas el Mapping Mode, puedes procesar varios registros a la vez: cada campo puede recibir un valor fijo, un valor mapeado desde la salida de otro componente o un valor calculado con JavaScript.

Operaciones

Este componente ofrece varias operaciones que puedes seleccionar según lo que necesites hacer. Solo puedes usar una operación a la vez:

  • Post Tweet: Publica un nuevo tweet con el texto que proporciones. Si incluyes un Tweet ID, el nuevo tweet se publicará como respuesta a ese tweet.
  • Like Tweet: Da me gusta a un tweet existente.
  • Retweet: Reenvía un tweet a tu línea de tiempo.
  • Delete Tweet: Elimina un tweet que hayas publicado.
  • Unlike Tweet: Quita el me gusta de un tweet que previamente hayas marcado.
  • Delete Retweet: Elimina un retweet que hayas hecho.

Para usar el componente, primero selecciona la operación que necesitas en el campo Operation (Operación).

Entradas

Modo de Mapeo (Mapping Mode)

Este componente cuenta con un modo especial llamado Mapping Mode (Modo de Mapeo). Cuando activas este modo mediante el interruptor, se habilita una entrada adicional llamada Mapping Data y cada campo de entrada te ofrece tres formas diferentes de proporcionar datos:

  • Fixed (Fijo): Escribes el valor directamente en el campo.
  • Mapped (Mapeado): Conectas la salida de otro componente para usar su resultado como valor.
  • Javascript: Escribes código JavaScript para calcular el valor dinámicamente.

Esta flexibilidad te permite crear flujos de trabajo más dinámicos y conectados.

Campos de Entrada

Los siguientes campos están disponibles para configurar este componente. Cada campo puede estar visible en diferentes operaciones:

  • Operation: Selecciona la acción que quieres realizar.

    • Visible en: Post Tweet, Like Tweet, Retweet, Delete Tweet, Unlike Tweet, Delete Retweet

  • Mapping Mode: Activa el modo de mapeo para procesar múltiples registros en lote.

    • Visible en: Post Tweet, Like Tweet, Retweet, Delete Tweet, Unlike Tweet, Delete Retweet

  • Mode: Elige entre una configuración simplificada con opciones predeterminadas o un control completo con ajustes avanzados.

    • Visible en: Post Tweet

  • Tweet ID (para Post Tweet): ID opcional de un tweet existente al que quieres responder. Si lo estableces, el nuevo tweet se publicará como respuesta a ese tweet.

    • Visible en: Post Tweet

  • Tweet ID (para operaciones de Like, Retweet, Delete, Unlike, Delete Retweet): ID del tweet objetivo de la operación.

    • Visible en: Like Tweet, Retweet, Delete Tweet, Unlike Tweet, Delete Retweet

  • Tweet Text: Contenido del tweet que quieres publicar.

    • Visible en: Post Tweet

  • Username: Nombre de usuario que realiza la acción. Se usa para resolver el ID de usuario requerido por la API.

    • Visible en: Like Tweet, Retweet, Unlike Tweet, Delete Retweet

  • Tool Name: Nombre del tool que se mostrará al agente cuando este componente esté conectado como herramienta.

    • Visible en: Post Tweet, Like Tweet, Retweet, Delete Tweet, Unlike Tweet, Delete Retweet

  • Tool Description: Descripción detallada de lo que hace esta herramienta.

    • Visible en: Post Tweet, Like Tweet, Retweet, Delete Tweet, Unlike Tweet, Delete Retweet

  • Tools arguments metadata: Define los metadatos de los argumentos para las herramientas.

    • Visible en: Post Tweet, Like Tweet, Retweet, Delete Tweet, Unlike Tweet, Delete Retweet

Credencial
Este componente requiere una credencial de tipo X API.

  1. Configura primero la credencial en la sección de credenciales de Nappai.
  2. Luego selecciona esa credencial en el campo Credential del componente.

Salidas

  • Tweet Data: Devuelve los datos del tweet que se ha publicado, modificado o eliminado.
  • Tool: Devuelve una herramienta que puede ser utilizada por agentes de IA para interactuar con X.

Ejemplo de Uso

Publicar un tweet

  1. Arrastra el componente X Poster al flujo.
  2. Selecciona la operación Post Tweet.
  3. En Tweet Text escribe: “¡Hola mundo! #Nappai”.
  4. Si quieres responder a un tweet existente, ingresa su ID en Tweet ID.
  5. Asegúrate de haber seleccionado la credencial X API.
  6. Ejecuta el flujo y el componente devolverá los datos del tweet publicado en Tweet Data.

Dar me gusta a un tweet

  1. Arrastra el componente X Poster al flujo.
  2. Selecciona la operación Like Tweet.
  3. En Tweet ID escribe el ID del tweet que quieres marcar.
  4. Selecciona la credencial X API.
  5. Ejecuta el flujo; el componente confirmará la acción y devolverá los datos del tweet en Tweet Data.

Componentes Relacionados

  • X Base Poster: Base que gestiona la lógica común de interacción con la API de X.
  • Twitter API Connector: Conector genérico para otras operaciones de X que no están cubiertas por X Poster.

Consejos y Mejores Prácticas

  • Revisa los límites de la API: X impone límites de tasa por usuario; evita enviar demasiadas solicitudes en un corto período.
  • Usa Mapping Mode para grandes volúmenes: Si necesitas publicar o interactuar con cientos de tweets, activa el modo de mapeo y conecta la entrada Mapping Data a un flujo de datos.
  • Guarda los IDs de tweets: Al publicar un tweet, guarda su ID para poder referenciarlo en operaciones posteriores (respuesta, eliminación, etc.).
  • Maneja errores: La salida Tweet Data incluirá información de error si la operación falla; úsala para depurar y registrar problemas.

Consideraciones de Seguridad

  • Protege la credencial X API: No compartas la credencial en archivos públicos ni la incluyas en el código fuente.
  • Almacena la credencial en un lugar seguro: Nappai ofrece un gestor de credenciales que cifra los datos sensibles.
  • Revisa los permisos: Asegúrate de que la credencial tenga solo los permisos necesarios (publicar, dar me gusta, etc.) para minimizar riesgos.

Con esta guía podrás integrar fácilmente el X Poster en tus flujos de trabajo de Nappai y automatizar la interacción con la plataforma X de manera segura y eficiente.