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

# Slack

Post survey responses to the Slack channels you choose, with the user properties your team needs to follow up.

The Slack integration posts survey responses to the Slack channels you pick. Your team reads answers where it already works, with the user properties it needs to follow up.

<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&amp;token=ff499f6c-9a69-424c-8922-1fd48988b539" alt="A survey response posted in a Slack channel"><figcaption></figcaption></figure>

## What it does

* Posts a summary of a user's answers when they complete a survey, or each answer as it is submitted if you turn that on.
* Adds the user properties you choose to each message. By default: email, name and ID.
* Works per survey: you connect Slack once, then pick channels in each survey.

<figure><img src="https://2794860263-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FKzAcDWQbK1gKbpra7bkb%2Fuploads%2FZDi6pcyRQZNuSdCvz0uX%2FF2-56a-automation-out-slack.png?alt=media&amp;token=ce31dd57-ad8c-4252-be3a-2c8b82282bec" alt="Jimo posts survey responses to the Slack channels you pick in each survey. Zapier and webhooks, the other outbound integrations, are greyed out"><figcaption></figcaption></figure>

## Before you start

* A Slack workspace where you can authorize apps.
* A Jimo role with access to the Integrations settings, to connect Slack. See [Integration setup](https://help.usejimo.com/docs/integrations/integration-setup.md).
* Edit rights on experiences, to pick channels on a survey: the setting lives in the survey.

## Connect Slack

{% stepper %}
{% step %}

### Enable Slack

In [Settings > Integrations](https://i.usejimo.com/settings/integrations), hover the Slack card, click **Enable**, then connect from the setup page.

<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&amp;token=3f54493a-f329-4c2f-abd0-b673e728eee6" alt="Slack card in Settings > Integrations"><figcaption></figcaption></figure>
{% endstep %}

{% step %}

### Authorize Jimo in Slack

Slack opens its authorization page. Grant the permissions Jimo asks for.

<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&amp;token=8c571be9-83d3-4dcc-90fc-cfec10a94a19" alt="Slack authorization page"><figcaption></figcaption></figure>
{% endstep %}

{% step %}

### Check the confirmation

Back in Jimo, the Slack setup page shows that your workspace is connected. The same page has the disconnect button.

<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&amp;token=b37d286b-2800-4da5-80b9-f980fe846344" alt="Slack integration details with the workspace connected"><figcaption></figcaption></figure>
{% endstep %}
{% endstepper %}

## Choose the user properties to send

Open the [Slack integration settings](https://i.usejimo.com/settings/integrations/slack): hover the Slack card and click **Configure**.

<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&amp;token=eae0799f-fd51-4a23-9b85-15f7a556148d" alt="Configure button on the Slack card"><figcaption></figcaption></figure>

Under **Properties to send**, remove the default properties you do not need, or click **Add**, pick native attributes (such as Last activity or Created on) or custom attributes, and confirm with **Add properties**.

<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&amp;token=d3c0e79d-4d22-4ac3-8d6e-80f504c90b43" alt="Properties to send, with email, name and ID"><figcaption></figcaption></figure>

<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&amp;token=1c239961-2e1d-4a69-91fa-c2febca10686" alt="Add properties dialog"><figcaption></figcaption></figure>

## Send a survey to Slack

{% stepper %}
{% step %}

### Open the survey's integrations

Open a survey from your [surveys list](https://i.usejimo.com/surveys). Under **Insights**, open 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&amp;token=3d1a295f-90d6-4986-9d63-04d54a564085" alt="Integrations tab of a survey"><figcaption></figcaption></figure>
{% endstep %}

{% step %}

### Select the channels

Check that Slack shows **Connected**, then select the channels. Public channels are listed. For a private channel, invite the bot first with `/invite @Jimo` in that channel. Save.

<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&amp;token=59a772d9-1a70-426a-b9fd-78c4b48d7249" alt="Channel selection for a survey"><figcaption></figcaption></figure>
{% endstep %}

{% step %}

### Choose when to post

By default, Jimo posts a summary of the responses when a user completes the survey. Turn on notifications for each answer to receive them as they are submitted.

<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&amp;token=2d457b4a-0cc4-478c-8868-c3beb6fbe341" alt="Option to notify for each answer"><figcaption></figcaption></figure>
{% endstep %}
{% endstepper %}

## Verify

Answer the survey yourself on your app. The message arrives in the channels you selected, with the properties you chose.

{% hint style="info" %}
Users can change an answer later in Jimo. Slack keeps the message as it was posted, which gives you a history of answers as they were given.
{% endhint %}

## Limits

#### Surveys only

Only survey responses post to Slack. For a tour or checklist completion, or a tracked event, use [Webhooks](https://help.usejimo.com/docs/integrations/webhooks.md) with your own Slack app, or [Zapier](https://help.usejimo.com/docs/integrations/zapier.md) for feedback.

#### Message format

You choose the properties in the message, not its layout or its buttons.

## Troubleshooting

#### A channel is missing

Private channels appear only after you invite the bot with `/invite @Jimo` in the channel.

#### The channel list shows "No options"

Slack shows as Connected but lists no channels: your Slack account likely lacks the permissions to list them. Ask a Slack workspace admin to grant access, or to pick the channels for you.

#### Disconnect

On the Slack setup page in Jimo, click **Disconnect Integration**.

## Related

* [Zapier](https://help.usejimo.com/docs/integrations/zapier.md)
* [Surveys](https://help.usejimo.com/docs/experiences/surveys.md)
* [Slack documentation](https://docs.slack.dev/)
