# Slack

### BetterBugs integration with Slack

You can connect BetterBugs to your Slack tool to send detailed visual bug reports straight to your Slack channel. It's super fast, and there's no need to copy-paste issues. With just a few clicks, your bug report is posted in your Slack workspace as a link.

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

{% embed url="<https://files.gitbook.com/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FBzBhuIUDDav7ztnadaoO%2Fuploads%2FpnnrdVSWRVqxX2rocbBE%2F01-Integrate-BetterBugs-Project-with-Slack.mp4?alt=media&token=80fd5d2a-6db4-4461-a18b-d2d6f3a90038>" %}
How to Integrate BetterBugs Project with Slack: Video Demo
{% endembed %}

{% hint style="info" %}
Here, we've covered the steps to integrate a single BetterBugs project (within your BetterBugs Workspace) with Slack. You can also integrate the complete BetterBugs Workspace in one go (that includes all the projects within your Workspace) to Slack or any other project tool. [**Check out the steps for Workspace Integration**](https://docs.betterbugs.io/dashboard/workspace-settings/integrations/workspace-integration)**.**
{% 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 Slack

In the **Integrations** tab, search for **Linear** and click to open the **Linear** 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 %}

#### **Authorize BetterBugs.io for Slack**

Select Slack Workspace you want to integrate with BetterBugs and click “**Accept**” to authorize it.

{% 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 Slack Channel 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 Slack, you'd need to manually select the channel your Slack workspace. Its a **FREE FEATURE**.
* **Automatic Ticket Creation:** This means for sharing a bug report to Slack, you can configure BetterBugs to auto-populate the channel name for Slack workspace. 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 tickets manually**. *Here, we've selected the manual method to showcase project integration steps.*
* **Automatically**: Enables you to [**create tickets with automation**](https://docs.betterbugs.io/dashboard/workspace-settings/integrations/project-integration/project-automation).
  {% 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 Slack. Now, you can create detailed reports and share them as Slack messages directly from your browser with a few clicks.

### How to Create Bug Report (as Message) on Slack Channel using BetterBugs

{% embed url="<https://files.gitbook.com/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FBzBhuIUDDav7ztnadaoO%2Fuploads%2FJaHv2QQaQwGZMZdqLyAf%2F02-Create-Bug-Report-and-Send-Instantly-as-Message-on-Slack.mp4?alt=media&token=c7081baf-72f1-4301-b771-eb4b5d8f1b80>" %}
How to Create Bug Report (as Message) on Slack Channel 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 Slack

From the two dropdowns above the description area, select:

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

{% step %}

#### Click "+ Send to your PM Tool" Dropdown and Select Slack Message

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

{% step %}

#### **Select Your Slack Channel and Hit "Next"**

Select the Slack channel you want the message to send and click "**Next**".
{% endstep %}

{% step %}

#### Create Session

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

There you go!

This instantly posts a message on your Slack channel packed with all the bug details and a link to the **complete bug report** with [**developer tools info**](https://docs.betterbugs.io/product-features/developer-tools).

* You can access the Slack message from the BetterBugs report from the "[**Comments & Activities**](https://docs.betterbugs.io/product-features/comments-activities)" tab located below the bug description area.
* Use the report link in your Slack message to access the complete report on BetterBugs.

### How to Send Existing BetterBugs Report to Slack Channel as a Message

{% embed url="<https://files.gitbook.com/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FBzBhuIUDDav7ztnadaoO%2Fuploads%2FcNkX5kUfHpheCAfFJhxy%2F03-Send-an-Existing-BetterBugs-Report-as-Slack-Message.mp4?alt=media&token=94719aa6-b804-462f-8650-4efe047eaef2>" %}
How to Send an Existing BetterBugs Report as Slack Channel as a Message: Video Demo
{% endembed %}

{% stepper %}
{% step %}

#### Open a Bug Report

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

{% step %}

#### Click "+ Send to your PM Tool" Dropdown and Select Slack Message

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

{% step %}

#### Select Your Slack Channel and Click "Create Task"

Select the Slack channel you want the message to send and click "**Create Task**".
{% endstep %}
{% endstepper %}

This instantly posts a message on your Slack channel packed with all the bug details and a link to the **complete bug report** with [**developer tools info**](https://docs.betterbugs.io/product-features/developer-tools).

* You can access the Slack message from the BetterBugs report from the "[**Comments & Activities**](https://docs.betterbugs.io/product-features/comments-activities)" tab located below the bug description area.
* Use the report link in your Slack message to access the complete report on BetterBugs.

### How to Disconnect BetterBugs Project from Slack

{% embed url="<https://files.gitbook.com/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FBzBhuIUDDav7ztnadaoO%2Fuploads%2F3MvFS8ylt9eSxT5pWFOD%2F04-Disconnect-BetterBugs-Project-from-Slack.mp4?alt=media&token=2fe9e2d1-a7d2-44a7-9fd9-e514c2ec9974>" %}
How to Disconnect BetterBugs Project from Slack: 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 Slack

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

{% step %}

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

In the Slack 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 Slack from the selected BetterBugs project.