> ## Documentation Index
> Fetch the complete documentation index at: https://docs.duckie.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# Managing Connections

> Connect and manage your integrations

The Connections page is where you manage all integrations between Duckie and your external platforms.

{/* Screenshot: Full connections page showing all integration cards organized by category */}

## Accessing Connections

Go to **Settings → Connections** in your dashboard.

## Connection Categories

Integrations are organized by purpose:

{/* Screenshot: Category tabs or sections showing Ticketing, Messaging, etc. */}

| Category          | Purpose           | Integrations                             |
| ----------------- | ----------------- | ---------------------------------------- |
| **Ticketing**     | Support requests  | Zendesk, Intercom, Plain, Pylon, HubSpot |
| **Messaging**     | Real-time chat    | Slack, Discord, Teams                    |
| **Documentation** | Knowledge sources | Notion, Confluence, Google Drive         |
| **Issues**        | Bug tracking      | Jira, Linear, GitHub                     |

## Connecting an Integration

<Steps>
  <Step title="Find the Integration">
    Browse by category or search.

    {/* Screenshot: Integration card before connecting */}
  </Step>

  <Step title="Click Connect">
    Click the **Connect** button on the integration card.
  </Step>

  <Step title="Authorize">
    Complete the connection flow:

    **OAuth integrations:** Redirected to authorize access

    **API key integrations:** Enter your credentials

    {/* Screenshot: OAuth authorization popup */}
  </Step>

  <Step title="Configure (if needed)">
    Some integrations require additional setup:

    * Select workspaces or channels
    * Configure sync settings
    * Set permissions
  </Step>
</Steps>

## Connection Status

{/* Screenshot: Integration card showing connected status */}

Each integration shows its status:

| Status                 | Meaning             | Action                   |
| ---------------------- | ------------------- | ------------------------ |
| **Connected**          | Active and working  | None needed              |
| **Not Connected**      | Not set up          | Click Connect            |
| **Needs Reconnection** | Auth expired/failed | Click Reconnect          |
| **Error**              | Something is wrong  | View error, troubleshoot |

## Managing Connected Integrations

### Viewing Details

Click on a connected integration to see:

{/* Screenshot: Integration detail panel showing connection info */}

* Connection status
* Connected account/workspace
* Last sync time (knowledge sources)
* Configuration options

### Reconnecting

If a connection expires or breaks:

<Steps>
  <Step title="Find the Integration">
    Look for "Needs Reconnection" status.
  </Step>

  <Step title="Click Reconnect">
    Click the **Reconnect** button.
  </Step>

  <Step title="Re-authorize">
    Complete the authorization flow again.
  </Step>
</Steps>

### Disconnecting

To remove an integration:

<Steps>
  <Step title="Open Integration">
    Click on the connected integration.
  </Step>

  <Step title="Click Disconnect">
    Click **Disconnect** in the detail panel.
  </Step>

  <Step title="Confirm">
    Confirm you want to disconnect.
  </Step>
</Steps>

<Warning>
  Disconnecting an integration will:

  * Disable deployments using that channel
  * Stop syncing knowledge from that source
  * Remove stored credentials
</Warning>

## Multi-Account Connections

Some integrations support multiple connections:

{/* Screenshot: Integration showing multiple connected accounts */}

* **Gmail:** Connect multiple email accounts
* **Widget:** Create multiple chat widgets

For these integrations:

1. Click **Manage** to see connections
2. Click **Add Another** for additional accounts
3. Remove individual connections as needed

## Connection Types

### OAuth

Most integrations use OAuth for secure authentication:

1. Click Connect
2. Redirected to external service
3. Authorize Duckie
4. Redirected back, connected

**Integrations:** Slack, Zendesk, Notion, Jira, etc.

### API Key

Some integrations require manual API key entry:

1. Click Connect
2. Enter API key/token
3. Save credentials

**Integrations:** Plain, Pylon, Fireflies

## Troubleshooting

### Connection Failed

**Possible causes:**

* Don't have admin permissions in external platform
* Required scopes weren't approved
* Network or temporary issues

**Solutions:**

* Verify you have admin access
* Try disconnecting and reconnecting
* Check the external platform's status

### Sync Not Working

**Possible causes:**

* Connection expired
* Content not selected
* Permissions changed

**Solutions:**

* Check connection status
* Verify content selection
* Reconnect if needed

### Features Not Available

**Possible cause:**

* Integration doesn't support that feature

**Solution:**

* Check [Supported Integrations](/integrations/supported-integrations) for capabilities

## Next Steps

<CardGroup cols={2}>
  <Card title="Supported Integrations" icon="plug" href="/integrations/supported-integrations">
    See all integration capabilities
  </Card>

  <Card title="Create Deployment" icon="rocket" href="/deployments/creating-deployments">
    Deploy to connected channels
  </Card>
</CardGroup>