La integración de Notion para Botpress Studio te permite hacer las siguientes cosas: ## Migrar de la versión `0.x` o `1.x` a `2.x` La versión `2.0` de la integración Notion añade soporte OAuth, que ahora es la opción de configuración por defecto. Si previamente ha creado una integración Notion en el portal de desarrolladores Notion y desea seguir utilizando esta integración, por favor seleccione la opción de configuración manual y siga las siguientes instrucciones. De lo contrario, seleccione la opción de configuración automática y haga clic en el botón de autorización, a continuación, siga las instrucciones en pantalla para conectar su chatbot Botpress a Notion. ## Configuración ### Configuración automática con OAuth (recomendado) Esta es la forma más sencilla de configurar la integración. Para configurar la integración de Notion usando OAuth, haz clic en el botón de autorización y sigue las instrucciones en pantalla para conectar tu chatbot Botpress a Notion. Se recomienda este método ya que simplifica el proceso de configuración y garantiza una comunicación segura entre su chatbot y Notion. Al utilizar este modo de configuración, se utilizará una aplicación Notion Botpress Botpress para conectarse a su cuenta Notion . Las acciones realizadas por el bot se atribuirán a esta aplicación, no a su cuenta personal de Notion . ### Configuración manual con una integración Notion personalizada #### Paso 1 - Crear integración Cree una integración Notion [Crear una integración - Desarrolladores Notion ]notion #### Paso 2 - Dar acceso a los activos de Notion Da acceso a tu integración a todas las páginas y bases de datos que quieras utilizar con Botpress #### Paso 3 - Configura tu Bot Da acceso a tu integración a todas las páginas y bases de datos que quieras usar con Botpress. [Compartir una base de datos con tu integración - Notion Developers]notion Necesitas un token para que tu recién creada Notion Integration _(no es lo mismo que la Notion Integration de Botpress Studio)_ se conecte con Botpress Studio: - `Auth Token` - Lo encontrarás yendo a tu integración en notion. Una vez que hagas clic en tu integración, ve a la sección "Secretos" y encuentra el campo "Secreto interno de integración". Haga clic en "Mostrar" y luego en "Copiar". Pega el token copiado en el campo `Auth Token` de la integración Notion en la pestaña "Integraciones" de tu bot. Con esto sólo necesitas habilitar tu integración y podrás empezar a expandir las capacidades de tu Bot con Notion. ## Uso Las siguientes acciones requieren que conozcas los Ids de las entidades Notion con las que trabajará tu bot. Todas las entidades de notion (páginas, bases de datos, etc) tienen un id que se puede encontrar en la URL cuando las visitas en tu cuenta de Notion en un Navegador,u obteniendo el enlace haciendo click en el ítem "Copiar Enlace" en el menú (...). Ver [Obtener un Id de Base de Datos - Desarrolladores Notion ]notion para más información. ### Añadir comentario a una discusión Esta acción le permite añadir un comentario a una discusión existente. Utilícela para responder a un comentario. ### Añadir comentario a una página Puede añadir comentarios a nivel de página con esta acción. ### Obtener una Base de Datos Permite obtener los detalles de una Base de Datos. Lo ideal es utilizarla con la acción `Add Page to a Database`. Además de la respuesta de la API de Notion ([Retreive a Database - Notion Developers]notion), esta acción también devuelve una propiedad `structure` optimizada (técnicamente una decleración de tipo) que puede utilizarse como entrada para una tarea de IA para indicarle que genere una carga útil para añadir o actualizar una página en una Base de Datos de Notion basándose en una entrada del usuario. ### Añadir página a una base de datos Lo ideal es utilizar esta acción junto con la acción "Obtener una base de datos", que devuelve la estructura de la base de datos que se puede utilizar para ordenar a una tarea de inteligencia artificialbotpress) que genere una carga útil. Ver [Trabajar con Bases de Datos - Desarrolladores de Notion ]notion para más información. ### Borrar un bloque Puede eliminar las siguientes entidades: - una página de una base de datos - una página - un bloque
