Slack

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

Prerequisites

• A Factory account with the Manager or Owner role
• Admin access to your Slack workspace
• Ability to install apps in your Slack workspace

Integration steps

1. 1
   Access Slack integration settings

   Log in to your Factory account, open Settings → Organization, then find Slack under Org Integrations.

   

2. 2
   Initiate Slack Integration

   Click Connect, or Manage if Slack is already installed, to start the integration process. If you are updating an existing Slack install for the latest permissions, click Reconnect from the integration details to rerun the install flow.

   

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

4. 4
   Select Workspace

   If you belong to multiple workspaces, select the workspace you want to connect to Factory.

5. 5
   Confirm Integration

   After authorization, you'll be redirected back to Factory. Verify that the integration status shows as "Connected".

6. 6
   Add to Channels

   In your Slack workspace, add the Factory app to relevant channels by typing /invite @Factory in each channel.

Verification

To ensure the integration is working correctly:

1. 1
   Mention @Factory in a thread within a channel where the app has been added.
2. 2
   Verify that Factory responds with a link to open the conversation in Factory.
3. 3
   Click the link and confirm that the Slack thread content appears in your new Factory session.
4. 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. 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
• Use any model you want, no lock-in. Factory is model-agnostic: choose Claude, GPT, Gemini, open-source/Droid Core, or any of 30+ supported models
• Pick the model when you start a session, set a default model per channel for Auto-Run and service-account workflows, or let Factory Router pick the best model automatically
• Reference Slack threads in Factory by pasting a thread URL into a Factory chat

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

After Slack is connected, click Manage from Settings → Organization to configure Slack channel settings. These settings are only needed for Incident Response and service-account workflows; standard @Factory mentions work without configuring channels here.

In channel settings, you can enable a channel, expand it, and configure Run as, Incident Response, Machine Type, Computer or Workspace, Session Visibility, Model, and Custom Prompt. Only channels where the Factory app has been invited appear in this list.

Service accounts

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

1. 1
   Open Slack channel settings

   In Factory, open Settings → Organization, find Slack under Org Integrations, and click Manage to open channel settings. Enable the channel and expand its settings.

2. 2
   Choose the run identity

   If the Run as row appears, select the service account. Selecting a service account makes the channel run with that service account's identity and computers.

3. 3
   Choose the computer

   Service account Slack sessions run on Droid Computers. When a service account is selected, Factory locks the target to Computer and only shows computers owned by that service account.

4. 4
   Configure Auto-Run if needed

   For automated channel workflows, turn on Auto-Run and configure the prompt, model, and visibility settings for that channel.

5. 5
   Test from Slack

   Mention @Factory in the channel, or send a test alert if Auto-Run is enabled. Factory starts the session as the selected service account.

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.

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