# Slack

Connect your Slack workspace to ProductLogz to receive instant notifications when customers submit feedback, and manage posts directly from Slack.

***

### Getting Started

#### Connect Slack to ProductLogz

1. Go to **Settings > Integrations** in your ProductLogz dashboard
2. Find the **Slack** card and toggle it **on**
3. A Slack authorization window will open — select the workspace you want to connect
4. Click **Allow** to grant ProductLogz the required permissions
5. You'll be redirected back to your dashboard with a success confirmation

After connecting, you'll see a prompt to configure your notification channel. Notifications won't be sent until you complete this step.

#### Configure Notifications

1. On the Slack integration card, click the **Settings** (gear) icon
2. Select a **Notification Channel** from the dropdown — this is where ProductLogz will post alerts
   * Both public and private channels are supported
   * Private channels are marked with a lock icon
3. Check **Enable Slack Notifications** to turn on alerts
4. Click **Save Settings**

> **Note:** The ProductLogz bot must be a member of the selected channel. It will automatically join public channels when the first notification is sent. For private channels, you'll need to manually invite the bot by typing `/invite @ProductLogz` in the channel.

***

### Features

#### 1. New Feedback Notifications

When a customer submits feedback on your public board, ProductLogz sends a notification to your configured Slack channel.

**The notification includes:**

* Feedback title and description (first 200 characters)
* Category
* Status

**What you see depends on your Post Moderation setting:**

**If Post Moderation is ON** — the notification includes **Approve** and **Trash** action buttons so you can review feedback without leaving Slack.

```
-----------------------------------------
  New Customer Feedback

  *Allow dark mode in the app*
  It would be great to have a dark mode
  option for the dashboard...

  Category: Feature
  Status: Pending

  [Approve]  [Trash]
-----------------------------------------
```

**If Post Moderation is OFF** — the notification includes a **View Feedback** link to open the post in your ProductLogz dashboard.

```
-----------------------------------------
  New Customer Feedback

  *Allow dark mode in the app*
  It would be great to have a dark mode
  option for the dashboard...

  Category: uncategorized
  Status: open

  View Feedback in ProductLogz
-----------------------------------------
```

***

#### 2. Approve or Trash Feedback from Slack

When Post Moderation is enabled, you can approve or trash feedback posts directly from the Slack notification — no need to open your dashboard.

* Click **Approve** to set the post status to "open" and make it visible on your public board
* Click **Trash** to reject the post

After clicking a button, the notification updates to show the action taken and who performed it:

```
-----------------------------------------
  New Customer Feedback

  *Allow dark mode in the app*
  ...

  Category: Feature
  Status: Approved

  Approved by @yourname | View in ProductLogz
-----------------------------------------
```

***

#### 3. Send Slack Messages to ProductLogz

You can turn any Slack message into a ProductLogz feedback post — useful for capturing feature requests or bug reports that come up in team conversations.

**How to use:**

1. Hover over a message in Slack
2. Click the **three-dot menu** (More actions)
3. Select **Send to ProductLogz**
4. A form will open pre-filled with the message content:
   * **Title** — auto-generated from the message text (editable)
   * **Description** — full message content
   * **Category** — choose from Feature, Bug, Improvement, or Other
   * **Customer Email** — optionally add the customer's email for tracking
5. Click **Submit**

The feedback post is created in ProductLogz. If Post Moderation is enabled, it will be set to "pending" for admin review. Otherwise, it goes live immediately.

A confirmation message will appear in Slack with a link to view the feedback in your dashboard.

***

#### 4. Disconnect Slack

You can disconnect the integration at any time:

1. Go to **Settings > Integrations**
2. Toggle the Slack integration **off**
3. Confirm the disconnection

This removes the connection between your ProductLogz workspace and Slack. All Slack-related metadata stored on feedback posts will also be cleared.

> **Note:** If someone uninstalls the ProductLogz app directly from your Slack workspace (via Slack's App Management), the integration will be automatically disconnected on the ProductLogz side as well.

***

### FAQ

**Q: Which events trigger a Slack notification?** Currently, Slack notifications are sent when new feedback is submitted on your public board. Email notifications cover additional events like status changes, upvotes, and comments — these can be configured in your notification preferences.

**Q: Why am I not receiving Slack notifications?** Check the following:

1. The Slack integration is connected (toggle is on)
2. A notification channel is selected in settings
3. Notifications are enabled (checkbox is checked)
4. The ProductLogz bot has access to the channel — for private channels, invite the bot with `/invite @ProductLogz`

**Q: Can I change the notification channel later?** Yes. Click the Settings icon on the Slack card, select a different channel from the dropdown, and save.

**Q: What happens if I reinstall the Slack app?** Your notification channel and settings are preserved when you reinstall. You don't need to reconfigure anything.

**Q: Do Slack notifications work with private channels?** Yes. Select a private channel from the dropdown in settings. Make sure the ProductLogz bot is invited to the channel.


---

# 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://help.productlogz.com/integrations/slack.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.
