Notion

Add a bot to Notion using the official integration.

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

You will need:

• A published bot
• A Notion account and workspace

1. In Botpress Studio, select Explore Hub in the upper-right corner.

2. Search for the Notion integration, then select Install Integration.

3. In the Configuration menu, select Authorize Notion.

4. Follow the instructions to connect Botpress to your Notion account.

Manual configuration

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

1. In Botpress Studio, select Explore Hub in the upper-right corner.

2. Search for the Notion integration, then select Install Integration.

3. In the Configuration menu, select the drop-down and choose Configure the integration using a Notion integration token.

4. 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:

1. Go to your integrations page in Notion.

2. Select New integration.

3. Enter an Integration Name and Associated workspace for the integration. Then, select Save.

4. Select Configure integration settings.

5. Under Internal Integration Secret, select Show, then Copy.

6. Go back to the integration’s configuration menu in Botpress. Then, paste the secret into the Internal Integration Secret.

7. 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:

1. In your Notion integration’s settings, go to the Access tab.

2. Select Edit access.

3. 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:

1. In the integration’s configuration menu in Botpress, copy the webhook URL (starting with https://webhook.botpress.cloud/).

2. In your Notion integration’s settings, go to the Webhooks tab. Then, select + Create a subscription.

3. Paste the webhook URL you copied in the Webhook URL field.

4. Under Select the events to listen to, select the following events:

   • Page created
   • Page deleted
   • Comment created
5. Scroll down to the bottom of the page and select Verify.

6. In Botpress, go to your bot’s most recent logs. Copy the verification token sent from Notion.

7. Go back to your Notion integration and paste the token in the Verification token field.

8. Select Verify subscription.

9. 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

Show child attributes

type · string · required

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