> For the complete documentation index, see [llms.txt](https://help.timebook.ai/hc/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://help.timebook.ai/hc/integrations/slack.md).

# Slack

Reading time: 6 minutes

Slack integration lets you collect user feedback from messages sent to the selected Slack channel.

{% hint style="info" %}
**What you need to know:**

* Slack integration is available from Pro plan onwards.
* In order to add the integration, you must have admin permissions.
* The email address of the configuring person **must be the same** for Slack and Timebook.
  {% endhint %}

### Configuration

{% stepper %}
{% step %}
The first step is installing the Timebook app in your Slack workspace. Go to your **workplace settings**, switch to the **Integrations** tab and click **Slack**:

<figure><img src="https://3284049081-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FvCMXgzPoiE4UXP4jn6B8%2Fuploads%2FGd5mphkX2fK0sfcOV5pA%2Fslack-1.png?alt=media&amp;token=8d20d337-b3e6-4c25-a057-2582cc76bb39" alt=""><figcaption><p>Slack on integrations list in workplace settings</p></figcaption></figure>
{% endstep %}

{% step %}
Paste the URL to your Slack workspace and click 'Connect':

<div align="left"><figure><img src="https://3284049081-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FvCMXgzPoiE4UXP4jn6B8%2Fuploads%2Fgm4SHbm5plDSPfyGf9NF%2Fslack-2.png?alt=media&amp;token=5af45275-0721-46e7-8848-66729402b213" alt="" width="375"><figcaption><p>Slack workspace URL configuration</p></figcaption></figure></div>
{% endstep %}

{% step %}
Slack will list the permissions that our bot requires to operate in your workspace. Click 'Allow' to finish workspace configuration.

<div align="left"><figure><img src="https://3284049081-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FvCMXgzPoiE4UXP4jn6B8%2Fuploads%2FlLTHBTyF2eaAAAynTLDs%2FCleanShot%202026-06-26%20at%2014.57.53.png?alt=media&amp;token=c10613ac-c46e-4e94-99eb-2e751837bb21" alt="" width="375"><figcaption><p>Slack authorization consent screen</p></figcaption></figure></div>
{% endstep %}

{% step %}
The last step is enabling integration for your personal Slack user. Go to your **user settings**, switch to the **Integrations** tab, and flip the switch at Slack:

<figure><img src="https://3284049081-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FvCMXgzPoiE4UXP4jn6B8%2Fuploads%2F0eu1lYw0PxNOYc3ymuAi%2Fslack-4.png?alt=media&amp;token=035f7308-6462-4158-90a5-d8ce38a26301" alt=""><figcaption><p>Slack integration in user settings</p></figcaption></figure>
{% endstep %}

{% step %}
Review the permissions and click 'Allow' to finish configuration.
{% endstep %}
{% endstepper %}

### **Adding bot to your Slack channel**

{% hint style="info" %}
**What you need to know**

* Slack channels are assigned to products in Timebook.
* One product can be integrated with one Slack channel.
* Messages sent to the Slack channel are reproduced as tickets in the feedback inbox of the product.
* Messages added to the thread in Slack are reproduced as comments of the ticket in Timebook.
  {% endhint %}

With the integration configured, you can now map the channel that you want to listen to:

{% stepper %}
{% step %}
Go to the **product settings**, switch to the **Feedback** tab and click **Slack**:

<div align="left"><figure><img src="https://3284049081-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FvCMXgzPoiE4UXP4jn6B8%2Fuploads%2F3pFwG1CSNz21AlquIvu4%2Fslack-5.png?alt=media&amp;token=1e7f7270-c50a-4cd7-951a-a1969035e41a" alt="" width="563"><figcaption><p>Slack as feedback source in product settings</p></figcaption></figure></div>
{% endstep %}

{% step %}
Flip the switch to enable Slack integration in your product. Next, select the **source channel** whose messages you want to reproduce to tickets:

<figure><img src="https://3284049081-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FvCMXgzPoiE4UXP4jn6B8%2Fuploads%2FExNKODXWP7MV5GLxhYGX%2Fslack-6.png?alt=media&amp;token=f23ef80c-c8d6-4568-afc3-bc6bdb7f357b" alt=""><figcaption><p>Source channel selector</p></figcaption></figure>
{% endstep %}
{% endstepper %}
