6.01. Crear integraciones con la API de Notion

6.01. Crear integraciones con la API de Notion

Una aclaración sobre las integraciones con otras aplicaciones

Si te has dado un paseo por internet, te habrás dado cuenta de que a la hora de hablar de conectar aplicaciones, se usa mucho la palabra "integration" pero, ¿qué es realmente esto, para qué nos sirve y cómo podemos crear nosotros una para empezar a jugar?

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. Así que, de ahora en adelante, cuando veas que se habla sobre "integration", puedes pensar en ese compañero virtual.

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

Para crear nuestra primera integración en Notion, tendremos que hacer lo siguiente:

  • En la barra lateral, busca Settings & Members > Integrations
  • Aquí verás todas las integraciones que hayas instalado en ese espacio. Si esta es tu primera incursión a la API de Notion, no tendrás ninguna ;)
  • Haz click en Develop your own integrations
  • image
  • Se abrirá la página de My Integrations, un espacio dedicado a crear y, posteriormente, a gestionar las integraciones que vayas creando.
  • image

Aquí es donde puedes configurar tu bot. Como ves, es muy sencillo, basta con ponerle un nombre, una imagen y, muy importante, decidir a qué espacio de trabajo va a tener acceso ese bot. (Esto sólo es relevante si tienes más de uno, pero asegúrate de estar en aquel al que quieres "invitar" al bot)

image

Una vez has configurado la integración, se te abrirá esta página con los detalles de la misma:

  • Internal Integration Token: Es la clave que permitirá al bot conectarse con otras herramientas y que estas puedan así leer los datos de nuestras páginas o bases de datos. Es la que tienes que pegar si una herramienta externa te pide el Token de Notion ;)
  • Integration Type: Por defecto viene marcada Internal Integration ya que, a no ser que seas desarrollador y estés construyendo una integración pública, todas las que crees serán de uso privado.
image

Una vez hemos creado nuestra primer integración, verás que si vuelves al apartado Integrations ya SI que aparecerá una. Ese bot que acabas de crear.

image

Instalar integraciones de otras herramientas

A día de hoy, Notion ha llegado a acuerdos con 3 aplicaciones que ya tienen una integración con Notion. Estas aplicaciones son 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.

image

Desde ahí tendrás que elegir qué páginas son a las que das acceso (en mi caso acabé eligiendo todas 😅)

Desde este momento, Notion y Automate.io están conectados y esta última tiene acceso a todas las páginas a las que tú le hayas dado acceso.

Si vuelves ahora a Integrations, verás que hay una nueva correspondiente a Automate.io

image

Instalación con el token interno

Otras plataformas, como Zapier, en el momento en el que selecciones Notion como una de las herramientas de tu automatización, te pedirán un token interno para poder conectarse a tu espacio de trabajo. Este token es ese que se nos generó cuando creamos nuestro bot, y al que te recuerdo que podrás acceder desde:

  • A través de Settings & Members > Integrations .
    • Allí verás el bot que has creado al principio (es al que le pusiste el nombre y está etiquetado como Internal) → Selecciona los tres puntos ... y Copy internal Integration Token
    • image
  • Pega esta clave cuando la plataforma te lo pida (normalmente al ir a crear una automatización). Esto es lo que permitirá que su servicio y tu bot interactúen.

Invitar al bot a nuestras páginas

En el caso de que la herramienta en cuestión no nos haya hecho seleccionar las páginas a las que queremos darle acceso, tendremos que "invitar" manualmente a nuestro bot a las páginas o bases de datos que queramos conectar a esas otras plataformas de terceros.

Como, a fin de cuentas, este bot era como 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
  • image
  • Se nos abrirá una ventana con las demás personas que tengan acceso a alguna parte de nuestro espacio de trabajo (si es que has añadido alguna en algún momento) y, más abajo, verás tus integraciones bajo el título Select and Integration
  • image
  • 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. Esto quiere decir que el bot ya tiene acceso a la misma y está listo para conectarse con otras herramientas 😊
  • image

🔌6. La API de Notion

👋🏻 C O N T A C T O

📧 mail: elena@elenamadrigal.com

🐦 twitter: @elenayuscula

📇 linkedin: elenamadrigal

🖋 blog/portfolio: elenadrigal.com

Este sitio ha sido construído en Notion y Super.so Ilustraciones: Miroodles