# Bugasura

### BetterBugs integration with Bugasura

Now you can integrate BetterBugs with Bugasura for even better bug tracking and debugging workflows.

{% hint style="warning" %}
**PREREQUISITE: Bugasura User API Key**

You'd need your Bugasura account User API key to integrate BetterBugs. Here're the steps to get it:

1. Log into your Bugasura account
2. Click the user avatar from the bottom left screen to open User Profile 
3. Copy the User API key and keep it handy to use for the integration steps.
   {% endhint %}

### How to Integrate BetterBugs Project with Bugasura: Step-by-Step

{% embed url="<https://files.gitbook.com/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FBzBhuIUDDav7ztnadaoO%2Fuploads%2Ffk2wiwCeVOuRwjgBzewo%2F01-Integrate-BetterBugs-with-Bugasura.mp4?alt=media&token=f6bea25e-0ae8-4951-b22a-a335bf9e9b4e>" %}
How to Integrate BetterBugs Project with Bugasura: Video Demo
{% endembed %}

{% hint style="info" %}
Here, we've covered the steps to integrate a single BetterBugs project (within your BetterBugs Workspace) with Bugasura. You can also integrate the complete BetterBugs Workspace in one go (that includes all the projects within your Workspace) to Bugasura or any other project tool. [**Check out the steps for Workspace Integration**](/dashboard/workspace-settings/integrations/workspace-integration.md)**.**
{% endhint %}

{% stepper %}
{% step %}

#### Open Workspace Settings > Integrations

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

{% step %}

#### Search Click Up

In the **Integrations** tab, search for **Bugasura** and click to open the **Bugasura** card.
{% endstep %}

{% step %}

#### Turn off workspace-wide integration

Toggle off the "**All Projects**" option and hit "**Continue**". You should see the "**Manage per project**" option now.

{% hint style="info" %}
By default, its turned on for workspace level integration. For project-wise integration, you need to disable "**All Projects**".
{% endhint %}
{% endstep %}

{% step %}

#### Select a BetterBugs project to integrate and hit "Connect"

