Saltearse al contenido
Nappai Documentation

Update Page Property

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

Esta herramienta permite modificar las propiedades de una página existente en Notion directamente desde el dashboard de Nappai. Es útil cuando quieres automatizar la actualización de campos como fechas, etiquetas o textos sin salir de tu flujo de trabajo.

¿Cómo funciona?

El componente envía una solicitud HTTP PATCH al endpoint de la API de Notion (https://api.notion.com/v1/pages/{page_id}).

  1. Autenticación: Usa el token de integración de Notion que se guarda en la credencial Notion API.
  2. Datos: Recibe el ID de la página y un objeto JSON con las propiedades que deseas cambiar.
  3. Respuesta: Si la petición es exitosa, devuelve la página actualizada; si ocurre un error, muestra un mensaje descriptivo.

Entradas

Credencial requerida

Para usar este componente debes haber creado previamente una credencial de tipo Notion API en la sección de credenciales de Nappai.

  1. Ve a Credenciales → Agregar credencial → Notion API.
  2. Ingresa tu Notion Integration Token (puedes obtenerlo siguiendo la guía oficial de Notion).
  3. En el componente, selecciona la credencial creada en el campo Credential.

Campos de Entrada

  • Page ID: The ID of the Notion page to retrieve.
    • Es el identificador único de la página que quieres actualizar.
  • Properties: The properties to update on the page (as a JSON string or a dictionary).
    • Debes proporcionar un objeto JSON que contenga las propiedades que deseas cambiar. Por ejemplo: 
      {
        "Status": { "select": { "name": "In Progress" } },
        "Due Date": { "date": { "start": "2025-12-31" } }
      }

Salidas

  • Data: Devuelve un objeto Data con un texto legible que muestra las propiedades actualizadas y el objeto completo de la página.
  • Tool: Devuelve una herramienta estructurada (Tool) que puede ser utilizada por agentes de IA para llamar a la misma función de actualización dentro de flujos más complejos.

Ejemplo de Uso

  1. Configura la credencial: Asegúrate de haber creado y seleccionado la credencial Notion API.
  2. Añade el componente al flujo.
  3. Introduce los valores:
    • Page ID: abcd1234efgh5678ijkl9012
    • Properties: 
      {
        "Priority": { "select": { "name": "High" } },
        "Last Updated": { "date": { "start": "2025-10-07" } }
      }
  4. Ejecuta el flujo.
  5. Resultado: El panel mostrará algo como:

Updated page properties: Priority: High Last Updated: 2025-10-07

Componentes Relacionados

  • NotionPageCreate – Crea una nueva página en Notion.
  • NotionPageRetrieve – Obtiene los datos de una página existente.
  • NotionDatabaseList – Lista las bases de datos disponibles en tu cuenta de Notion.

Consejos y Mejores Prácticas

  • Valida el JSON antes de enviarlo: un error de formato puede detener todo el flujo.
  • Limita los cambios a las propiedades que realmente necesitas actualizar para evitar sobrescribir datos importantes.

Consideraciones de Seguridad

  • Mantén tu token de integración en secreto; no lo compartas públicamente.
  • Utiliza credenciales con el menor nivel de permiso necesario (por ejemplo, solo acceso a la base de datos específica).