How to Configure Notion Knowledge Ingestion

1. Create the Notion Connector

   1. Follow the steps on the Notion Integration Overview to set up the Notion Integration
   2. In Moveworks Setup, navigate to Connectors > Built-in Connectors and create a new connector for Notion with the API key generated in the previous step.

2. Share the relevant workspaces/pages with the integration in Notion

   You must share specific pages with an integration in order for the API to access those pages.

   To share a database/page with your integration:

   1. Go to the database/page in your workspace.
   2. Click the •• at the top right corner of the page.
   3. At the bottom of the pop-up, click Add connections. Search for and select your integration in the Search for connections... menu. Your integration now has permission to edit the database/page.

3. Create the Knowledge Ingestion Configuration

   1. Start by creating a new knowledge ingestion configuration in Moveworks Setup under Answers > Ingestion > Internal Knowledge Settings
      1. Select the Connector that was created for Notion and then provide a name for the ingestion under Ingestion Name.
      2. Choose a Domain. The domain is the functional areas of employee service that is most related to the knowledge being ingested for this configuration.
      3. In order to ingest articles from a Notion workspace or page, you will need to define the Start URL. The start url should follow the below structure:

https://api.notion.com/v1/blocks/{block_id}/children

• The {{block_id)) in the URL refers to the workspace or page ID in Notion. You can find this ID by clicking the three dots in the top right hand corner of Notion and clicking copy url. The {{block_id}} will be the numeric ID in the URL. All supported content within the workspace or page configured will be ingested.

3. Create the Permissions Configuration
   1. In Moveworks Setup, navigate to Resource Permissions > Permission Rules
   2. Create a new permission configuration with the following settings
      1. Strategy Config: ABAC (Note: Only ABAC rule based permissions are supported for Notion)
      2. Abac Config Resource Rule Resource Rule: KB Rule
      3. KB Rule:
         1. Set KB Rule to True to give all users unrestricted access to the ingested Notion content.
         2. For more granular rule based access rules, please review available DSL Syntax. The conditional access rule can reference knowledge article properties in the Doc Sourcedata object and properties from the user object.
   3. Integration ID: Notion
   4. Resource Type: kb
   5. Action: ACTION_VIEW

Validation

• Once you have submitted the Knowledge ingestion configuration, it will kick off the Ingestion pipeline in the background, the status of the same can be tracked on the Ingested Knowledge View
• You can search for the Articles with their Title's here, and if they are listing on the Console that means they have been ingested successfully.