Notion integration for chatbots and AI agents
About this integration
Notion is one of our most popular integrations for AI chatbots.
Connecting a chatbot to Notion allows builders to create, update, and search pages or databases directly from conversations, turning Notion into both a dynamic knowledge base and a data storage system for chatbot workflows.
With the integration, chatbots can pull information from Notion to answer user questions, store customer data collected during chats, and log meeting notes, tasks, or feedback automatically. This makes it easy to connect conversational AI with team documentation, project management, or customer records.
The Notion integration is especially useful for businesses that already use Notion as their central workspace. Instead of copying and pasting details from chats, the chatbot updates Notion in real time.
That means teams always have the latest customer insights, support tickets, or task updates right inside their Notion workspace.
By connecting Notion and a chatbot, builders can reduce manual data entry, keep information accurate, and use Notion as both an input and output for chatbot automation.
Key features
- Create and update Notion pages from chatbot conversations
- Store customer data in Notion databases
- Search Notion content to power chatbot responses
- Log tasks, notes, and feedback automatically
- Sync chatbot inputs with project management boards
- Organize support information inside Notion
- Trigger Notion updates from chatbot workflows
- Keep team workspaces up to date in real time
How do I connect a chatbot to Notion?
To connect a chatbot to Notion, you authenticate your Notion account in the chatbot platform’s integration settings. This allows the chatbot to read from and write to Notion pages and databases.
How can I create or update a Notion page from a chatbot conversation?
You configure the chatbot to send conversation data to Notion using the integration. When a trigger occurs—like a user submitting feedback—the chatbot creates a new page or updates an existing one with that content.
How can I use Notion as a knowledge base for chatbot responses?
You can connect the chatbot to a Notion database that stores FAQs, policies, or documentation. The chatbot can then query that database and return the relevant page content as a reply during a conversation.
How do I search Notion content through a chatbot?
You enable search by linking the chatbot to Notion’s databases through the integration. When a user asks a question, the chatbot looks up keywords or entities in Notion and delivers the matched information.
How can I store different types of data from chats into Notion?
You can store text inputs like names, emails, feedback, and notes, as well as structured data like checkboxes, tags, or status fields. The integration maps chatbot variables to Notion database fields.
How do I keep Notion workspaces updated automatically with chatbot inputs?
You build workflows where chatbot events trigger Notion updates. For example, when a customer submits a request in chat, the chatbot automatically creates or updates the matching entry in Notion, keeping the workspace current without manual effort.
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
