Crear una app OAuth de Notion para OpenConnector

Usa una conexión pública de Notion cuando OpenConnector necesite que los usuarios autoricen páginas o bases de datos del espacio de trabajo a través de OAuth. Notion también admite secretos de integración internos, pero OAuth es la ruta correcta cuando quieres un flujo de autorización de usuario.

Servicio de OpenConnector

ID de servicio	Proveedor	Tipo de autenticación
`notion`	Notion	OAuth2

El proveedor OAuth de Notion de OpenConnector solicita capacidades como read_content, insert_content y update_content.

Requisitos previos

Un entorno de ejecución de OpenConnector en funcionamiento.
Acceso al portal para desarrolladores de integraciones de Notion.
Permiso para crear una conexión pública.
El origen de OpenConnector que los usuarios abren en el navegador, como http://localhost:3000 o https://connect.example.com.

Paso 1: Establecer la URL de callback de OpenConnector

Construye la URL de callback añadiendo /oauth/callback a tu origen de OpenConnector. Para pruebas locales, usa http://localhost:3000/oauth/callback. Para una implementación pública, establece OOMOL_CONNECT_ORIGIN, reinicia OpenConnector y usa la URL de callback pública, como https://connect.example.com/oauth/callback.

Paso 2: Crear una conexión pública de Notion

En el portal para desarrolladores de integraciones de Notion:

Crea una nueva conexión pública.
Completa el nombre de la conexión y los detalles del espacio de trabajo.
Añade la URL de callback exacta de OpenConnector en la configuración del URI de redirección de OAuth.
Elige el ámbito de instalación que coincida con tu caso de uso.
Configura las capacidades de contenido que necesiten las acciones de OpenConnector.
Guarda la conexión.

La guía oficial de Notion es Authorization. Notion indica que el ámbito de instalación se selecciona al crear una conexión pública, así que elígelo con cuidado.

Paso 3: Copiar las credenciales del cliente

Desde la configuración de la conexión pública de Notion, copia:

Valor de Notion	Campo de OpenConnector
ID de cliente OAuth	`clientId`
Secreto de cliente OAuth	`clientSecret`

Paso 4: Guardar el cliente de Notion en OpenConnector

Usa la consola web de OpenConnector:

Abre la consola web de OpenConnector, como http://localhost:3000.
Abre Providers y selecciona Notion.
Elige Configure OAuth Client o Edit OAuth Client.
Pega el ID de cliente y el secreto de cliente de Notion.
Elige Save OAuth Client.

Paso 5: Conectar y probar

Después de guardar el cliente OAuth, elige Connect en la página del proveedor Notion. Elige el contenido del espacio de trabajo de Notion que quieres compartir, aprueba el acceso, vuelve a OpenConnector y confirma que la página del proveedor muestra el espacio de trabajo como conectado.

Usa notion.search o notion.list_users como una acción de prueba de bajo riesgo desde la lista de acciones de la consola.

Solución de problemas

Síntoma	Qué comprobar
Notion rechaza el URI de redirección	El URI de redirección de OAuth en Notion debe coincidir exactamente con `<openconnector-origin>/oauth/callback`.
Falta contenido compartido	Durante la autorización, selecciona las páginas o bases de datos a las que debe acceder la conexión. El acceso de Notion está limitado al contenido compartido.
Fallan las acciones de escritura	Confirma que la conexión de Notion tiene capacidades de insertar o actualizar contenido y que la página/base de datos compartida permite la operación.
Se conecta el espacio de trabajo equivocado	Inicia la autorización en un perfil de navegador con la sesión iniciada en el espacio de trabajo de Notion deseado.
Confusión entre token de integración interna y OAuth	Usa el ID de cliente y el secreto de cliente de OAuth para esta guía. Los secretos de integración internos son una ruta de configuración diferente.