Saltearse al contenido
Nappai Documentation

List Users

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

Este componente permite obtener la lista completa de usuarios registrados en tu cuenta de Notion. Se conecta a la API de Notion y devuelve cada usuario con su ID, tipo, nombre y avatar, lo que facilita la integración de datos de usuarios en tus flujos de trabajo de Nappai.

¿Cómo funciona?

El componente hace una llamada HTTP GET al endpoint https://api.notion.com/v1/users de la API de Notion.
Para autenticar la solicitud, utiliza el Notion Integration Token que se almacena en la credencial “Notion API”. La respuesta JSON se procesa y se transforma en una lista de objetos con los campos id, type, name y avatar_url. Cada objeto se envuelve en un registro Data que incluye tanto el texto legible como los datos estructurados, y también expone un Tool que puede ser usado por agentes de IA dentro de Nappai.

Entradas

Para usar este componente debes:

  1. Configurar la credencial Notion API en la sección de credenciales de Nappai.
    • La credencial requiere el Notion Integration Token (password).
    • Puedes crear el token siguiendo la guía oficial de Notion: aquí.
  2. Seleccionar esa credencial en el campo Credential del componente.

No hay otros campos de entrada adicionales.

Salidas

  • Data (método: run_model)
    Cada registro contiene un texto formateado con la información del usuario y un objeto con los datos estructurados (id, type, name, avatar_url).

  • Tool (método: build_tool)
    Un StructuredTool llamado notion_list_users que puede ser invocado por agentes de IA para obtener la lista de usuarios directamente desde la API.

Ejemplo de Uso

  1. Arrastra el componente List Users al lienzo del dashboard.
  2. En la sección de credenciales, selecciona la credencial “Notion API” que ya configuraste.
  3. Ejecuta el flujo.
  4. En la salida, verás una lista de registros Data con la información de cada usuario.
  5. Si necesitas usar la lista dentro de un agente de IA, selecciona el Tool notion_list_users en la configuración del agente.

Componentes Relacionados

  • NotionDirectoryLoader – Carga directorios y bases de datos de Notion.
  • NotionUserList (versión legacy) – Versión anterior del mismo componente; se recomienda migrar a la nueva implementación.

Consejos y Mejores Prácticas

  • Manejo de errores: La API de Notion puede devolver errores de límite de tasa. Implementa reintentos con backoff exponencial.
  • Seguridad: Guarda el token de integración en un almacén seguro y evita exponerlo en logs.
  • Escalabilidad: Si tu cuenta tiene muchos usuarios, considera paginar la respuesta (aunque el endpoint actual devuelve todos los usuarios en una sola llamada).
  • Reutilización: Usa el Tool en flujos de agentes para automatizar tareas que requieran la lista de usuarios sin escribir código adicional.

Consideraciones de Seguridad

  • El Notion Integration Token es una credencial sensible. Asegúrate de que solo los usuarios autorizados tengan acceso a la sección de credenciales.
  • No compartas el token en repositorios públicos ni lo incluyas en archivos de configuración que puedan ser versionados.
  • Si sospechas que el token ha sido comprometido, revísalo inmediatamente y genera uno nuevo en la consola de Notion.