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

# Slack Integration

> Connect Slack to your Trilo workspace for cross-platform communication

Connect Slack to Trilo to bridge communication between platforms. AI coworkers can post updates to Slack channels, send notifications, and help teams that use both tools stay in sync.

<Info>
  This guide is for using Slack **alongside** Trilo. If you're replacing Slack entirely, see the [migration guide](/migrations/from-slack).
</Info>

## What AI Can Do with Slack

Once connected, AI coworkers can:

| Capability             | Example Use                             |
| ---------------------- | --------------------------------------- |
| **Post messages**      | "Post a project update to #engineering" |
| **Send notifications** | Automated alerts for task completions   |
| **Read channels**      | "What's being discussed in #marketing?" |
| **Cross-post updates** | Share Trilo activity in Slack           |

## When to Use This Integration

### Good Use Cases

* **Notification bridge**: Get Trilo alerts in Slack
* **Status updates**: Post project updates to Slack automatically
* **Gradual migration**: Use both tools during transition period
* **External stakeholders**: Stakeholders in Slack, team in Trilo

### Consider Alternatives

If your whole team uses Slack, consider:

* **Full migration**: Move to Trilo completely ([migration guide](/migrations/from-slack))
* **All-in-Trilo**: Use Trilo's built-in chat instead

Running two chat platforms long-term creates confusion.

## Prerequisites

* Slack workspace admin access (or permission to add apps)
* Trilo workspace admin (or integration permissions)

## Connecting Slack

<Steps>
  <Step title="Open Workspace Settings">
    Click **Settings** in the Trilo sidebar.
  </Step>

  <Step title="Go to Integrations">
    Select the **Integrations** section.
  </Step>

  <Step title="Find Slack">
    In workspace integrations, find **Slack** and click **Connect**.
  </Step>

  <Step title="Authorize in Slack">
    You'll be redirected to Slack. Sign in if needed.
  </Step>

  <Step title="Select Workspace">
    Choose which Slack workspace to connect.
  </Step>

  <Step title="Grant Permissions">
    Review permissions and click **Allow**.
  </Step>

  <Step title="Select Channels">
    Choose which Slack channels Trilo can access.
  </Step>
</Steps>

## Configuring Slack Access

### Project-Level Configuration

<Steps>
  <Step title="Open a Project">
    Navigate to the project that needs Slack access.
  </Step>

  <Step title="Go to Project Settings">
    Click the settings icon.
  </Step>

  <Step title="Add Slack Integration">
    In the Integrations tab, add the Slack integration.
  </Step>

  <Step title="Map Channels">
    Select which Slack channels this project can post to.
  </Step>
</Steps>

### Channel Mapping Example

| Trilo Project       | Slack Channel   |
| ------------------- | --------------- |
| Engineering         | #engineering    |
| Marketing Campaigns | #marketing      |
| Product Launch      | #product-launch |

## Using Slack with AI Coworkers

### In Project Chat

```
You: Post an update to Slack about the feature release
AI: I'll post this to #engineering:

    "🚀 Feature Release: User Dashboard v2.0 is live!
    Key updates: New widgets, faster load times, dark mode.
    See full notes: [link]"

    Should I post this?

You: Yes, post it
AI: Posted to #engineering successfully.
```

### Automated Notifications

Set up workflows to automatically post:

* Task completions to relevant Slack channels
* Meeting summaries after video calls
* Weekly project updates

## Permissions Explained

| Permission                | Why It's Needed                     |
| ------------------------- | ----------------------------------- |
| **Post messages**         | To send updates to Slack channels   |
| **Read channels**         | To see context and avoid duplicates |
| **Access workspace info** | To list available channels          |

## Best Practices

<AccordionGroup>
  <Accordion title="Don't duplicate conversations">
    Pick one platform for real-time discussion. Use Slack for quick updates/notifications, but don't have the same conversation in both places.
  </Accordion>

  <Accordion title="Use for one-way updates">
    The best use of this integration is Trilo → Slack updates, not two-way conversation. Project updates, completion notifications, status reports.
  </Accordion>

  <Accordion title="Have a migration plan">
    If you're using both Slack and Trilo long-term, define clear boundaries. Otherwise, plan to consolidate into one platform.
  </Accordion>
</AccordionGroup>

## Troubleshooting

<AccordionGroup>
  <Accordion title="Can't post to a channel">
    Check that:

    1. The Slack channel is included in the integration setup
    2. The channel is assigned to the project you're working in
    3. The Trilo app is added to the Slack channel
  </Accordion>

  <Accordion title="Integration disconnected">
    The OAuth token may have expired. Click **Reconnect** in Trilo's integration settings.
  </Accordion>

  <Accordion title="Messages not appearing in Slack">
    Verify:

    1. The Trilo app isn't muted in Slack
    2. The channel allows app posts
    3. Check Slack's app settings for Trilo
  </Accordion>
</AccordionGroup>

## Disconnecting Slack

<Steps>
  <Step title="Go to Settings">
    Click **Settings** → **Integrations**.
  </Step>

  <Step title="Find Slack">
    Locate the Slack integration.
  </Step>

  <Step title="Click Disconnect">
    Confirm the disconnection.
  </Step>
</Steps>

Also remove the app from Slack: **Slack Settings → Manage Apps → Trilo → Remove**.

## Next Steps

<CardGroup cols={2}>
  <Card title="Migrate from Slack" icon="right-from-bracket" href="/migrations/from-slack">
    Replace Slack entirely with Trilo.
  </Card>

  <Card title="Trilo Chat" icon="comments" href="/chat/overview">
    Use Trilo's built-in team chat.
  </Card>

  <Card title="All Integrations" icon="plug" href="/settings/integrations">
    See other available integrations.
  </Card>
</CardGroup>