# Notion

{% hint style="warning" %}
Integrations is a part of the Custom plan. Additional cost might apply.  
{% endhint %}

Notion integration simplifies knowledge sharing by linking ticketing with collaborative documentation. It ensures teams have quick access to resources for faster issue resolution.

\
**Use Cases:**

* Maintain a dynamic knowledge base of ticket resolutions.
* Enrich tickets with knowledge stored in Notion.
* Track and keep tasks updated between systems. 
* Suggest knowledge base articles based on ticket request.

***

### Requirements

You need a Notion account in order to set up the integration. Within this you will also create a new integration with access to your notion pages.

#### Step 1: Create a new Internal Integration

Learn more in the Notion [documentation](https://developers.notion.com/docs/create-a-notion-integration#create-your-integration-in-notion).

<figure><img src="https://621243658-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FO5JbdwXcuzsmDvD73Ccf%2Fuploads%2FV0zQzU1dcA0Zq80N8NZR%2Fimage.png?alt=media&#x26;token=cac64d06-6689-4d07-a27c-90b63a89f43e" alt="" width="563"><figcaption></figcaption></figure>

1. Navigate to your [Integrations](https://www.notion.so/profile/integrations) in your Notion account.
2. Çreate a **New Integration**
3. Assosciate it with the Notion **workspace** that you want to integrate with Suptask
4. Enter a **Name** and select the type **Internal**
5. **Submit**
6. Open the newly created integration and give it the required permissions:&#x20;
   1. Content capabilities: **Read + Update + Insert content**
   2. User capabilities: **User information without email addresses**
7. **Save.**
8. In the **Internal Integration Secret** field, copy the value and share it securely with your Suptask Integrations Specialist (SIS).

#### Step 2: Connect the integration with the Notion pages

Your new integration with Suptask will need [permissions](https://developers.notion.com/docs/create-a-notion-integration#give-your-integration-page-permissions) to your Notion pages.&#x20;

{% hint style="warning" %}
We recommend to connect your Suptask integration with the parent page at the top of the hiearchy of your pages. This will automatically give Suptask permissions to all sub-pages which will improve search results.
{% endhint %}

<figure><img src="https://621243658-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FO5JbdwXcuzsmDvD73Ccf%2Fuploads%2Fh0fWMocANLMyvyc3kEWh%2Fimage.png?alt=media&#x26;token=deb6796e-78f1-425e-b08b-b7edf6a45ade" alt="" width="188"><figcaption></figcaption></figure>

1. Open the **parent page** in the Notion workspace.
2. Click on the `...` More menu in the top-right corner of the page.
3. Select **Connections**, and then click on the newly created **Suptask integration**
   1. You might need to filter on its name in order for it to be displayed.
4. The selected Notion page and all the child pages will now be available to the Suptsk integration.
5. Done.

{% hint style="info" %}
The integration will be enabled for an Inbox, or for a specific Form of your choice.
{% endhint %}

***

### Example of how it can work&#x20;

{% hint style="info" %}
Every integration can be customized and adopted to your needs. Below you will find one out of many examples on how this integration can work when connected with Suptask.
{% endhint %}

#### Use Case A

1. **User submits a ticket** in Suptask&#x20;
2. Based on the request content, **a search of relevant articles** will be performed in the knowledge base.&#x20;
3. Suggested knowledge base articles will be sent **automatically** in the ticket to the user.&#x20;
   1. This will help to automatically solve tickets for many users, without the involvement of Agents.&#x20;
4. The user can select to continue having the ticket open, or close it.&#x20;

#### Use Case B

1. **Ticket is opened** and manage by Agents in Suptask
2. When ticket is closed, the **automatic AI summary** of the problem and solution of the ticket will be created.&#x20;
3. Agents can select to push these to an article in the knowledge base in order to keep the content up to date.
   1. This can be automatic or manual.

***

### How to get started

The Notion integration is setup and enabled together with the Suptask Integrations Specialists (SIS).

{% hint style="info" %}
Contact [Suptask Support](https://support.suptask.com/getting-started/contact-support) for more information and to get started.&#x20;
{% endhint %}