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

# Slack

> Step-by-step guide to connect Factory with your Slack workspace

Connect Factory to Slack so Droid can work with Slack conversations and team context.

## Prerequisites

* A Factory account with admin privileges
* Admin access to your Slack workspace
* Ability to install apps in your Slack workspace

## Integration Steps

<Steps>
  <Step title="Access Factory Integrations">
    Log in to your Factory account and navigate to the Integrations section in your Settings.
  </Step>

  <Step title="Initiate Slack Integration">
    Click on "Connect" next to Slack to start the integration process.
  </Step>

  <Step title="Authorize Factory's Slack Application">
    You'll be redirected to Slack. Review the requested permissions and click "Allow" to authorize Factory access to your Slack workspace.
  </Step>

  <Step title="Select Workspace">
    If you belong to multiple workspaces, select the workspace you want to connect to Factory.
  </Step>

  <Step title="Confirm Integration">
    After authorization, you'll be redirected back to Factory. Verify that the integration status shows as "Connected".
  </Step>

  <Step title="Add to Channels">
    In your Slack workspace, add the Factory app to relevant channels by typing `/invite @Factory` in each channel.
  </Step>
</Steps>

## Verification

To ensure the integration is working correctly:

1. Mention `@Factory` in a thread within a channel where the app has been added.
2. Verify that Factory responds with a link to open the conversation in Factory.
3. Click the link and confirm that the Slack thread content appears in your new Factory session.

## Slack Tools

<Warning>
  Before using the tools below, make sure that the Factory app is invited
  to the channels you'd like to interact with by sending <code>/invite @Factory</code> in those channels.
</Warning>

Factory currently provides one native Slack tool:

| Tool             | What it does                                                  |
| ---------------- | ------------------------------------------------------------- |
| **Post Message** | Sends a message to a channel or replies in an existing thread |

## Additional Features

Besides the tools above, the Slack integration also allows you to:

* Mention `@Factory` in any Slack thread to receive a link to continue the conversation in Factory
* Import Slack thread context into Factory by clicking the provided link
* Reference Slack threads in Factory by pasting a thread URL into a Factory chat

When a Slack thread is imported, Factory has access to the entire conversation history, allowing it to provide context-aware assistance.

## Best Practices

* Add the Factory app only to channels where development discussions occur.
* Use threads rather than channel messages when mentioning Factory.
* Provide sufficient context in the Slack thread before mentioning Factory.
* Regularly review the permissions granted to the Factory app in your Slack settings.

## Troubleshooting

If you encounter issues during integration:

* Ensure you have admin rights in both Factory and your Slack workspace.
* Verify that the Factory app has been added to the channel where you're mentioning it.
* If you see a "not\_in\_channel" error toast when trying to paste a Slack thread URL, it means the Factory bot needs to be invited to that channel. Use `/invite @Factory` in the channel to resolve this issue.
* Check that your organization's firewall isn't blocking webhook communications.
* For persistent issues, contact Factory support with specific error messages.

<Card title="Security and Compliance" icon="shield-check" href="https://trust.factory.ai">
  Visit Factory's Trust Center for compliance documents, certifications, and security resources
</Card>