6.01. Crear integraciones con la API de Notion

Una aclaración sobre las integraciones con otras aplicaciones

Una integración es la manera que tiene una API de conectarse con otra. Esta conexión se realiza a través de un bot, un usuario virtual al que invitaremos a nuestros proyectos y que será el encargado de extraer o insertar los datos de las páginas o bases de datos a las que le demos acceso.

Crear una integración en Notion (crear el bot)

Para crear nuestra primera integración en Notion:

• En la barra lateral, busca Settings & Members > Integrations
• Aquí verás todas las integraciones que hayas instalado en ese espacio
• Haz click en Develop your own integrations
• Se abrirá la página de My Integrations, un espacio dedicado a crear y gestionar las integraciones que vayas creando

En esta página puedes configurar tu bot. Basta con ponerle un nombre, una imagen y, muy importante, decidir a qué espacio de trabajo va a tener acceso ese bot.

Una vez configurada la integración, se te abrirá una página con los detalles:

• Internal Integration Token: Es la clave que permitirá al bot conectarse con otras herramientas y que estas puedan leer los datos de nuestras páginas o bases de datos.
• Integration Type: Por defecto viene marcada Internal Integration ya que todas las que crees serán de uso privado.

Instalar integraciones de otras herramientas

Notion ha llegado a acuerdos con aplicaciones como Zapier, Typeform y Automate.io. Hay dos formas distintas de conectar con ellas.

Instalación desde la plataforma externa

En el caso de Automate.io, al escribir "Notion" en el campo de búsqueda para crear tu primera automatización, ya te pedirá acceso a tu espacio de trabajo. Desde ahí tendrás que elegir qué páginas son a las que das acceso.

Instalación con el token interno

Otras plataformas, como Zapier, te pedirán un token interno para poder conectarse a tu espacio de trabajo. Este token es el que se generó cuando creaste tu bot.

Puedes acceder a él desde:

• El espacio My Integrations
• A través de Settings & Members > Integrations. Allí verás el bot que has creado → Selecciona los tres puntos ... y Copy internal Integration Token

Pega esta clave cuando la plataforma te lo pida.

Invitar al bot a nuestras páginas

En el caso de que la herramienta no nos haya hecho seleccionar las páginas a las que queremos darle acceso, tendremos que "invitar" manualmente a nuestro bot.

Como este bot es un usuario virtual, le invitaremos igual que haríamos con cualquier compañero de equipo:

• Vamos a la página que queramos conectar y pinchamos en Share
• Hacemos click en Add people, emails, groups, or integrations
• Se abrirá una ventana con las demás personas que tengan acceso y, más abajo, verás tus integraciones bajo el título Select an Integration
• Selecciona la integración (o bot) que quieras invitar a esta página

Una vez hecho, verás esa nueva integración en el menú Share de esa página.