Conexiones API de Notion

Visita nuestro centro para desarrolladores para acceder a documentación, recursos y herramientas de gestión de conexiones.

1. En la barra lateral izquierda, ve al Configuración y luego 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 admin, ponte en contacto con tu admin o usa otro espacio de trabajo.

3. Haz clic en el enlace Desarrolla tus propias conexiones en la parte inferior.

4. Se abrirá la página Mis conexiones de modo predeterminado en tu navegador. Haz clic en el botón + Nuevo ítem .

5. Ingresa un Nombre para tu conexión. Opcionalmente, puedes cargar una imagen para usarla como Logotipo.

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

   

   Nota: Procura haber iniciado sesión en Notion desde la web con la misma cuenta que usaste en la app de escritorio. De lo contrario, no verás la cuenta ni los espacios de trabajo correctos.

   

7. Tu conexión interna se agregó correctamente. Ahora podrás verla en tu espacio de trabajo, en el Menú de 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 las automatizaciones o flujos de trabajo basados en la API que cree tu equipo o para vincular tu espacio de trabajo a algunas plataformas asociadas.

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

Luego, sigue las instrucciones de nuestra guía para desarrolladores para convertirla en una conexión pública.

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

• Permisos de contenido:

  • Solo leer contenido

  • Solo escribir contenido

  • Insertar contenido

• Permisos 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 se mostrará en el menú Compartir de cualquier página a la que se haya agregado la conexión. Descubre más sobre la instalación de conexiones en un espacio de trabajo →

Los webhooks de conexiones permiten a las conexiones monitorear y responder a los cambios en los espacios de trabajo de Notion en tiempo real.

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

Para obtener instrucciones, visita nuestra documentación para desarrolladores.

Las acciones de webhook y los webhooks de conexiones comparten algunas similitudes—ambos tienen activadores 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 webhooks 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 activadores.