# Slack

Connect Factory to Slack, use the default session flow, and distinguish personal DMs from shared channel delegations.

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

The existing Slack session flow remains the default for most organizations. After connecting the app, the session flow depends on your organization's configuration:

- [Default Slack flow](#default-slack-flow): start sessions from Slack threads using saved defaults or the computer picker. Existing channel configurations and explicit service-account choices still apply.
- [Remote delegations flow](#remote-delegations-flow): for organizations in the **Private Preview**, channel requests use the shared **Apps** configuration. [Slack DMs use your personal identity and connectors](#personal-dms-and-shared-channels), rather than the configuration's service account.

This page covers the Factory Slack app. A personal [Slack connector](/harness/connectors) gives Droid tools to use inside sessions; it does not install the app in your workspace.

<Warning>
If an existing Factory Slack install lacks permission to read images or upload files, rerun its authorization flow to enable those capabilities. A Slack admin may need to approve the updated permissions.
</Warning>

## Prerequisites

To install or manage the Factory Slack app, you need:

- A Factory account with the **Manager** or **Owner** role
- Admin access to your Slack workspace
- Ability to install apps in your Slack workspace
- Access to **Settings → Remote Delegations** in Factory

If Remote Delegations is missing from Settings, contact your Factory account team to check access. The current app no longer offers Slack installation under **Settings → Organization**. An existing Slack installation can still use the default session flow.

## Integration steps

<Steps>
  <Step title="Access Slack integration settings">
    Open <a href="https://app.factory.ai/settings/remote-delegations">**Settings → Remote Delegations**</a>. Under **Delegation Apps**, find **Slack** and select **Set Up for Org**, or **Configure** if it is already connected.
  </Step>
  <Step title="Connect or reconnect Slack">
    On the Slack setup page, click **Connect**. For an existing installation, click **Manage**, then **Reconnect** to refresh its permissions.
  </Step>
  <Step title="Authorize Factory's Slack app">
    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 the workspace">
    If you belong to multiple workspaces, select the workspace you want to connect to Factory.
  </Step>
  <Step title="Confirm the integration">
    After authorization, you'll be redirected back to Factory. Verify that the integration status shows as "Connected".
  </Step>
  <Step title="Add Factory to channels">
    In your Slack workspace, add the Factory app to relevant channels by typing `/invite @Factory` in each channel.
  </Step>
</Steps>

## Default Slack flow

Without a shared remote delegation configuration in use, Factory starts sessions using your saved defaults or asks you to choose a computer. Existing legacy channel configurations and explicit **Run as** selections can choose a service account instead.

### 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.
4. If you reran the install flow for the latest permissions, test with a thread that includes an image attachment and confirm Droid can use it as context.
5. If your workflow posts results back to Slack, confirm Droid can upload a generated file or short result video to the thread.

### Capabilities

With the Slack integration, you can:

- Mention `@Factory` in any Slack thread to start a Droid session from that thread
- Continue the session on Web or Desktop
- Import full Slack thread context into Factory by clicking the provided link
- Include supported image attachments from Slack as session context
- Have Droid post messages, generated files, artifacts, and result videos back to Slack
- Send follow-up messages and attachments from Slack into an active Droid session
- Choose from the [available models](/models), including Claude, GPT, Gemini, and Droid Core
- Pick the model when you start a session, set a default **model** per channel for Auto-Run and service-account workflows, or let <a href="/model-independence/factory-router">Factory Router</a> pick the best model automatically
- Reference Slack threads in Factory by pasting a thread URL into a Factory chat

![Factory Session Settings dialog showing the model picker with Factory models](/docs-assets/images/slack-model-selection.png)

When creating a PR, the Slack integration will also use a subagent to handle CI so the agent can respond faster.

When a Slack thread is imported, Factory has access to the entire conversation history and uses it as context.

### Slack settings

Existing legacy channel configurations can continue to select **Run as**, **Incident Response**, **Machine Type**, **Computer** or **Workspace**, **Session Visibility**, **Model**, and **Custom Prompt**. Standard `@Factory` mentions do not require a channel configuration.

The current Slack setup page manages the app connection, not the legacy channel settings table. For new channel-triggered workflows, use [Incident Response](/software-factory/incident-response) or [Automations](/software-factory/automations).

### Service accounts

Use [service accounts](/enterprise/identity-and-access#service-accounts) when Slack sessions should run from a shared identity and a preconfigured Droid Computer instead of the Slack user who mentions Factory. This is useful for incident, operations, or release channels that need consistent credentials and tool access.

Before using a service account with Slack, make sure:

- Service accounts are enabled for your organization.
- The service account is active.
- The service account owns at least one Droid Computer.
- The Factory app has been invited to the Slack channel.

An existing channel **Run as** configuration uses the selected service account's identity and computers. Its Auto-Run settings can also specify a prompt, model, and visibility for automated channel workflows.

For ad hoc Slack sessions, the computer picker can also show a **Run as** selector. Choose a service account, pick one of its computers, and optionally save it as your default for future Slack mentions.

## Remote delegations flow

<Info>
  Remote delegations are in Private Preview. To request access, contact your Factory account team. Existing Slack installations can continue using the default session flow without the shared configuration.
</Info>

In this flow, the organization's **Apps** configuration supplies the execution settings. Channel delegations use its service-account identity and compute. DMs run as the person messaging Factory, using their personal credentials and connectors.

### Preview prerequisites

For shared channel delegations, you need:

- Remote Delegations Private Preview access for your Factory organization.
- Service-account access and an active service account with the Git credentials and connectors needed for the work.
- A configured execution template for **Dynamic** compute, or computers owned by that service account for **Persistent** compute.

Each team member who delegates work must have a Factory account in the connected organization. Their Slack account email must match their Factory account email.

### Connect Slack and configure delegated sessions

Use the [integration steps](#integration-steps) above to connect Slack. Then configure shared execution:

<Steps>
  <Step title="Review the Apps configuration">
    In **Settings → Remote Delegations**, under **Remote Delegation Configs**, select **Edit** on **Apps**. Review the default model and reasoning level, custom instructions, plugins, service-account identity, and compute.

    Eligible organizations receive a default configuration, service account, and execution template. Review those defaults before use, or complete the configuration wizard if setup could not finish. Follow [Configure delegated sessions](/remote-delegations#configure-delegated-sessions) for the full setup.

    This configuration is shared across delegation apps, not scoped to one Slack channel. Its service account supplies the identity and connectors for shared channel delegations, not personal DMs.
  </Step>
  <Step title="Invite Factory to channels">
    In each Slack channel where your team will delegate work, run `/invite @Factory`.
  </Step>
</Steps>

### Delegate and follow up

Mention `@Factory` in a channel where the app has been invited, or send the app a direct message. Include the repository, desired outcome, and how Droid should verify the result:

> @Factory Investigate the failing checkout test in the storefront repository. Fix the cause, run the relevant tests, and open a pull request with a summary of the change.

Droid runs the work with the identity appropriate to the conversation. Review its response and any linked session or pull request. Continue with follow-up instructions in the same Slack conversation, and check the test results and proposed changes before merging.

### Personal DMs and shared channels

For sessions started through the Apps configuration, the Slack conversation determines whose access Droid uses:

| Where you send the request | Session identity | Credentials and connectors |
| --- | --- | --- |
| A direct message to Factory | Your personal Factory identity | Your personal Git credentials and connected apps |
| An `@Factory` mention in a channel | The Apps configuration's service account | That service account's Git credentials and connected apps |

Connect the tools you want to use in DMs under your own Factory account. For shared channel work, configure them on the service account. Mentioning Factory in a channel does not pass your personal connectors to the shared session.

A DM can still use the Apps configuration's execution template, instructions, and model defaults. When a template is available, Factory provisions a computer owned by you instead of using the service account's computer pool. If the configuration has no template, the DM falls back to the default Slack flow's saved settings or computer picker, including any explicit **Run as** choice.

### Personal model defaults

Open **Settings → Session Defaults → Delegations** to set **Default delegation model** and **Default delegation reasoning level**. Choose **Org default** to use the Apps configuration's model and reasoning settings.

A personal model selection can apply to both your DMs and channel requests, overriding the configuration's model when organization policy allows it. Its reasoning preference applies to that selected model.

Model defaults do not choose the session identity or connectors: config-backed DMs use your personal identity and connectors; shared channel delegations use the service account's. Choosing a personal model does not make a channel session run as you.

## 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

<Troubleshooting>
  <TroubleshootingItem title="Slack install is blocked">
    Ensure you have the **Manager** or **Owner** role in Factory and admin rights in your Slack workspace.
  </TroubleshootingItem>

  <TroubleshootingItem title="Factory does not respond in a channel">
    Verify that the Factory app has been added to the channel where you're mentioning it.
  </TroubleshootingItem>

  <TroubleshootingItem title="Droid cannot read or upload attachments">
    In **Settings → Remote Delegations**, select **Configure** for Slack, then **Manage → Reconnect** to refresh the Factory Slack app's permissions.
  </TroubleshootingItem>

  <TroubleshootingItem title="Remote Delegations settings are missing">
    Confirm that your organization has access and that you have the **Manager** or **Owner** role. Ask your Factory account team to check access if needed. Slack installation is no longer under **Settings → Organization**, and Remote Delegations settings are not available in airgapped deployments.
  </TroubleshootingItem>

  <TroubleshootingItem title="A preview delegation cannot start">
    Confirm that your Slack and Factory account emails match and that you belong to the connected Factory organization. For channel delegations, ask a Manager or Owner to check the Apps configuration's active service account, credentials, and compute. For DMs, check your personal credentials and connectors; a template-backed DM also needs access to managed compute. See [Remote delegations troubleshooting](/remote-delegations#troubleshooting) for template and computer availability errors.
  </TroubleshootingItem>

  <TroubleshootingItem title='"not_in_channel" error appears'>
    The Factory bot needs to be invited to that channel. Use `/invite @Factory` in the channel to resolve the issue.
  </TroubleshootingItem>

  <TroubleshootingItem title="Webhook communication is blocked">
    Check that your organization's firewall isn't blocking webhook communications.
  </TroubleshootingItem>

  <TroubleshootingItem title="Issue persists">
    Contact Factory support with specific error messages.
  </TroubleshootingItem>
</Troubleshooting>

<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>

Review Factory's <a href="https://factory.ai/privacy-policy">Privacy Policy</a> and <a href="https://factory.ai/legal/terms-individual">Terms of Service</a>.

<RelatedLinks>
  <RelatedLink href='/remote-delegations' title='Remote delegations'>
    Configure shared instructions, plugins, identity, and compute for the preview flow.
  </RelatedLink>
  <RelatedLink href='/software-factory/incident-response' title='Incident Response'>
    Set up an automation to investigate alerts from Slack.
  </RelatedLink>
  <RelatedLink href='/software-factory/triage' title='Triage'>
    Route Slack requests into tracked engineering work.
  </RelatedLink>
  <RelatedLink href='/enterprise/identity-and-access' title='Identity & Access'>
    Set up service accounts for shared Slack channel runs.
  </RelatedLink>
</RelatedLinks>