Create Page

Create Page is a simple tool that lets you add a new page to a Notion database directly from your Nappai dashboard.

⚠️ 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.

¿Cómo funciona?

El componente envía una solicitud HTTP POST a la API de Notion (https://api.notion.com/v1/pages).

1. Credencial – Usa el token de integración de Notion que ya has guardado en la sección de credenciales de Nappai.
2. Datos de entrada –
   • Database ID: el identificador de la base de datos donde se creará la página.
   • Properties (JSON): un string con el JSON que describe las propiedades de la nueva página (título, texto, fechas, etc.).
3. Solicitud – El componente construye el cuerpo de la petición con el database_id y las properties, añade los encabezados necesarios (Authorization, Content‑Type, Notion‑Version) y la envía.
4. Respuesta – Si la creación es exitosa, devuelve los datos de la página creada; si ocurre algún error, devuelve un mensaje de error legible.

Entradas

Campos de Entrada

• Database ID: El identificador de la base de datos de Notion donde se añadirá la página.
• Properties (JSON): Un string JSON que describe las propiedades de la nueva página (por ejemplo, título, contenido, fechas, etc.).

Credencial

Este componente necesita una credencial de tipo Notion API.

1. Ve a la sección de credenciales de Nappai y crea una nueva credencial llamada “Notion API”.
2. En el campo Notion Integration Token (password) pega el token que obtuviste al crear la integración en Notion.
3. Guarda la credencial y, en el componente, selecciona esa credencial en el campo Credential.

Nota: Los campos de la credencial (como el token) no aparecen en la lista de entradas del componente.

Salidas

• Data: Tipo Data. Contiene un texto con las propiedades creadas y, opcionalmente, los datos completos de la página.
• Tool: Tipo Tool. Un StructuredTool que puede ser usado por un LLM para crear páginas de forma programática.

Ejemplo de Uso

1. Configura la credencial:

   • En Nappai, crea una credencial “Notion API” con tu token de integración.
   • Selecciónala en el componente.

2. Añade el componente al flujo de trabajo.

3. Introduce:

   • Database ID: abcd1234efgh5678ijkl9012
   • Properties (JSON):

     {
       "Name": {
         "title": [
           {
             "text": {
               "content": "Nueva Página de Prueba"
             }
           }
         ]
       },
       "Status": {
         "select": {
           "name": "En Progreso"
         }
       }
     }

4. Ejecuta el flujo.

   • En la salida Data verás algo como:

     Created page properties:
     Name: Nueva Página de Prueba
     Status: En Progreso

   • La salida Tool puede ser usada por otro componente LLM para crear más páginas de forma dinámica.

Componentes Relacionados

• NotionPageUpdater – Actualiza una página existente en Notion.
• NotionDatabaseLister – Lista las bases de datos disponibles en tu cuenta de Notion.
• NotionPageDeleter – Elimina una página de Notion.

Consejos y Mejores Prácticas

• Valida tu JSON antes de enviarlo; un error de sintaxis evitará la creación de la página.
• Revisa los permisos de tu integración de Notion; necesita acceso de escritura a la base de datos.
• Usa la salida Tool cuando quieras que un modelo de IA decida dinámicamente qué página crear.
• Monitorea los logs en Nappai para detectar errores HTTP o de autenticación.

Consideraciones de Seguridad

• Protege tu token: No lo compartas públicamente y almacénalo como credencial segura en Nappai.
• Limita los permisos de la integración de Notion al mínimo necesario (solo escritura en las bases de datos que usarás).
• Revisa los logs de errores para detectar intentos de acceso no autorizados.