Page

El componente Page te permite interactuar con las páginas de Notion directamente desde tu dashboard de Nappai. Con él puedes crear nuevas páginas, actualizar las existentes, añadir contenido en formato Markdown, listar páginas de una base de datos y mucho más, todo sin salir de la plataforma.

¿Cómo funciona?

El componente se conecta a la API oficial de Notion mediante un token de integración que debes configurar previamente en la sección de credenciales de Nappai. Cuando lo activas, el componente envía peticiones HTTP a los endpoints de Notion para crear, leer, actualizar o listar páginas según la operación seleccionada. Si habilitas el Mapping Mode, el componente puede procesar varios registros a la vez, lo que facilita la automatización de tareas en lote.

Operaciones

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

Create Page from Database: Crea una nueva página dentro de una base de datos de Notion, añadiendo propiedades y contenido.
List: Recupera una lista de páginas de una base de datos o todas las páginas accesibles, con la posibilidad de filtrar por título.
Update Page: Modifica las propiedades y el contenido de una página existente.
Content Page: Añade contenido Markdown a una página ya existente.
Create Page: Crea una página independiente, sin necesidad de asociarla a una base de datos.

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 ejecutar.
- Visible en: Create Page from Database, List, Update Page, Content Page, Create Page
Page/Block ID: El ID de la página o bloque donde añadir el contenido.
- Visible en: Content Page
Database ID: El ID de la base de datos de Notion.
- Visible en: Create Page from Database
Include ID Database: Si se habilita, añade el ID de la base de datos a las propiedades.
- Visible en: Create Page from Database
Mapping Mode: Habilita el modo de mapeo para procesar múltiples registros en lote.
- Visible en: Create Page from Database, List, Update Page, Content Page, Create Page
Markdown Text: El texto en Markdown que se convertirá en bloques de Notion o se añadirá al contenido de la página.
- Visible en: Create Page from Database, Create Page, Content Page
Page ID: El ID de la página de Notion que se va a recuperar o usar como padre.
- Visible en: Update Page, Content Page
Parent Page ID: El ID de la página padre donde se creará la nueva página.
- Visible en: Create Page
Properties (JSON): Las propiedades de la nueva página en formato JSON.
- Visible en: Create Page from Database, Create Page
Search by title: Texto para buscar páginas por título y devolver sus propiedades. Deja vacío para listar todas las páginas accesibles.
- Visible en: List
Title: Título de la nueva página de Notion.
- Visible en: Create Page from Database, Create Page
Tool Name: Nombre del tool que se mostrará al agente cuando el componente esté conectado como herramienta.
- Visible en: Create Page from Database, List, Update Page, Content Page, Create Page
Tool Description: Descripción detallada de lo que hace esta herramienta.
- Visible en: Create Page from Database, List, Update Page, Content Page, Create Page
Tools arguments metadata: Define los metadatos de los argumentos para las herramientas.
- Visible en: Create Page from Database, List, Update Page, Content Page, Create Page

Nota: Este componente requiere una credencial de tipo Notion API.

Configura la credencial en la sección de credenciales de Nappai.

Selecciona esa credencial en el campo Credential del componente.

Salidas

Data: Devuelve los datos obtenidos o modificados en formato estructurado (JSON).
Tool: Proporciona una representación del componente como herramienta para que los agentes de IA la utilicen.

Ejemplo de Uso

1. Crear una página desde una base de datos

Selecciona la operación Create Page from Database.
Ingresa el Database ID y el Title de la nueva página.
Proporciona las Properties (JSON) con los campos que deseas rellenar.
(Opcional) Añade contenido Markdown en Markdown Text.
Ejecuta el flujo y la página aparecerá en la base de datos indicada.

2. Listar páginas por título

Selecciona la operación List.
En Search by title escribe el término que buscas (puedes dejarlo vacío para listar todas).
Ejecuta el flujo y obtendrás una lista de páginas con sus propiedades.

Componentes Relacionados

NotionDatabase: Gestiona bases de datos de Notion (crear, actualizar, listar).
NotionBlocks: Manipula bloques individuales dentro de una página.
NotionUsers: Obtiene información sobre usuarios de Notion.

Consejos y Mejores Prácticas

Usa el Modo de Mapeo cuando necesites procesar varias páginas a la vez; evita ejecutar el componente de forma individual para cada registro.
Valida el JSON de las propiedades antes de enviarlo; un formato incorrecto puede generar errores de la API.
Limita el uso de Markdown a bloques simples (encabezados, listas, párrafos) para evitar problemas de renderizado.
Revisa los permisos de tu integración de Notion: asegúrate de que tenga acceso a las bases de datos y páginas que vas a manipular.

Consideraciones de Seguridad

El token de integración de Notion debe mantenerse confidencial; no lo compartas en el código ni lo expongas en logs.
Configura la credencial en la sección de credenciales de Nappai y no la incluyas en los flujos de datos.
Si compartes el flujo con otros usuarios, asegúrate de que tengan los permisos adecuados en Notion para evitar accesos no autorizados.