Puesta en marcha y configuración - Notion
Qué hace esta integración
La integración con Notion crea una página en una base de datos elegida directamente desde la pantalla de detalle de un error en DockRay - sin copiar a mano el mensaje, el lugar del fallo ni la pila de llamadas. Crear la página guarda un vínculo permanente: un error de DockRay con una página de Notion. Cuando la página pasa al grupo de estados Complete, DockRay marca el error como resuelto por sí solo. La lectura es periódica: el comando thor:sync-notion comprueba las páginas vinculadas cada cinco minutos - Notion solo ofrece webhooks a aplicaciones públicas, y una integración interna de un cliente no lo es.
Qué necesitas del lado de Notion
- permiso para crear integraciones en el workspace de Notion,
- una base de datos a la que deban llegar los tickets,
- un momento para compartir esa base de datos con la integración recién creada - el paso que más fácil se olvida, y sin el cual la integración no ve nada.
A diferencia de Jira, aquí no hay dirección de instancia ni correo - Notion tiene una única API bajo una dirección fija, autenticada solo con el token de la integración.
Crear la integración y copiar el token
En los ajustes de integraciones de Notion (nivel workspace) crea una nueva integración interna y copia el token generado. El token permanece visible en Notion en todo momento, pero en DockRay - como cualquier otro secreto de esta clase - se cifra y nunca vuelve al formulario una vez guardado.
Compartir una base de datos con la integración
Una integración de Notion no ve ninguna base de datos por defecto - no es una limitación de DockRay, es así como funciona Notion: el acceso hay que concederlo a mano. Abre la base de datos que quieras conectar y, en Connections, añade la integración creada antes. Solo después de ese paso la base de datos aparece en la lista de DockRay.
Conexión a nivel de cuenta y de proyecto
En el panel de DockRay ve a Ajustes → Notion y pega el token de la integración - esta conexión sirve a todos los proyectos de la cuenta que no tengan token propio. En Ajustes del proyecto → Notion, elige la base de datos que debe recibir los tickets, un responsable por defecto y un estado inicial opcional. Los nombres de las propiedades de la base de datos no importan aquí - DockRay reconoce los campos por su tipo (título, persona, estado), no por el nombre que alguien haya escrito en Notion.
La primera prueba
Crea una página de Notion a partir de cualquier error existente en un proyecto de pruebas. Comprueba en Notion que la página ha llegado a la base de datos correcta, con título, descripción diagnóstica y un enlace al panel de DockRay. Junto al error en DockRay debería aparecer ahora un enlace a la página creada.