Integración de Notion para chatbots y agentes de IA
Acerca de esta integración
Notion es una de nuestras integraciones más populares para chatbots de IA.
Conectar un chatbot a Notion permite a los creadores crear, actualizar y buscar páginas o bases de datos directamente desde las conversaciones, convirtiendo Notion en una base de conocimientos dinámica y en un sistema de almacenamiento de datos para los flujos de trabajo del chatbot.
Con la integración, los chatbots pueden extraer información de Notion para responder preguntas de los usuarios, guardar datos de clientes recogidos durante los chats y registrar automáticamente notas de reuniones, tareas o comentarios. Esto facilita conectar la IA conversacional con la documentación del equipo, la gestión de proyectos o los registros de clientes.
La integración con Notion es especialmente útil para empresas que ya usan Notion como su espacio de trabajo central. En lugar de copiar y pegar detalles de los chats, el chatbot actualiza Notion en tiempo real.
Esto significa que los equipos siempre tienen los últimos datos de clientes, tickets de soporte o actualizaciones de tareas directamente en su espacio de trabajo de Notion.
Al conectar Notion y un chatbot, los creadores pueden reducir la entrada manual de datos, mantener la información precisa y usar Notion tanto como entrada como salida para la automatización del chatbot.
Funciones principales
- Crea y actualiza páginas de Notion desde conversaciones de chatbot
- Guarda datos de clientes en bases de datos de Notion
- Busca contenido en Notion para potenciar las respuestas del chatbot
- Registra tareas, notas y comentarios automáticamente
- Sincroniza las entradas del chatbot con tableros de gestión de proyectos
- Organiza la información de soporte dentro de Notion
- Activa actualizaciones en Notion desde flujos de trabajo del chatbot
- Mantén los espacios de trabajo del equipo actualizados en tiempo real
¿Cómo conecto un chatbot a Notion?
Para conectar un chatbot a Notion, debes autenticar tu cuenta de Notion en la configuración de integraciones de la plataforma del chatbot. Esto permite que el chatbot lea y escriba en páginas y bases de datos de Notion.
¿Cómo puedo crear o actualizar una página de Notion desde una conversación con el chatbot?
Configuras el chatbot para enviar datos de la conversación a Notion usando la integración. Cuando ocurre un evento, como que un usuario envíe un comentario, el chatbot crea una nueva página o actualiza una existente con ese contenido.
¿Cómo puedo usar Notion como base de conocimientos para las respuestas del chatbot?
Puedes conectar el chatbot a una base de datos de Notion que almacene preguntas frecuentes, políticas o documentación. El chatbot puede consultar esa base de datos y devolver el contenido relevante de la página como respuesta durante una conversación.
¿Cómo puedo buscar contenido de Notion a través de un chatbot?
Puedes habilitar la búsqueda vinculando el chatbot a las bases de datos de Notion mediante la integración. Cuando un usuario hace una pregunta, el chatbot busca palabras clave o entidades en Notion y entrega la información correspondiente.
¿Cómo puedo guardar diferentes tipos de datos de los chats en Notion?
Puedes guardar entradas de texto como nombres, correos electrónicos, comentarios y notas, así como datos estructurados como casillas de verificación, etiquetas o campos de estado. La integración asigna las variables del chatbot a los campos de la base de datos de Notion.
¿Cómo mantengo los espacios de trabajo de Notion actualizados automáticamente con las entradas del chatbot?
Puedes crear flujos de trabajo donde los eventos del chatbot activen actualizaciones en Notion. Por ejemplo, cuando un cliente envía una solicitud en el chat, el chatbot crea o actualiza automáticamente la entrada correspondiente en Notion, manteniendo el espacio de trabajo al día sin esfuerzo manual.
The Notion Integration for Botpress Studio allows you to do the following things:
## Migrating from version `0.x` or `1.x` to `2.x`
Version `2.0` of the Notion integration adds OAuth support, which is now the default configuration option.
If you previously created a Notion integration in the Notion developer portal and wish to keep using this integration, please select the manual configuration option and follow the instructions below.
Otherwise, select the automatic configuration option and click the authorization button, then follow the on-screen instructions to connect your Botpress chatbot to Notion.
## Configuration
### Automatic configuration with OAuth (recommended)
This is the simplest way to set up the integration. To set up the Notion integration using OAuth, click the authorization button and follow the on-screen instructions to connect your Botpress chatbot to Notion. This method is recommended as it simplifies the configuration process and ensures secure communication between your chatbot and Notion.
When using this configuration mode, a Botpress-managed Notion application will be used to connect to your Notion account. Actions taken by the bot will be attributed to this application, not your personal Notion account.
### Manual configuration with a custom Notion integration
#### Step 1 - Create Integration
Create a Notion integration [Create an integration - Notion Developers](https://developers.notion.com/docs/create-a-notion-integration)
#### Step 2 - Give access to Notion Assets
Give your integration access to all the pages and databases that you want to use with Botpress
#### Step 3 - Configure your Bot
Give your integration access to all the pages and databases that you want to use with Botpress. [Share a database with your integration - Notion Developers](https://developers.notion.com/docs/create-a-notion-integration#step-2-share-a-database-with-your-integration)
You need a token to get your newly created Notion Integration _(not the same as Botpress Studio's Notion Integration)_ connected with Botpress Studio:
- `Auth Token` - You'll find this by going to your integration under `https://www.notion.so/my-integrations`. Once you click on your integration, go to the "Secrets" section and find the "Internal Integration Secret" field. Click "Show" then "Copy". Paste the copied token under `Auth Token` field for Notion integration under the "Integrations" tab for your bot.
With that you just need to enable your integration and you can start expanding your Bot's capabilities with Notion.
## Usage
The following actions require you to know the Ids of the Notion entities your bot will work with. All notion entities (pages, databases, etc) have and id that can be found in the URL when you visit those in your Notion account in a Browser,or by getting the link by clicking on the "Copy Link" item in the (...) menu. See [Get a Database Id - Notion Developers](https://developers.notion.com/docs/create-a-notion-integration#step-3-save-the-database-id) for more information
### Add Comment to a Discussion
This action allows you to add a comment to an existing discussion. Use this for replying to a comment.
### Add Comment to a Page
You can add page level comments with this action.
### Get a Database
This allows you to get the details of a Database. This is ideally used with the `Add Page to a Database` action. In addition to the response from the Notion API ([Retreive a Database - Notion Developers](https://developers.notion.com/reference/retrieve-a-database)), this action also returns a optimized `structure` property (technically a type decleration) that can be used as an input for an AI task to instruct it to generate a payload for adding or updating a page in a Notion Database based on a user input.
### Add Page to a Database
This action should ideally be used in tandem with `Get a Database` that returns the structure of the Database that you can use to instruct an [AI task](https://botpress.com/docs/cloud/generative-ai/ai-task-card/) to generate a payload. See [Working with Databases - Notion Developers](https://developers.notion.com/docs/working-with-databases) for more info.
### Delete a block
You can delete the following entities:
- a page in a database
- a page
- a block
