> For the complete documentation index, see [llms.txt](https://docs.nisa.ai/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.nisa.ai/connecting-data-sources/confluence.md).

# Confluence

Atlassian Confluence is a robust platform used for collaboration, knowledge sharing, and document management. Our Business Chatbot integrates smoothly with Confluence Cloud, automatically captures, synchronizes, and indexes the following elements:

| Spaces      | This includes the Space Key, Name, Content, Type, and associated timestamps.                           |
| ----------- | ------------------------------------------------------------------------------------------------------ |
| Pages       | <p>We capture Page ID, Title, Content, Type, Space, and relevant timestamps.<br></p>                   |
| Blog Posts  | <p>Our integration covers Blog Post ID, Title, Content, Type, Space, and pertinent timestamps.<br></p> |
| Attachments | We index Attachment ID, Size, Type, Content, the corresponding Space, and timestamps.                  |

By connecting your Confluence with our Business Chatbot, you enhance ChatGPT's ability to understand your shared knowledge better and provide more contextual responses.

## Setting Up the Confluence Cloud Connector

Before you can connect Confluence Cloud to our Business Chatbot dashboard, you'll need to create an OAuth App on the Confluence Cloud platform. Follow these steps after logging into [Atlassian's Developer Portal](https://developer.atlassian.com/console/myapps/):

\
**Step 1.** Click "Create", then choose "OAuth 2.0 integration".

**Step 2.** Provide a suitable name for the integration, agree to the terms, then click "Create".

**Step 3.** On the sidebar, click "Settings". Here, add a description and image, then hit "Save changes".

**Step 4.** Note down the application’s `Client ID` and `Client Secret` displayed on this page. You'll need these soon. It will only be displayed after you have added an API.

**Step 5.** To create API access with the correct permissions, click "Authorization" in the sidebar, find "OAuth 2.0 (3LO)", and select "Configure" or "Add".

**Step 6.** You'll see a Callback URL form. Enter the OAuth redirect URL for your Business Chatbot deployment here. Then save changes.

* [https://YOUR\_DASHBOARD\_DOMAIN/oauth/atlassian](http://localhost:3001/oauth/atlassian)

**Note: Replace your own dashboard domain url.**

**Step 7.** You'll be prompted to add APIs. Click the "Add APIs" hyperlink.

**Step 8.** Next, click "Permissions", locate the "Jira platform REST API" and hit "Add", then "Configure".

**Step 9.** You'll need to enable certain permissions. Add the following:

* `read:confluence-space.summary` - Read Confluence space summary
* `read:confluence-props` - Read Confluence content properties
* `read:confluence-content.all` - Read Confluence detailed content
* `read:confluence-content.summary` - Read Confluence content summary
* `search:confluence` - Search Confluence content and space summaries
* `read:confluence-content.permission` - View content permission
* `read:confluence-user` - Read user
* `read:confluence-groups` - Permits retrieval of user groups
* `readonly:content.attachment:confluence` - Download content attachments

<figure><img src="/files/Yp9OoDmGNNEbbkmSWGm6" alt=""><figcaption></figcaption></figure>

Then, save your changes.

**Step 10.** Now, head over to the Sources section in the Business Chatbot dashboard, find Confluence, and enter both the `Client ID` and `Client Secret` which you can get in the "Settings" tab. Also input your Confluence instance Base URL without a trailing slash (for example, "[https://example.atlassian.net](https://example.atlassian.net/)").

And there you have it! Your Confluence Cloud connector is set up and ready to synchronize content. To start capturing data, you need to connect a Confluence Cloud instance using the correct authentication credentials.

<br>


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.nisa.ai/connecting-data-sources/confluence.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.