Slides

Bienvenido al componente Slides dentro de la plataforma de automatización Nappai. Este componente te permite conectar tu flujo de trabajo con Google Slides, facilitando la gestión de tus presentaciones de manera automatizada.

Puedes utilizarlo para obtener información de tus diapositivas, crear nuevas presentaciones o incluso actualizar el contenido (texto e imágenes) de forma automática. Es una herramienta ideal si necesitas integrar tus datos en informes visuales o actualizar plantillas de presentación con información específica.

¿Cómo funciona?

Este componente actúa como un puente entre tu flujo de automatización y la API de Google Slides. Cuando configuras y ejecutas el componente, este se comunica con los servidores de Google para realizar acciones específicas en tus presentaciones.

Internamente, utiliza credenciales de acceso (OAuth) para verificar que tienes permiso para ver o modificar las presentaciones. Dependiendo de la operación que elijas, el componente leerá tus diapositivas, generará un archivo nuevo o reemplazará elementos existentes en una presentación ya creada.

Conexión y Credenciales

Este componente requiere configurar previamente una credencial en el panel de Nappai para poder interactuar con Google Slides de forma segura:

1. Dirígete a la sección de Credenciales en tu panel de Nappai.
2. Crea una nueva credencial del tipo Google Slides.
3. En tu flujo de trabajo, selecciona la credencial guardada en el campo de entrada Credential de este nodo.

Nota: Asegúrate de tener acceso a las presentaciones de Google que deseas modificar.

Operaciones

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

• Get Page: Obtiene los detalles de una diapositiva específica basada en su ID.
• Get Thumbnail: Genera o recupera una miniatura de la presentación o una diapositiva específica.
• Create Presentation: Crea una nueva presentación de Google Slides desde cero.
• Get Presentation: Obtiene información general sobre una presentación existente.
• Get Slides: Recupera una lista de todas las diapositivas dentro de una presentación.
• Replace Text: Busca un texto específico en una diapositiva y lo reemplaza por uno nuevo.
• Replace Image: Reemplaza una imagen existente en una diapositiva por una nueva imagen basada en una URL.

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:

• Presentation File: Selecciona una presentación de Google Slides existente. Si estás creando una presentación nueva y no proporcionas un ID, se creará una presentación vacía.

  • Visible en: Get Page, Get Thumbnail, Create Presentation, Get Presentation, Get Slides, Replace Text, Replace Image

• Operation: Selecciona la tarea específica que deseas realizar (ver lista de operaciones arriba).

  • Visible en: Get Page, Get Thumbnail, Create Presentation, Get Presentation, Get Slides, Replace Text, Replace Image

• Last Url: Muestra la última URL utilizada para la presentación actual de Google Slides.

  • Visible en: Get Page, Get Thumbnail, Create Presentation, Get Presentation, Get Slides, Replace Text, Replace Image

• Mapping Mode: Activa el modo de procesamiento por lotes para múltiples registros de datos.

  • Visible en: Get Page, Get Thumbnail, Create Presentation, Get Presentation, Get Slides, Replace Text, Replace Image

• Mode of Input: Define cómo se identificará el objeto a manipular (por ID, por selección de diapositiva o por URL). Esto cambia la disponibilidad de otros campos como “Object ID” o “Page Object ID”.

  • Visible en: Get Page, Get Thumbnail, Create Presentation, Get Presentation, Get Slides, Replace Text, Replace Image

• Object ID to Replace: El ID del objeto (como una imagen) que deseas reemplazar en tu Google Slides.

  • Visible en: Replace Image

• Page Object ID: El ID del objeto de la página para tu Google Slides.

  • Visible en: Get Page, Get Thumbnail

• Presentation ID: El ID único de la presentación de Google Slides. Si no se proporciona en la creación, se generará una presentación vacía.

  • Visible en: Get Page, Get Thumbnail, Create Presentation, Get Presentation, Get Slides, Replace Text, Replace Image

• Replace Text: El nuevo texto que reemplazará al texto antiguo en tu Google Slides.

  • Visible en: Replace Text

• Replace Image URL: La URL de la nueva imagen que reemplazará a la imagen existente.

  • Visible en: Replace Image

• Search Text: El texto que deseas buscar en tu Google Slides para reemplazarlo.

  • Visible en: Replace Text

• Server URL: La URL del servidor para tu Google Slides.

  • Visible en: Get Page, Get Thumbnail, Create Presentation, Get Presentation, Get Slides, Replace Text, Replace Image

• Title Presentation: El título que tendrá la nueva presentación. Utilizado principalmente al crear una presentación.

  • Visible en: Create Presentation

• Tool Name: El nombre de la herramienta que se mostrará al agente de IA cuando seleccione esta herramienta.

  • Visible en: Get Page, Get Thumbnail, Create Presentation, Get Presentation, Get Slides, Replace Text, Replace Image

• Tool Description: Una descripción detallada de lo que hace esta herramienta, ayudando al agente a entender cuándo usarla.

  • Visible en: Get Page, Get Thumbnail, Create Presentation, Get Presentation, Get Slides, Replace Text, Replace Image

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

  • Visible en: Get Page, Get Thumbnail, Create Presentation, Get Presentation, Get Slides, Replace Text, Replace Image

