> ## Documentation Index
> Fetch the complete documentation index at: https://mintlify.com/Arvo-AI/aurora/llms.txt
> Use this file to discover all available pages before exploring further.

# Communication Tool Integrations

> Connect Aurora to Slack and Confluence for team collaboration and documentation

Aurora integrates with your team communication and documentation tools to enable seamless collaboration and knowledge sharing.

## Available Integrations

<CardGroup cols={2}>
  <Card title="Slack" icon="slack" href="#slack">
    OAuth 2.0 workspace integration
  </Card>

  <Card title="Confluence" icon="confluence" href="#confluence">
    OAuth 2.0 for Atlassian Cloud
  </Card>
</CardGroup>

## Slack

### Authentication Method

OAuth 2.0

### Setup Overview

1. **Create Slack App**
   * Go to [Slack API Apps](https://api.slack.com/apps) > Create New App > From scratch
   * App Name: `Aurora`
   * Select your workspace

2. **Configure OAuth & Permissions**
   * Go to OAuth & Permissions
   * Add Redirect URL:
     * Local dev: `http://localhost:5080/slack/callback`
     * With ngrok: `https://your-ngrok-url.ngrok-free.dev/slack/callback`
     * Production: `https://your-aurora-domain/slack/callback`

3. **Add Bot Token Scopes**
   * `chat:write` — Send messages
   * `channels:read` — View channels
   * `channels:history` — Read channel messages
   * `channels:join` — Join channels
   * `app_mentions:read` — Read mentions
   * `users:read` — View users

4. **Copy Credentials**
   * Go to Basic Information
   * Copy:
     * Client ID
     * Client Secret
     * Signing Secret

5. **Configure Environment Variables**
   ```bash theme={null}
   NEXT_PUBLIC_ENABLE_SLACK=true
   SLACK_CLIENT_ID=your-slack-client-id
   SLACK_CLIENT_SECRET=your-slack-client-secret
   SLACK_SIGNING_SECRET=your-signing-secret
   ```

6. **Restart Aurora**
   ```bash theme={null}
   make down
   make dev
   ```

7. **Connect Workspace**
   * Go to Aurora UI
   * Click Add to Slack
   * Authorize the app

### Features

* **Send notifications** to channels
* **Receive mentions** and respond to user queries
* **Browse channels** and join conversations
* **Read message history** for context

### Local Development

<Tip>
  When using ngrok for local development, update the Redirect URL in your Slack app settings to match your ngrok URL.
</Tip>

### Troubleshooting

**"bad\_redirect\_uri"** — Redirect URL must match exactly in Slack App. Use ngrok URL when tunneling externally.

**"Slack connector not enabled"** — Ensure `NEXT_PUBLIC_ENABLE_SLACK=true` and restart Aurora.

**"Missing bot token scopes"** — Verify all required scopes are added in OAuth & Permissions.

## Confluence

### Authentication Method

OAuth 2.0 (Atlassian Cloud)

### Setup Overview

1. **Create OAuth 2.0 App**
   * Go to [Atlassian Developer Console](https://developer.atlassian.com/console/myapps/)
   * Create new app
   * Add OAuth 2.0 (3LO) capability

2. **Configure OAuth Settings**
   * Callback URL: `{FRONTEND_URL}/confluence/callback`
   * Scopes:
     * `read:page:confluence` — Read pages
     * `read:space:confluence` — Read spaces
     * `read:user:confluence` — Read user info
     * `search:confluence` — Search content
     * `offline_access` — Refresh tokens

3. **Copy Credentials**
   * Client ID
   * Client Secret

4. **Configure Environment Variables**
   ```bash theme={null}
   CONFLUENCE_CLIENT_ID=your-client-id
   CONFLUENCE_CLIENT_SECRET=your-client-secret
   FRONTEND_URL=http://localhost:3000
   ```

5. **Restart Aurora**
   ```bash theme={null}
   make down
   make dev
   ```

6. **Connect via OAuth Flow**
   * Go to Aurora UI
   * Click Connect Confluence
   * Select your Confluence site
   * Authorize the app

### Features

* **Search pages and spaces** across your Confluence instance
* **Read documentation** and runbooks
* **Parse runbook content** for automated workflows
* **Access user information** for context

### Supported Operations

* **Search**: CQL (Confluence Query Language) search
* **Read Pages**: Retrieve page content and metadata
* **List Spaces**: Browse available spaces
* **Parse Runbooks**: Extract structured data from runbook pages

### Troubleshooting

**"OAuth configuration missing"** — Verify `CONFLUENCE_CLIENT_ID` and `CONFLUENCE_CLIENT_SECRET` are set.

**"Invalid callback URL"** — Ensure callback URL in Atlassian app matches `{FRONTEND_URL}/confluence/callback`.

**"No accessible resources"** — User must have access to at least one Confluence site.

<Note>
  Confluence integration requires Atlassian Cloud. Confluence Server/Data Center is not currently supported.
</Note>

## Use Cases

### Incident Response

* **Slack**: Notify team channels when incidents occur
* **Confluence**: Fetch runbook documentation during incidents
* **Combined**: Post runbook links in Slack threads automatically

### Documentation Sync

* **Confluence**: Source of truth for infrastructure documentation
* **Slack**: Share documentation updates in relevant channels
* **Aurora**: Bridge between systems for seamless information flow

### Knowledge Base

* **Confluence**: Store detailed technical documentation
* **Slack**: Ask questions and get instant answers
* **Aurora**: Search Confluence and respond in Slack

## Next Steps

<CardGroup cols={2}>
  <Card title="CI/CD Integrations" icon="code-branch" href="/integrations/ci-cd">
    Integrate with GitHub, Jenkins, and Bitbucket
  </Card>

  <Card title="Observability" icon="chart-line" href="/integrations/observability">
    Connect monitoring and alerting tools
  </Card>
</CardGroup>