List Pages

⚠️ 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 se conecta a la API de Notion para obtener las páginas de una base de datos específica.

1. Credencial: Usa el token de integración de Notion que ya has configurado en Nappai.
2. Entrada: Se envía el ID de la base de datos y, opcionalmente, un JSON con filtros y ordenamientos.
3. Petición: El componente hace una llamada HTTP POST a https://api.notion.com/v1/databases/{database_id}/query.
4. Respuesta: Los resultados se transforman en objetos Data que contienen la información de cada página (id, url, fechas, propiedades).
5. Salida: Devuelve una lista de registros Data y también un Tool que puede ser usado por agentes de IA.

Entradas

Campos de Entrada

• Database ID: El identificador único de la base de datos de Notion que quieres consultar.
• Database query (JSON): Una cadena JSON que define los filtros y ordenamientos que se aplicarán. Si lo dejas vacío, se devolverán todas las páginas sin filtrado ni orden.

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 (clave secreta), 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: No incluyas el token directamente en los campos de entrada; la credencial ya lo gestiona Nappai de forma segura.

Salidas

• Data: Cada registro contiene la información de una página de Notion (id, url, fechas, propiedades).
• Tool: Un objeto Tool que permite usar la misma funcionalidad dentro de agentes de IA.

Ejemplo de Uso

1. Configura la credencial: Crea y selecciona la credencial Notion API.
2. Introduce el ID de la base de datos: Copia el ID que aparece en la URL de tu base de datos de Notion.
3. Define la consulta (opcional):

   {
     "filter": {
       "property": "Status",
       "select": { "equals": "Done" }
     },
     "sorts": [
       { "timestamp": "created_time", "direction": "descending" }
     ]
   }

4. Ejecuta el componente: Haz clic en Run y observa la lista de páginas que cumplen con el filtro y orden.
5. Usa los resultados: Puedes pasar la salida Data a otro componente, como un visualizador de tablas, o usar el Tool en un agente de IA para automatizar tareas basadas en el contenido de las páginas.

Componentes Relacionados

• NotionCreatePage – Crea una nueva página en una base de datos de Notion.
• NotionUpdatePage – Actualiza los campos de una página existente.
• NotionGetPage – Recupera los detalles de una página específica.
• NotionSearch – Busca páginas en todas las bases de datos de tu cuenta.

Consejos y Mejores Prácticas

• Prueba con filtros simples antes de usar consultas complejas para evitar errores de formato JSON.
• Mantén la consulta JSON corta; Notion limita el tamaño de la carga útil.
• Revisa los permisos de tu integración en Notion para asegurarte de que tiene acceso a la base de datos que quieres consultar.
• Utiliza la salida Data para alimentar visualizaciones o flujos de trabajo posteriores, como enviar notificaciones o actualizar otras aplicaciones.

Consideraciones de Seguridad

• El token de integración de Notion debe mantenerse confidencial; no lo compartas en código público.
• Configura la credencial con los permisos mínimos necesarios (solo lectura si solo vas a listar páginas).
• Revisa los logs de Nappai para detectar accesos inesperados a la API de Notion.