This guide will walk you through the process of integrating Factory with Slack, enabling seamless interaction between Factory and your Slack conversations.

​
Prerequisites

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

​
Integration Steps

1

Access Factory Integrations

Log in to your Factory account and navigate to the Integrations section in your Settings.

2

Initiate Slack Integration

Click on “Connect” next to Slack to start the integration process.

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

Select Workspace

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

5

Confirm Integration

After authorization, you’ll be redirected back to Factory. Verify that the integration status shows as “Connected”.

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

​
Usage

The Slack integration 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.

Security and Compliance

Learn about Factory’s security measures and how we protect your data