Productividad y documentos
Conectar Notion a un agente de IA autónomo
Un agente de Atako conectado a Notion puede leer sus páginas y bases, y crear o modificar algunas, pero solo las que usted haya compartido explícitamente con él.
Flujos de trabajo posibles
Actualización semanal de una base de seguimiento
El agente consulta una base de Notion (proyectos, candidatos, cuentas de cliente) con query_database, la contrasta con datos recibidos por correo o por otro conector, crea las entradas nuevas con create_page y actualiza las entradas existentes con update_page. El formato y las propiedades de la base siguen siendo los que definió su equipo, el agente solo rellena la base más rápido de lo que lo haría una persona cada lunes por la mañana.
Actas de reunión estructuradas
A partir de un resumen de reunión recibido por otro canal, el agente crea una página en la carpeta correcta (create_page), y luego la estructura con párrafos de contexto (append_paragraph), una lista de decisiones (append_bulleted_list) y una lista de tareas con casillas para cada participante (append_to_do). Los puntos de atención se destacan con un callout, para que salten a la vista al releer.
Archivado periódico de una base de conocimiento
El agente consulta una base filtrada por fecha de última modificación (query_database), detecta las páginas que no se han movido en meses, deja un comentario explicando por qué propone archivarlas (create_comment) y luego las archiva (archive_page). No se pierde nada: una página archivada sigue siendo consultable y puede restaurarse manualmente si hace falta, lo que evita acumular bases saturadas de contenidos caducados que ya nadie consulta.
Acciones del conector
query_database (lectura)
Consulta una base con filtros y ordenaciones.
search (lectura)
Busca páginas o bases compartidas, por título.
get_page (lectura)
Obtiene una página y sus propiedades.
get_database (lectura)
Obtiene el esquema de una base.
list_block_children (lectura)
Lee el contenido detallado de una página.
create_page (escritura)
Crea una página en una base o bajo una página superior.
update_page (escritura)
Actualiza las propiedades de una página.
append_paragraph (escritura)
Añade un párrafo de texto a una página.
append_to_do (escritura)
Añade casillas de tareas a una página.
create_comment (escritura)
Añade un comentario o responde a un hilo existente.
archive_page (escritura)
Archiva una página en la papelera, reversible.
Requisitos previos
- Crear una integración interna en notion.so/my-integrations, asociada a un único workspace.
- Activar las capabilities Read content, Update content, Insert content, más los comentarios.
- Copiar el secreto de la integración (prefijo ntn_ o secret_), que se muestra una sola vez.
- Compartir cada página o base con la integración desde ••• y luego Connections.
- En Atako, un derecho de administración de integraciones para conceder el grant al agente.
Cómo conectar
- 1
Crear la integración de Notion
En notion.so/my-integrations, crear una integración, elegir el workspace, activar las capabilities, copiar el secreto.
- 2
Compartir las páginas con la integración
Abrir cada página o base que se vaya a dar al agente, hacer clic en ••• y luego en Connections, seleccionar la integración. Sin este paso, el token por sí solo no da acceso a nada.
- 3
Conectar Notion en Atako
En Ajustes, luego Integraciones, pegar el secreto copiado en el paso 1.
- 4
Conceder el grant al agente
Desde la página del agente (Integraciones de este agente) o desde la conexión (Gestionar accesos), seleccionar las acciones precisas que se van a autorizar y su alcance (solo lectura o lectura y escritura).
Por qué conectar un agente autónomo a Notion
Notion suele ser el lugar donde un equipo guarda lo que sabe: bases de seguimiento, documentación interna, actas de reunión. El problema es que esa información envejece rápido si nadie la actualiza. Un agente de Atako conectado a Notion mediante tool calling puede hacer ese trabajo de forma continua, en su propio entorno, sin que una persona tenga que abrir la base cada semana.
Lo que cambia respecto a una automatización de disparador clásica: el agente funciona de forma permanente. Puede recibir una información por correo, contrastarla con lo que ya existe en una base de Notion mediante query_database, y luego decidir por sí mismo si hay que crear una página o actualizar una entrada existente, dentro del marco de las acciones que se le han concedido.
El conector de Notion cubre 28 acciones (13 de lectura, 15 de escritura) según la documentación de Atako, desde la búsqueda de páginas hasta la creación de bases con su esquema de propiedades. Suficiente para cubrir tanto el ordenado de actas como la relectura de una base de conocimiento. Un uso típico: un agente que pilota la comunicación en torno a una release mantiene su documentación de Notion al día en paralelo a sus demás canales.
Límites y buenas prácticas
Notion exige un uso compartido explícito, página por página o base por base. Es una restricción de entrada, pero también una salvaguarda: un token que se filtrara solo daría acceso a lo que se ha compartido, nunca a todo el workspace.
La tasa de la API de Notion sigue siendo modesta: en promedio tres solicitudes por segundo por integración, con un tope por workspace que varía según el plan tarifario. En una base de varios miles de páginas, un agente que deba releerlo todo tendrá que repartir el trabajo.
El conector no permite la eliminación definitiva: archive_page mueve una página a la papelera, recuperable. Como con cualquier integración de Atako, cada acción está sujeta a un grant explícito (agente, acción, alcance): la conexión sola no da ningún acceso. Consulte el modelo de permisos y los planes.
Casos de uso relacionados
Integraciones complementarias
Preguntas frecuentes
¿Puede el agente modificar cualquier página de mi workspace de Notion?
No. El agente solo ve las páginas y bases compartidas explícitamente con la integración, mediante el menú Connections. Aunque esté compartida, una página solo puede modificarse si el grant del agente incluye una acción de escritura con el alcance adecuado.
¿Hace falta un plan de Notion de pago para conectar la API?
No, la API de Notion funciona tanto en el plan gratuito como en los planes de pago. Lo que cambia según el plan es el tope de solicitudes autorizadas por workspace.
¿Cómo se revoca el acceso del agente a Notion?
Hay dos opciones complementarias: retirar la integración de la lista de conexiones de una página, o revocar la conexión del lado de Atako. En ambos casos, el acceso se corta de inmediato para todos los agentes afectados.
¿Puede el agente eliminar una página de Notion de forma definitiva?
No. La única acción de eliminación disponible es archive_page, que mueve la página a la papelera sin destruirla. No existe una acción de eliminación permanente en este conector.
Qué leer a continuación
Fuentes
- Notion Docs, Create a Notion integration · consultado el 4 de septiembre de 2026
- Notion Docs, Request limits · consultado el 4 de septiembre de 2026
CTO de Atako
Este contenido fue redactado por los agentes de IA de Atako, y luego revisado, corregido y validado por Romain Laodicina, CTO de Atako.