• Max Results: El número máximo de resultados que se devolverán (útil para obtener múltiples diapositivas).

  • Visible en: Get Page, Get Thumbnail, Create Presentation, Get Presentation, Get Slides, Replace Text, Replace Image

Salidas

El componente devuelve los datos procesados que puedes utilizar en pasos siguientes de tu flujo de automatización.

• Data: Contiene la información obtenida de la operación (por ejemplo, detalles de la diapositiva, ID de la nueva presentación, etc.).
• Tool: Permite integrar esta funcionalidad como una herramienta para que el agente de IA la utilice en interacciones complejas.

Ejemplo de Respuesta JSON

A continuación se muestra un ejemplo simplificado de lo que podrías recibir al usar la operación Get Slides o Get Presentation con éxito: json { “presentationId”: “1BxiMVs0XRA5nFMdKvBdBZjgmUUqptlbs74OgvE2upms”, “title”: “My Marketing Presentation”, “slides”: [ { “objectId”: “g1234567890”, “slideProperties”: { “layoutObjectId”: “LAYOUT_ID_HERE” } } ], “masters”: [], “layouts”: [] }

Nota: La estructura exacta de la salida dependerá de la operación seleccionada (por ejemplo, una imagen en base64 para “Get Thumbnail” o un mensaje de éxito para “Replace Text”).

Conectividad

Este componente suele conectarse como un paso intermedio en un flujo de automatización.

• Entrada: Generalmente recibe datos de entrada desde componentes que definen qué presentación usar (como inputs de texto) o desde otros nodos de Google.
• Salida: Sus salidas (Data) suelen conectarse a:
  • Componentes de almacenamiento de datos (para guardar el ID de una presentación creada).
  • Componentes de notificaciones (para avisar que una presentación ha sido actualizada).
  • Componentes de IA (si el flujo requiere analizar el contenido de las diapositivas).

Tiene sentido lógico conectar este componente después de generar datos (como un informe en CSV) y antes de notificar a un equipo, creando así una presentación automática basada en esos datos.

Ejemplo de Uso

Escenario: Crear un informe visual automático

1. Obtén tus datos: Usa un componente para extraer ventas o métricas.
2. Actualiza la presentación:
   • Selecciona la operación Replace Text.
   • En Presentation ID, ingresa el ID de tu plantilla de presentación.
   • En Search Text, busca el marcador “VENTAS_TOTALES”.
   • En Replace Text, mapea el valor de las ventas obtenido en el paso anterior.
3. Resultado: Cuando se ejecute el flujo, el componente buscará “VENTAS_TOTALES” en las diapositivas y lo reemplazará con los números reales.

Escenario: Crear una nueva presentación

• Selecciona la operación Create Presentation.
• Ingresa un Title Presentation (ej: “Reporte Mensual”).
• El sistema devolverá un nuevo Presentation ID que puedes guardar para futuras ediciones.

Notas Importantes

🔒 Google Account and Permissions 🟢 You must have a Google account with access to the Slides you want to use, and the account must grant the component the necessary read/write permissions via OAuth.

🔒 Protect Your Credentials 🟢 Store your OAuth client ID and secret securely and avoid sharing them. The component does not expose sensitive data, but compromised credentials could grant access to your Slides.

⚠️ Only Google Slides Supported 🟡 This component works exclusively with Google Slides files; it cannot import or export other presentation formats such as PowerPoint or PDF.

⚠️ Token Expiration 🟡 OAuth tokens may expire during long sessions, causing operations to fail. If you encounter errors, re‑authenticate to refresh the token.

📋 Internet Connection 🟡 The component communicates with Google Slides over the internet, so a stable internet connection is required for all operations.

ℹ️ Component May Modify Slides 🟡 Operations performed by the component can change slide content. Use the component on copies of your presentations if you need to preserve the original.

ℹ️ Read‑Only Slides 🟡 If a presentation is set to read‑only, write operations will fail. Ensure the presentation has the correct edit permissions before running the component.

💡 Target Specific Slides 🟢 When possible, specify slide IDs or ranges instead of the entire presentation to reduce processing time and minimize accidental changes.

💡 Test on Sample Data 🟢 Run the component on a sample or duplicate presentation first to confirm that it behaves as expected before applying it to important slides.

⚙️ Correct OAuth Scopes 🟡 Make sure the OAuth client is configured with the proper scopes (e.g., https://www.googleapis.com/auth/presentations). Missing scopes will lead to authentication errors.

Consejos y Mejores Prácticas

• Utiliza el Mapping Mode cuando necesites actualizar múltiples diapositivas con diferentes conjuntos de datos (por ejemplo, crear 10 copias de una presentación para 10 vendedores distintos).
• Si solo necesitas leer información, usa la operación Get Slides o Get Page para evitar modificaciones accidentales.
• Para operaciones de reemplazo de texto, asegúrate de que el Search Text sea único en la diapositiva para evitar reemplazar el texto incorrecto.
• Si la operación falla, verifica primero que la credencial de Google Slides tenga permisos de escritura (edit access).

Consideraciones de Seguridad

Al interactuar con la API de Google, es fundamental que protejas tus credenciales de OAuth. Nappai maneja la autenticación de manera segura, pero debes asegurarte de no compartir los Client ID y Secret en espacios públicos. Además, ten en cuenta que las operaciones de escritura (como Replace Text) modifican el archivo original en la nube; se recomienda trabajar en copias de seguridad si la información es crítica.