This guide will walk you through the process of integrating Factory with Confluence, enabling Droids to access and interact with your Confluence pages.

​
Prerequisites

  • Admin access to your Confluence workspace
  • A Factory account with admin privileges

​
Integration Steps

1

Create a Confluence Service Account

1

Create New User

In your Confluence workspace, create a new user account specifically for Factory integration.

2

Set Permissions

Configure the service account’s permissions to limit access to only the necessary Confluence spaces and pages.

2

Access Factory Integrations

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

3

Initiate Confluence Integration

Locate and select the Confluence integration option.

4

Authorize Factory's Confluence Application

1

Switch to Service Account

Before authorizing, switch to an incognito browser window and log in with the Confluence service account you created.

2

Review Permissions

Carefully review the scopes and permissions requested by the integration.

3

Authorize Access

Click “Accept” to allow Factory access to your Confluence workspace.

5

Confirm Integration

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

​
Using the Integration

To use the Confluence integration in your workflow:

  1. When creating a new Pull Request, add the following command in the PR body: 
    @droid fill <CONFLUENCE PAGE URL>
  2. Replace <CONFLUENCE PAGE URL> with the actual URL of the Confluence page you want to reference.
  3. The Droid will access the specified Confluence page and use its content in the context of the PR.

​
Best Practices

  • Use a dedicated service account with limited permissions for the integration.
  • Regularly review and audit the permissions granted to Factory.
  • Keep your Confluence workspace’s security settings up-to-date.

​
Troubleshooting

If you encounter issues during integration:

  • Ensure you’re logged in as the service account when authorizing the integration.
  • Check Confluence’s audit logs for any permission-related issues.
  • Verify that the service account has the necessary permissions for the intended spaces and pages.

For persistent problems, contact Factory support with specific error messages or screenshots.

Factory is continuously working on expanding the features of the Confluence integration. Stay tuned for updates and new capabilities.

Security and Compliance

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

LinearConfiguring Your Droid YAML