Open in Hub v
The Notion Integration with Botpress enables seamless integration to boost productivity, allowing interactions such as commenting on discussions or pages and database manipulations right from your Botpress bot.
Setup Basic configuration
Manual configuration
In Botpress Studio, select Explore Hub in the upper-right corner.
Search for the Notion integration, then select Install Integration .
In the Configuration menu, select Authorize Notion .
Follow the instructions to connect Botpress to your Notion account.
For advanced use cases, you can configure the integration manually using a Notion integration token. Step 1: Install the integration in Botpress
In Botpress Studio, select Explore Hub in the upper-right corner.
Search for the Notion integration, then select Install Integration .
In the Configuration menu, select the drop-down and choose Configure the integration using a Notion integration token .
You should see two fields:
Internal Integration Secret Webhook Verification Secret Leave these empty for now—you’ll come back to them after setting up the integration in Notion. Step 2: Create an integration in Notion Next, create a corresponding integration in Notion:
Enter an Integration Name and Associated workspace for the integration. Then, select Save .
Select Configure integration settings .
Under Internal Integration Secret , select Show , then Copy .
Go back to the integration’s configuration menu in Botpress. Then, paste the secret into the Internal Integration Secret .
Select Save Configuration .
Step 3: Give access to pages and databases For your bot to interact with your Notion workspace, you need to manually specify which pages and databases it has access to:
In your Notion integration’s settings, go to the Access tab.
Select the pages you want your bot to have access to. Then, select Save .
If you want to use the integration’s Triggers and have your bot respond to events in your Notion workspace, follow the steps below:
In the integration’s configuration menu in Botpress, copy the webhook URL (starting with https://webhook.botpress.cloud/).
In your Notion integration’s settings, go to the Webhooks tab. Then, select + Create a subscription .
Paste the webhook URL you copied in the Webhook URL field.
Under Select the events to listen to , select the following events:
Page created Page deleted Comment created
Scroll down to the bottom of the page and select Verify .
In Botpress, go to your bot’s most recent logs . Copy the verification token sent from Notion.
Go back to your Notion integration and paste the token in the Verification token field.
Select Verify subscription .
Finally, go back to the integration’s Configuration menu in Botpress. Paste the verification token into the Webhook Verification Secret field.
Your Notion integration is ready to use. You can use the integration’s Cards or Triggers to interact with your Notion workspace. Cards To use certain Cards, you might need to identify elements by their IDs. You can get page and database IDs:
From their URL while viewing them in your browser
By choosing Copy Link from their options menu
Here’s a reference for all Cards available with the integration:
Available options: page, block, discussion
Append Blocks to Page Create Page Available options: data source, page
Delete Block Get Data Source Get Database Get Page Get Page Content Search by Title Update Page Properties Triggers Here’s a reference for all Triggers available with the integration:
You can access data returned from any of these Triggers by reading event.payload after the Trigger fires.
Aggregate File Changes Show array item properties
Show array item properties
File Created File Deleted File Updated Folder Deleted Recursive 
