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

# Connect Slack for team operations

> Connect the approved Slack workspace and verify internal Trellis notifications

## What this helps you do

Connect Slack for internal team work such as supported alerts and operational
updates. Slack is a team channel; it is not a replacement for a guest message
channel.

## Before you start

* Ask a Slack admin which workspace and channel Trellis should use.
* Choose a test channel with no customer or guest participants.
* Decide which operational update your team wants to verify.
* Confirm who should be allowed to change the connection.

## Connect and test

<Steps>
  <Step title="Open Slack integrations">
    Go to **Settings > Integrations > Slack**.
  </Step>

  <Step title="Choose the approved workspace">
    Follow the displayed connection steps. Review the workspace name and
    requested access before approving.
  </Step>

  <Step title="Choose the internal channel">
    Select the approved test channel when the integration asks for one.
  </Step>

  <Step title="Run a safe operational test">
    Use the test action shown in Trellis, or run an approved workflow that posts
    only synthetic operational information.
  </Step>

  <Step title="Confirm one result">
    Check that the update appears once in the expected Slack channel and links
    your team back to the right Trellis work.
  </Step>
</Steps>

## How to check it worked

* The intended Slack workspace is connected.
* The test reaches only the approved internal channel.
* The update contains no private guest information.
* Teammates can follow the update back to the correct Trellis area.

## Recover a disconnected workspace

Open **Settings > Integrations > Slack** and review the connected workspace and
channel. Ask a Slack admin to approve the connection again if required. Repeat
one synthetic test. Do not post real guest details while testing.

## Common problems

<AccordionGroup>
  <Accordion title="The expected channel is missing">
    Confirm the person reconnecting Slack can access that channel and that the
    channel is approved for Trellis updates.
  </Accordion>

  <Accordion title="The test reached the wrong channel">
    Stop the workflow, correct the selected channel, and remove the synthetic
    test if your Slack policy allows.
  </Accordion>

  <Accordion title="A teammate cannot open the Trellis link">
    Ask an admin to review that teammate's Trellis role and property access.
  </Accordion>
</AccordionGroup>

## Related articles

* [Workflow automations](/platform/automations)
* [Choose roles and property access](/guides/roles-and-property-access)
* [Troubleshooting](/platform/troubleshooting)