Page Content Viewer

⚠️ ADVERTENCIA DE DEPRECACIÓN

Este componente está deprecado y será eliminado en una versión futura de Nappai. Por favor, migra a los componentes alternativos recomendados.

El Page Content Viewer permite a los usuarios extraer el texto de una página de Notion directamente dentro de su dashboard de Nappai. Solo necesitas el ID de la página y la credencial de Notion que ya hayas configurado en el sistema.

¿Cómo funciona?

Cuando introduces el ID de la página, el componente hace una llamada HTTP a la API de Notion (https://api.notion.com/v1/blocks/{PAGE_ID}/children). Utiliza el token de integración que has guardado en la credencial “Notion API” para autenticarse. La respuesta contiene los bloques de la página (párrafos, encabezados, listas, imágenes, etc.). El componente recorre esos bloques, extrae el texto plano y los concatena en un solo bloque de texto. Si algo falla (por ejemplo, un ID inválido o un problema de red), devuelve un mensaje de error legible.

Entradas

Page ID

• Display name: Page ID
• Tipo: StrInput
• Descripción: The ID of the Notion page to retrieve.

Nota: Este componente no tiene operaciones, por lo que no se muestra la opción “Visible en”.

Credencial

Este componente requiere una credencial de tipo Notion API.

1. Configura la credencial: Ve a la sección de credenciales de Nappai y crea una nueva credencial llamada “Notion API”.
2. Añade el token: En la credencial, introduce el Notion Integration Token (puedes encontrarlo aquí).
3. Selecciona la credencial: En el campo “Credential” del componente, elige la credencial “Notion API” que acabas de crear.

Importante: Los campos de la credencial (token, contraseña, etc.) no aparecen en la sección de “Input Fields”.

Salidas

• Data
  Tipo: Data (método: run_model)
  Contenido: Texto plano de la página y un objeto data con la misma cadena bajo la clave content.

• Tool
  Tipo: Tool (método: build_tool)
  Uso: Puede ser utilizado por agentes de LangChain para recuperar el contenido de la página dentro de flujos de trabajo más complejos.

Ejemplo de Uso

1. Añade el componente al flujo de trabajo.
2. Introduce el ID de la página de Notion que quieres leer.
3. Selecciona la credencial “Notion API” en el campo “Credential”.
4. Ejecuta el flujo.
5. Revisa la salida: el panel de resultados mostrará el texto completo de la página. Si algo falla, verás un mensaje de error que indica la causa.

Tip: Puedes usar la salida Data para alimentar un componente de visualización de texto o para pasar el contenido a un modelo de IA que genere resúmenes.

Componentes Relacionados

• NotionDirectoryLoader – Carga la estructura de carpetas y páginas de Notion.
• NotionDatabaseQuery – Ejecuta consultas sobre bases de datos de Notion.
• NotionPageUpdater – Actualiza el contenido de una página de Notion.

Consejos y Mejores Prácticas

• Mantén tu token seguro: No lo compartas públicamente y revísalo periódicamente.
• Limita el acceso: Concede a la integración de Notion solo los permisos necesarios (lectura de páginas).
• Prueba con páginas pequeñas: La API devuelve bloques por página; si la página es muy grande, considera paginar los resultados.
• Maneja errores: Usa la salida de error para notificar a los usuarios cuando la página no se pueda recuperar.

Consideraciones de Seguridad

• Token confidencial: El token de integración debe guardarse como credencial y no exponerse en el código fuente.
• HTTPS: Todas las llamadas a la API de Notion se realizan sobre HTTPS, garantizando la confidencialidad de los datos.
• Control de acceso: Asegúrate de que solo los usuarios autorizados puedan configurar y usar la credencial “Notion API”.