Conexiones para la API de Notion

Puedes gestionar los tokens de acceso personal desde Notion. Activa el Modo desarrollador desde Ajustes y, a continuación, abre los tokens de acceso personal desde la sección de desarrollador en tu barra lateral. Visita nuestro Centro para obtener documentación, recursos y herramientas de gestión de conexiones.

¿Buscas tokens de administrador? Los tokens de Esta página funcionan dentro de un espacio de trabajo y gestionan el contenido de la página. Si necesitas ejecutar tareas de administrador de la organización, como exportar, suspensiones legales o cerrar la sesión de los usuarios, consulta Admin APIs para organizaciones Enterprise.

1. En la barra lateral izquierda, dirígete a Configuración y después a la pestaña Conexiones.

2. Solo los propietarios del espacio de trabajo podrán acceder a la pestaña Conexiones y crear integraciones. Si no eres administrador, ponte en contacto con el administrador de tu espacio de trabajo o utiliza un espacio de trabajo distinto.

3. Activa el Modo desarrollador y, a continuación, abre los tokens de acceso personal desde la sección de desarrollador en tu barra lateral.

4. Haz clic en + Nuevo ítem de conexión.

5. Proporciona un Nombre para tu conexión. Opcionalmente, también puedes subir una imagen para usarla como logotipo.

6. Utiliza el menú desplegable para especificar con qué Espacio de trabajo asociado quieres usar esta conexión.

   

   Nota: Asegúrate de haber iniciado sesión en Notion en la web con la misma cuenta que has usado en la aplicación de escritorio. ¡De lo contrario, no verás la cuenta ni los espacios de trabajo correctos!

   

7. ¡Tu conexión interna se ha añadido correctamente! Ahora podrás verla en tu espacio de trabajo, en el menú Configuración → Conexiones.

8. Haz clic en ••• junto a la conexión interna para recuperar el token de conexión interna. Necesitarás este token para cualquier automatización o flujo de trabajo basado en la API que cree tu equipo, o bien para vincular tu espacio de trabajo a algunas plataformas de socios.

En principio, todas las conexiones añadidas recientemente se consideran internas. Si eres un desarrollador que trabaja en una conexión pública, usa primero las instrucciones anteriores para crear una conexión interna.

Después, completa los pasos que se indican en nuestra guía para desarrolladores para convertirla en una conexión pública.

Cuando creas una conexión pública, eliges quién puede instalarla:

• Cualquier espacio de trabajo: cualquiera puede instalar tu conexión en su propio espacio de trabajo de Notion.

• Espacios de trabajo seleccionados: solo los espacios de trabajo que indiques pueden instalar tu conexión.

Elige Espacios de trabajo seleccionados cuando estés creando algo solo para tu propia empresa y no quieras que otras organizaciones puedan instalarlo.

Notion comprueba esto cada vez que alguien instala tu conexión. Si su espacio de trabajo no está en tu lista, la instalación se detiene y se muestra un error.

Solo las conexiones que cualquiera puede instalar pueden aparecer en la galería de conexiones. Una conexión limitada a espacios de trabajo seleccionados no aparecerá allí.

Si eres titular de una conexión, esta aparece en el portal para desarrolladores de cada espacio de trabajo que pueda instalarla, que ya la tenga instalada o en el que la hayas creado.

Cada conexión pública tiene un espacio de trabajo donde la creas y la pruebas. Puedes cambiar a otro distinto sin tener que empezar de cero.

1. Abre tu conexión en el portal para desarrolladores.

2. Ve a los ajustes de la conexión.

3. Elige el espacio de trabajo en el que quieres desarrollar la conexión.

Notion vincula la conexión al espacio de trabajo que has elegido. No necesitas crear otra.

Durante el proceso de configuración de la aplicación, los desarrolladores podrán elegir el nivel de acceso requerido del usuario.

• Capacidades de contenido:

  • Solo leer contenido

  • Solo escribir contenido

  • Insertar contenido

• Capacidades de usuario:

  • Sin información de usuario

  • Leer información de usuario (sin incluir la dirección de correo electrónico del usuario)

  • Leer información de usuario (incluido el correo electrónico)

Cuando los usuarios instalen conexiones, se mostrará este nivel de acceso. También aparecerá en el menú Compartir de cualquier página a la que se haya añadido la conexión. Más información sobre la instalación de conexiones en un espacio de trabajo →

Los webhooks de conexión permiten a las conexiones supervisar y responder a los cambios en los espacios de trabajo de Notion en tiempo real.

Cuando hay modificaciones en las páginas o bases de datos compartidas con la conexión, Notion envía automáticamente notificaciones al punto final del webhook, lo que permite que tu conexión actualice otras herramientas, ejecute tareas automatizadas o muestre los últimos cambios al instante.

Accede a nuestra documentación para desarrolladores para consultar las instrucciones.

Las acciones de webhook y los Webhooks de conexiones comparten algunas similitudes: ambos tienen disparadores y pueden enviar eventos a servicios de terceros. Sin embargo, los Webhooks de conexiones ofrecen capacidades más amplias:

• Pueden monitorear la actividad en múltiples espacios de trabajo.

• Pueden manejar un número ilimitado de acciones.

Por el contrario, las acciones de webhook están diseñadas para casos de uso más simples y se configuran a través de automatizaciones de bases de datos con un conjunto limitado de disparadores.