Select a project from the projects name list (that's within your Workspace). From the "**Actions**" column, hit "**Connect**" for that project.
{% endstep %}

{% step %}

#### Add User API Key for Bugasura

Add the **User API key** for your Bugasura Workspace and hit “**Connect**”.

{% hint style="warning" %}
**IMPORTANT NOTE**&#x20;

If you're on a **free plan**, Steps 6 and 7 are **NOT REQUIRED**. **You can just SKIP** to "*How to Create Bug Report on Bugasura using BetterBugs*" section on this page.

**FOR PAID PLANS (Teams and Enterprise)**

Steps 6 and 7 enables you to explicitly choose between:

* **Manual Ticket Creation (Default)**: This means for sharing a bug report to Bugasura, you'd need to manually populate fields for your Bugasura project (**Team**, **Project**, **Sprint**, **Assignees**, and others). Its a **FREE FEATURE**.
* **Automatic Ticket Creation:** This means for sharing a bug report to Bugasura, you can configure BetterBugs to auto-populate fields for your Bugasura project (**Team**, **Project**, **Sprint**, **Assignees**, and others). Its a **PAID FEATURE**.
  {% endhint %}
  {% endstep %}

{% step %}

#### Optional: Choose your preferred method for creating tickets: Manually or Automatically

From the "**Forward Bug Reports**" dropdown, select your preferred method for creating tickets in your project tool:

* **Manually**: Enables you to **create tasks manually**. *Here, we've selected the manual method to showcase project integration steps.*
* **Automatically**: Enables you to [**create task with automation**](/dashboard/workspace-settings/integrations/project-integration/project-automation.md).
  {% endstep %}

{% step %}

#### Optional: Select "Manually" and Connect

Finally, select "**Manually**" from the "**Forward Bug Reports**" dropdown and hit "**Connect**".
{% endstep %}
{% endstepper %}

Okay! You're good to go with the Project level integration for Bugasura. Now, you can create detailed reports and share them as Bugasura tickets directly from your browser with a few clicks.

### How to Create Bug Report on Bugasura using BetterBugs

{% embed url="<https://files.gitbook.com/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FBzBhuIUDDav7ztnadaoO%2Fuploads%2FkXlPg0erz3ZRBJLMK7u1%2F02-Create-Bug-Report-on-Bugasura.mp4?alt=media&token=f9d5583a-5742-4826-82f0-1c5d30db5a3c>" %}
How to Create Bug Report on Bugasura using BetterBugs: Video Demo
{% endembed %}

{% stepper %}
{% step %}

#### Capture the Bug and Add Bug Details

Use the BetterBugs extension to capture the bug and add details for it. You can add the details (*Title + Quick Summary + Steps to Reproduce*) manually in the description area manually or automatically with the "**AI**" toggle.
{% endstep %}

{% step %}

#### Select BetterBugs Workspace and Project Integrated with Bugasura

From the two dropdowns above the description area, select:

* **BetterBugs Workspace**
* **BetterBugs Project** (that you integrated with Bugasura)
  {% endstep %}

{% step %}

#### Click "+ Send to your PM Tool" Dropdown and Select Bugasura Tracker

Open "**+ Send to your PM Tool**" dropdown and select "**Bugasura Tracker**".
{% endstep %}

{% step %}

#### **Populate Ticket Details for Bugasura and Hit "Next"**

Populate Bugasura Fields for the report: **Team**, **Project**, **Sprint**, **Assignees**, and others and click "**Next**".
{% endstep %}

{% step %}

#### Create Session

From the top right, click "**Create Session**".
{% endstep %}
{% endstepper %}

There you go!

A new tab with the Bugasura task opens up posting the task to the Bugasura project packed with all the bug details and a link to the **complete bug report** with [**developer tools info**](/product-features/developer-tools.md).

* Use the report link in your Bugasura task to access the complete report on BetterBugs.
* You can also access the Bugasura Task from the BetterBugs report from the "[**Comments & Activities**](/product-features/comments-activities.md)" tab located below the bug description area.

### How to Send Existing BetterBugs Report to Bugasura

{% embed url="<https://files.gitbook.com/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FBzBhuIUDDav7ztnadaoO%2Fuploads%2FKXxNNwYGMOCJoidsTM4y%2F03-Send-Existing-Bug-Report-to-Bugasura.mp4?alt=media&token=f51bdd9a-f527-4c52-a0af-ff50e8e706c5>" %}
How to Send Existing BetterBugs Report to Bugasura: Video Demo
{% endembed %}

{% stepper %}
{% step %}

#### Open a Bug Report

Login to BetterBugs and open a project report to share on Bugasura.
{% endstep %}

{% step %}

#### Click "+ Send to your PM Tool" Dropdown and Select Bugasura Tracker

From the top-right of the report screen, open "**+ Send to your PM Tool**" dropdown and select "**Bugasura Tracker**".
{% endstep %}

{% step %}

#### Populate Task Details for Bugasura and Click "Create Task"

Populate Bugasura Fields for the report: **Team**, **Project**, **Sprint**, **Assignees**, and others and click "**Create Task**".
{% endstep %}
{% endstepper %}

Okay! You're all set. This instantly should create Bugasura ticket with the BetterBugs bug report.

### How to Disconnect BetterBugs Project from Bugasura

{% embed url="<https://files.gitbook.com/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FBzBhuIUDDav7ztnadaoO%2Fuploads%2F7NHmvMOKOLDYoUG3rt65%2F04-Disconnect-BetterBugs-project-from-Bugasura.mp4?alt=media&token=31eb8607-9e25-4bb9-b3d3-93e26c1175d3>" %}
How to Disconnect BetterBugs Project from Bugasura: Video Demo
{% endembed %}

{% stepper %}
{% step %}

#### Open Project Settings

Use the **Gear Icon** beside the **BetterBugs Project** **Name** to open **Project Settings**.
{% endstep %}

{% step %}

#### Go to Workspace Settings > Integrations

Navigate to **Workspace Settings** > **Integrations**
{% endstep %}

{% step %}

#### Search Bugasura

In the **Integrations** tab, search for **Bugasura** and click to open the **Bugasura** card.
{% endstep %}

{% step %}

#### Select BetterBugs project to disconnect and click (⋮) under "Actions"

In the Click Up card, select the BetterBugs project (from the Project list) to disconnect. For the project, click vertical dots (**⋮**) under the **Actions** column.
{% endstep %}

{% step %}

#### Disconnect and Confirm Action

To confirm action, click "**Disconnect**" and "**Continue**".
{% endstep %}
{% endstepper %}

This instantly disconnects Bugasura from the selected BetterBugs project.


---

# 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/product-features/integrations/bugasura.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.