Saltearse al contenido
Nappai Documentation

Entries

Este componente actúa como un puente directo entre Nappai y tu sistema Strapi CMS (Sistema de Gestión de Contenidos). Su propósito principal es permitirte recuperar entradas de datos, como artículos de un blog, productos de una tienda o registros de una base de datos, directamente dentro de tus automatizaciones.

En lugar de tener que escribir código complejo para hablar con Strapi, este componente ya tiene toda la lógica necesaria configurada. Tú solo le dices “qué” quieres obtener (el tipo de contenido) y “cómo” quieres identificarlo (si es un ID específico o un filtro), y el componente se encarga de la conexión y la recuperación de los datos.

¿Cómo funciona?

Internamente, este componente funciona como un “asistente de datos” especializado. Sigue estos pasos para recuperar información:

  1. Autenticación: Se conecta a tu servidor de Strapi utilizando las credenciales que hayas configurado previamente en Nappai (ya sea mediante un Token API seguro o usando usuario y contraseña).
  2. Consulta: Utiliza el Content Type (Tipo de Contenido) que le indiques para saber a qué “estantería” de datos mirar (por ejemplo, mirar solo la sección de “Blog” o solo la de “Inventario”).
  3. Filtrado:
    • Si necesitas todos los datos de esa categoría, lo devuelve en una lista.
    • Si le proporcionas un Entry ID (ID único), busca específicamente ese registro.
    • Si usas el campo Item, aplica filtros avanzados (por ejemplo, “solo los artículos publicados”).
  4. Límite de resultados: Puedes decidir cuántos elementos devolver usando el campo Top (por ejemplo, solo los últimos 5).

Una vez realizada la consulta, el componente te entrega los datos en un formato estructurado (JSON) listo para ser usado por los siguientes pasos de tu automatización.

Conexión y Credenciales

Este componente requiere configurar previamente una credencial en el panel de Nappai para poder interactuar con el servicio externo:

  1. Dirígete a la sección de Credenciales en tu panel de Nappai.
  2. Crea una nueva credencial del tipo Strapi CMS y guarda los campos requeridos (Base URL y API Token).
  3. En tu flujo de trabajo, selecciona la credencial guardada en el campo de entrada Credential de este nodo.

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:

  • Credential: Selecciona aquí la credencial de Strapi CMS que configuraste en tu panel para autorizar la conexión.
  • Operation: Permite elegir la acción principal. Para este componente, la operación estándar es recuperar o listar entradas de datos.
  • Content Type: Es el identificador de la categoría de datos que quieres recuperar (ejemplo: “articles”, “products”, “authors”). Define el tipo de estructura de datos que se va a consultar.
  • Item: Te permite aplicar filtros o condiciones avanzadas sobre la búsqueda (ejemplo: filtrar solo items que sean “publicados” o que tengan un precio mayor a X).
  • Entry ID: Introduce el identificador único (ID) de un registro específico si solo necesitas recuperar un solo elemento en lugar de una lista.
  • Top: Indica el número máximo de registros que deseas recibir en la respuesta. Es útil para limitar resultados o realizar paginación (ejemplo: “Top 10” para obtener solo los 10 primeros).
  • Username: Nombre de usuario asociado a una cuenta de Strapi. Se usa para la autenticación básica si no estás usando un Token API exclusivo.
  • Password: La contraseña secreta de tu cuenta de Strapi. Se usa junto con el Username para iniciar sesión y obtener acceso a los datos.

Salidas

Una vez que el componente ha realizado la conexión exitosamente, producirá la siguiente salida:

Data

Este es el resultado principal. Contiene los datos recuperados de Strapi. Dependiendo de tu configuración, esta salida será:

  • Un Objeto si buscabas un Entry ID específico.
  • Una Lista (Array) de objetos si recuperaste una lista de contenidos basada en el Content Type.

Esta salida Data es el puente para los siguientes nodos de tu automatización. Por ejemplo, puedes tomar este dato y enviarlo a un correo electrónico, guardarlo en una base de datos o procesarlo con una IA.

Ejemplo de Respuesta JSON

Si configuras el componente para buscar en el “Content Type” de articles y recuperas una lista, la salida Data se verá similar a este ejemplo realista: json [ { “id”: 1, “title”: “Bienvenido a Nappai”, “slug”: “bienvenido-a-nappai”, “status”: “published”, “created_at”: “2023-10-27T10:00:00.000Z” }, { “id”: 2, “title”: “Cómo automatizar tareas”, “slug”: “como-automatizar-tareas”, “status”: “draft”, “created_at”: “2023-10-28T12:30:00.000Z” } ]

Nota: Las claves exactas (como “title”, “status”) dependen de cómo hayas configurado tu Strapi, pero el componente siempre te entregará la estructura completa de los campos definidos.

Conectividad

Este componente es una fuente de información (Input). Sus salidas se conectan lógicamente a componentes que necesitan leer datos para tomar acciones, tales como:

  • Asistentes de IA (LLMs): Para analizar el contenido de los artículos y generar resúmenes o respuestas.
  • Editores de Texto/HTML: Para procesar el texto de las entradas antes de enviarlas.
  • Conectores de Email/Slack: Para notificar cuando una nueva entrada se ha creado o modificado.
  • Herramientas de Base de Datos: Para sincronizar o guardar los datos recuperados en otro sistema.

Ejemplo de Uso

Imagina que quieres crear un resumen semanal de tus últimos artículos publicados.

  1. Usas el componente Entries (Strapi).
  2. Seleccionas tu credencial de Strapi.
  3. En Content Type, escribes articles.
  4. En Item, puedes filtrar por { "status": "published" }.
  5. En Top, pones 5 para obtener solo los 5 más recientes.
  6. Conectas la salida Data a un componente de IA (ChatGPT/Claude) con el prompt: “Resume los siguientes artículos: {{Data}}.”

De esta forma, automatizas la lectura de tu CMS y la síntesis de información.

Consejos y Mejores Prácticas

  • Usa el campo “Top”: Si tu base de datos en Strapi es grande, siempre limita la cantidad usando el campo Top para evitar que tu automatización tarde demasiado o exceda los límites de la API.
  • Diferencia entre ID y Tipo: Si solo necesitas un dato específico (ej. “¿Cuál es el precio del producto con ID 5?”), usa el campo Entry ID. Si necesitas una lista para iterar sobre ella (ej. “¿Cómo son todos los productos?”), usa solo el Content Type.
  • Seguridad de Credenciales: Nunca compartas tu API Token ni tu Password públicamente. Usa siempre el campo Credential de Nappai para gestionar la seguridad.
  • Manejo de Errores: Si la salida falla, revisa primero si tu Base URL en la credencial es correcta y si tu Content Type existe tal cual lo escribiste en Strapi.

Consideraciones de Seguridad

  • Protección de Datos: Este componente maneja información sensible a través de las credenciales. Asegúrate de utilizar tokens API con permisos mínimos necesarios (solo lectura, si solo vas a recuperar datos) en lugar de usuarios con permisos de administrador.
  • Exposición de URLs: La Base URL de Strapi no debe ser modificada a un entorno no autorizado, ya que esto podría intentar conectar a bases de datos equivocadas.

INSTRUCCIÓN CRÍTICA: Si link_components está vacío [], NO incluyas esta sección en absoluto.