Conexiones para la API de Notion

Entra en nuestro centro para desarrolladores, donde encontrarás documentación, recursos y herramientas de gestión de conexiones.

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 usa un espacio de trabajo distinto.

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

4. Mis conexiones se abrirá en tu navegador predeterminado. Haz clic en el botón + Nueva conexión.

5. Pon un nombre a tu conexión. Otra opción que tienes es subir una imagen y 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! 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 correspondiente. Necesitarás este token para cualquier automatización o flujo de trabajo basado en la API que cree tu equipo, o bien para enlazar tu espacio de trabajo a algunas plataformas asociadas.

Todas las conexiones recién añadidas en un principio son internas. Si eres un desarrollador que trabaja en una conexión pública, primero sigue 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.

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 cómo instalar 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 webhooks y los webhooks de conexión comparten algunas similitudes: ambos tienen disparadores y pueden enviar eventos a servicios de terceros. Sin embargo, los webhooks de conexión ofrecen funciones 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.