Notion - Botpress

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

You will need:

A published bot
A Notion account and workspace

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.

You will need:

A published bot
A Notion account and workspace

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:

Go to your integrations page in Notion.

Select New integration.

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 Edit access.

Select the pages you want your bot to have access to. Then, select Save.

Step 4: Configure webhook events (optional)

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:

Add Comment

input

object

Show child attributes

parentType

enum<string>

required

Available options: page, block, discussion

Append Blocks to Page

Create Page

input

object

Show child attributes

parentType

enum<string>

required

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

payload

object

Show child attributes

modifiedItems

object

required

Show child attributes

created

array

required

Show array item properties

type

string

required

updated

array

required

Show array item properties

type

string

required

deleted

array

required

file
folder

Show child attributes

type

string

required

Comment Created

File Created

payload

object

Show child attributes

file

object

required

Show child attributes

type

string

required

File Deleted

payload

object

Show child attributes

file

object

required

Show child attributes

type

string

required

File Updated

payload

object

Show child attributes

file

object

required

Show child attributes

type

string

required

Folder Deleted Recursive

payload

object

Show child attributes

folder

object

required

Show child attributes

type

string

required

​Setup

​Step 1: Install the integration in Botpress

​Step 2: Create an integration in Notion

​Step 3: Give access to pages and databases

​Step 4: Configure webhook events (optional)

​Cards

​Add Comment

​Append Blocks to Page

​Create Page

​Delete Block

​Get Data Source

​Get Database

​Get Page

​Get Page Content

​Search by Title

​Update Page Properties

​Triggers

​Aggregate File Changes

​Comment Created

​File Created

​File Deleted

​File Updated

​Folder Deleted Recursive

Setup

Step 1: Install the integration in Botpress

Step 2: Create an integration in Notion

Step 3: Give access to pages and databases

Step 4: Configure webhook events (optional)

Cards

Add Comment

Append Blocks to Page

Create Page

Delete Block

Get Data Source

Get Database

Get Page

Get Page Content

Search by Title

Update Page Properties

Triggers

Aggregate File Changes

Comment Created

File Created

File Deleted

File Updated

Folder Deleted Recursive