# Slack

## Overview

This integration allows you to:

* **Send survey data to Slack** when a response is received.
* Easily collaborate and share survey response data in Slack to leverage user insights across product development.

<figure><img src="https://2794860263-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FKzAcDWQbK1gKbpra7bkb%2Fuploads%2FbpUhqgxwSBl7FUiwt0NW%2Fimage.png?alt=media&#x26;token=ff499f6c-9a69-424c-8922-1fd48988b539" alt=""><figcaption><p>Example</p></figcaption></figure>

## Setting Up the Slack Integration

#### Access the Integrations Dashboard

1. Navigate to your Jimo [project settings](https://i.usejimo.com/settings/integrations).
2. Click on **Integrations** in the left sidebar.
3. Locate the **Slack** integration and click on the **Connect** button.

<figure><img src="https://2794860263-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FKzAcDWQbK1gKbpra7bkb%2Fuploads%2FLvzYr05LrlYlA8lzYvNc%2Fimage.png?alt=media&#x26;token=3f54493a-f329-4c2f-abd0-b673e728eee6" alt=""><figcaption><p>Integration settings</p></figcaption></figure>

### Authorize Jimo in Slack

1. You will be redirected to a Slack authorization page.
2. Grant the necessary permissions to allow Jimo to access your Slack workspace.

<figure><img src="https://2794860263-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FKzAcDWQbK1gKbpra7bkb%2Fuploads%2FS7TaM5fap47kn6Bss3xz%2Fimage.png?alt=media&#x26;token=8c571be9-83d3-4dcc-90fc-cfec10a94a19" alt="" width="482"><figcaption><p>Slack permission</p></figcaption></figure>

### Confirm Slack Integration

1. Once authorized, you will be redirected back to Jimo.
2. The Slack integration setup page will display a confirmation that your Slack workspace is connected.

<figure><img src="https://2794860263-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FKzAcDWQbK1gKbpra7bkb%2Fuploads%2F51xdNvdiqLCZCkluvSyP%2Fimage.png?alt=media&#x26;token=b37d286b-2800-4da5-80b9-f980fe846344" alt=""><figcaption><p>Slack integration details</p></figcaption></figure>

* **A**: How it works section.
* **B**: Slack workspace integration status.
* **C**: Resource links for the official Slack documentation and website.
* **D**: Button to disconnect the integration if needed.

## Configuring the Slack Integration

Once your Slack workspace is connected, you can customize what information is sent in your survey notifications.

### Access Slack Integration Settings

1. Go to your [integration settings](https://i.usejimo.com/settings/integrations/slack).
2. In the **Integrations** tab, hover over the **Slack** card — the **Connect** button will now display **Configure**.
3. Click **Configure** to open your Slack integration details.

<figure><img src="https://2794860263-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FKzAcDWQbK1gKbpra7bkb%2Fuploads%2FHExXXjt8OPjOVyeWZRRl%2Fimage.png?alt=media&#x26;token=eae0799f-fd51-4a23-9b85-15f7a556148d" alt=""><figcaption></figcaption></figure>

### Customize “Properties to Send”

You can now decide which **user properties** are included in the Slack messages triggered by survey responses.

By default, Jimo sends:

* **Email**
* **Name**
* **ID**

These default properties can be **removed** at any time.

<figure><img src="https://2794860263-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FKzAcDWQbK1gKbpra7bkb%2Fuploads%2FiGgKW1ZTRGL4xJDLRpJ0%2Fimage.png?alt=media&#x26;token=d3c0e79d-4d22-4ac3-8d6e-80f504c90b43" alt=""><figcaption></figcaption></figure>

* You can also **add new properties**, including:
  * Native attributes (e.g. *Last activity*, *Created on*)
  * **Custom attributes** synced from your user data

<figure><img src="https://2794860263-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FKzAcDWQbK1gKbpra7bkb%2Fuploads%2FXv1Ks09H5K4TLlqY7amS%2Fimage.png?alt=media&#x26;token=1c239961-2e1d-4a69-91fa-c2febca10686" alt="" width="502"><figcaption></figcaption></figure>

Click **Add**, select your desired properties, and confirm by clicking **“Add properties”**.

***

## Configuring Slack Notifications for Surveys

### Access Survey Integrations

1. Go to any survey's detailed view in your [Jimo dashboard](https://i.usejimo.com/surveys).
2. Under the **Insights** section, click on the **Integrations** tab.

<figure><img src="https://2794860263-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FKzAcDWQbK1gKbpra7bkb%2Fuploads%2F9KmPBFjDqi7QtxosYRqE%2Fimage.png?alt=media&#x26;token=3d1a295f-90d6-4986-9d63-04d54a564085" alt=""><figcaption><p>Slack integration settings</p></figcaption></figure>

* **A**: Integrations tab.
* **B**: Slack integration status. -> [Set it up if not connected.](#setting-up-the-slack-integration)
* **C**: Select channels to send responses.
* **D**: Option to receive [Slack notifications for each answer](#customize-notification-settings).

### Select Slack Channels

1. Ensure that your Slack integration status is **Connected**.
2. Select the Slack channels where you want to send survey responses.

<figure><img src="https://2794860263-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FKzAcDWQbK1gKbpra7bkb%2Fuploads%2Fg5MfPtbVq1raTemkEi0Y%2Fimage.png?alt=media&#x26;token=59a772d9-1a70-426a-b9fd-78c4b48d7249" alt=""><figcaption><p>Channels selection</p></figcaption></figure>

* **A**: Public channels will appear automatically.
* **B**: For private channels, invite the Jimo bot using the command `/invite @Jimo`.
* **C**: Save your selection.

### Customize Notification Settings

1. By default, Jimo will send a summary message of all survey responses upon survey completion.
2. If you want to receive notifications for each individual survey response as they are submitted, enable the option to receive Slack notifications for each answer.

<figure><img src="https://2794860263-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FKzAcDWQbK1gKbpra7bkb%2Fuploads%2FkpCiWZiJEVgcN9cW389z%2Fimage.png?alt=media&#x26;token=2d457b4a-0cc4-478c-8868-c3beb6fbe341" alt=""><figcaption><p>Notifications for each answers</p></figcaption></figure>

## Troubleshooting

* If you do not see certain channels, ensure that the Jimo bot is invited to those channels.
* Verify that the Slack integration status is connected in the survey's integration tab.

### Disconnecting the Integration

If you wish to disconnect Jimo from Slack, navigate back to the Slack integration setup page in Jimo and click on the **Disconnect Integration** button.

## Additional Resources

* **Slack Documentation**: [Link to Slack Documentation](https://docs.slack.dev/)
* **Slack Website**: [Visit Slack Website](https://slack.com/)

{% hint style="info" %}
To keep a historical log of [survey responses](https://help.usejimo.com/docs/experiences/surveys/overview), configure your Slack integration to capture and store each survey response externally.&#x20;

This approach ensures all answers are preserved, even if users update their responses in Jimo.
{% endhint %}

For further assistance, please refer to this support page or contact our support team directly.
