# Workspace Automation

### How it works <a href="#how-it-works" id="how-it-works"></a>

Once you connect your BetterBugs.io to your project tool at the workspace level, you can pre-configure values for the fields of that specific tool(s). So, whenever you create a bug report, you don’t have to populate the details manually for that connected tool.

Just **create and upload the report** to your BetterBugs.io project, and the report will **instantly be auto-shared to the integrated project tool.**

With one click, you’re good to go. No other steps are required. This means you don’t have to juggle tools or search for details about the project tool workspace to which the report has to be shared, saving you extra time, effort, and mouse and keyboard clicks.

### How to Integrate BetterBugs Workspace to Your PM Tool with Automation: Linear Example <a href="#steps-to-integrate-your-project-tool-at-the-workspace-level" id="steps-to-integrate-your-project-tool-at-the-workspace-level"></a>

{% embed url="<https://files.gitbook.com/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FBzBhuIUDDav7ztnadaoO%2Fuploads%2FWVEmkJ6f3l5WJkjreWaG%2F01-Enable-Workspace-wide-Automation-for-All-BetterBugs-Projects-for-Linear.mp4?alt=media&token=180ae845-5bb6-437d-b185-8c47ee9e06a3>" %}

{% hint style="success" %}
Here, we've covered the end-to-end steps to:

* Integrate Project Tool at Workspace Level
* Automation&#x20;

For manual integration only, check out the [Workspace Integration](/dashboard/workspace-settings/integrations/workspace-integration.md) Page.
{% endhint %}

{% stepper %}
{% step %}

#### Open Workspace Settings > Integrations

Click on BetterBugs Workspace name at the top left side. Now, click the **gear icon** to open **Workspace Settings** > **Integrations.**
{% endstep %}

{% step %}

#### Search Linear <a href="#select-your-project-tool" id="select-your-project-tool"></a>

In the **Integrations** tab, select your preferred tool and click on the tool's card. For instance, let's open **Linear** app's card.
{% endstep %}

{% step %}

#### Turn on workspace-wide integration

Make sure that that the toggle is **ON** for "**All Projects**".

{% hint style="info" %}
By default, its turned on for workspace level integration.
{% endhint %}
{% endstep %}

{% step %}

#### Connect

Next, hit “**Connect**” at the top right.
{% endstep %}

{% step %}

#### Authorize BetterBugs.io <a href="#authorize-betterbugs.io" id="authorize-betterbugs.io"></a>

Hit “**Authorize**” to authorize BetterBugs.io for your Linear Workspace.
{% endstep %}

{% step %}

#### Choose your preferred method for creating tickets

From the "**Forward Bug Reports**" dropdown, select "**Automatically**".&#x20;

{% hint style="info" %}
This fetches the Linear template with the available fields for automation. This enables you to configure automated ticket creation for Linear (or any other tools). This means while sharing a bug report to Linear, this would auto-populate fields for your Linear project (**Team**, **Project**, **Priority**, and others).&#x20;
{% endhint %}
{% endstep %}

{% step %}

#### Enter default field values

Add details for the available fields, such as **Team**, **Project**, **Priority**, and others.

These details would be used as defaults for every report you create and upload. **For instance**, if you are reporting only **bugs** for your projects, you can pre-configure the details for it, so you don’t have to fill in the details every time you report a bug to your project tool.
{% endstep %}

{% step %}

#### Confirm action

Finally, click “**Connect**” and you’re good to go.
{% endstep %}
{% endstepper %}

{% hint style="success" %}
You can follow the same steps to configure automation for other project tools.
{% endhint %}


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.betterbugs.io/dashboard/workspace-settings/integrations/workspace-integration/workspace-automation.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.