To integrate SearchAssist with Confluence Cloud, you need to 

• Create an OAuth 2.0 integration on the Atlassian developer portal.
• Configure the connector in SearchAssist with the OAuth 2.0 integration details.

Specifications

Type of Repository	Cloud
Supported API version	REST API v1
Search Results Support	Only manually created Knowledge articles in Confluence.
Extractive Model for Answers	Knowledge Articles
Generative Model for Answers	Knowledge Articles
Note: Searching through any other types of uploaded content like PDF files,  docs, and images is not supported.

Configuring OAuth application on Confluence Cloud

Prerequisites 

To create an OAuth 2.0 integration on the Confluence cloud, you need the following:   

1. An admin account in Atlassian’s Confluence.
2. A target domain.

Steps to create the OAuth application

• Sign into your developer account in the Atlassian developer portal. Click on the profile name at the top right corner and navigate to the Developer Console.

• The developer console will list all your apps.

• Click the Create button and select OAuth 2.0 Integration.

• Provide a name for the application and click Create.

• Once the application is created, you can update its name, description from the Settings tab. You can also add an avatar for the application. Update the settings and click Save changes.

• Next, configure Authorization code grants to allow SearchAssist to access data. To do so, go to the Authorization tab. Enter the SearchAssist Callback URL provided to you and click Save changes. You can use one of the following callback URLs as per your region. 
  • JP Region Callback URLs: https://jp-bots-idp.kore.ai/workflows/callback
  • DE Region Callback URLs: https://de-bots-idp.kore.ai/workflows/callback
  • Prod Region Callback URLs: https://idp.kore.com/workflows/callback

• The next step is to grant the necessary permissions. Go to the Permissions tab. Add the following scopes:
  • User Identity API
  • Confluence API

• For the User Identity API, to add the permissions, click the config link.

• On the following page, click the Edit Scopes button.

• Grant the following permissions and click Save. 
  • Read:me
  • Read:account

• Similarly, for Confluence API, go to the Granular Scopes and click Edit Scopes. Add a read operation filter, select all the filtered permissions, and click Save.  

• After adding permissions, go to Settings and find the Client ID and Secret at the end of the page. Save these fields as these will be used for configuring the SearchAssist connector in the next step.

• We also need the Host URL in Confluence for configuring the SearchAssist Connector.  To fetch this field, go to your Confluence home page and click on Profile.

• Go to the Products tab.  

The host URL will be displayed at the bottom of the page.

Configuring SearchAssist Connector

To complete the integration, do the following configuration on the SearchAssist application. 

• Go to Connectors under the Sources tab.

• The following page provides instructions for the integration. Click Proceed.
• Next, provide the details of the OAuth 2.0 application created on Confluence, click Connect, and authorize the connection.

Fields	Description
Name	Name for the connector
Client ID	Client ID of the OAuth application created on Confluence, as fetched in the last step above.
Client Secret	Client secret generated for communication with Confluence.
Host URL	The confluence server base URL  (without trailing slash), as fetched from the Confluence in the last step.