Fuente Notion

Muchos equipos tienen su documentación en Notion: procesos, playbooks, onboarding. Con esta integración conviertes esas páginas en un bot consultable.

Conexión

Necesitas una Notion Internal Integration (NO una Public OAuth Integration). Se configura en 5 minutos:

1. Entra en notion.so/my-integrations y clica New integration.
2. Dale un nombre (rag.art) y elige el workspace.
3. Copia el Internal Integration Token (empieza por secret_…).
4. Ve a la página/base de datos que quieras indexar en Notion, menú ··· → Connections → añade la integración que creaste.
5. En rag.art → /bots/<id>/documents → Añadir fuente → Notion. Pega el token y:

• Database ID — si quieres indexar una base entera (todas las rows).
• Page ID — si quieres indexar una página y sus subpáginas.

Los IDs se leen desde la URL de la página/DB en Notion (el hash tras el slug).

1. Guarda. La ingesta respeta sub-páginas hasta 3 niveles de profundidad.

Qué se indexa

• Texto: párrafos, headings, callouts, to-dos (con estado).
• Código: bloques de código con su lenguaje.
• Tablas sencillas (se serializan como markdown).
• Properties de bases de datos (título, selectores, fechas) — se añaden como frontmatter.

Qué no se indexa (por ahora)

• Embeds de vídeos, Figma, Loom (solo el enlace).
• Bases de datos con filtros dinámicos (se ingesta el contenido visible con los permisos de la integración).
• Imágenes (se ingesta el alt text, no el contenido).

Actualización

• Notion NO ofrece webhooks estables para Internal Integrations → rag.art re-ingesta cada fuente Notion cada 24h (next_crawl_at).
• Puedes forzar un re-crawl manualmente desde /documents.

Privacidad

• El token es tuyo: puedes revocarlo desde Notion en cualquier momento; rag.art marcará la fuente como disconnected.
• rag.art NO modifica tu Notion. La integración solo tiene permisos de lectura sobre las páginas que explícitamente compartes con ella.

Multi-workspace

Puedes añadir varias fuentes Notion al mismo bot, apuntando a distintos workspaces/integraciones. Útil si tienes wikis separadas de marketing, producto, operaciones.