• Products
  • Get started
  • Documentation
  • Resources

Set up chat in Slack

Chat allows you to connect your service project with Slack so you can turn messages into issues and work on them, all without leaving Slack. Learn more about chat.

You must be a project admin to set up chat.

Set up chat in your service project

A Jira site can only connect to one Slack workspace.

To set up chat in your service project:

  1. From your service project sidebar, select Channels, then Chat, then Configure.

  2. Select Add to Slack.

  3. Select the Slack workspace you want to connect your Jira site to then select Allow. If another service project on your Jira site is connected to Slack, you can’t select another workspace.

  4. Select the request types you want to use in Slack, then select Add. You can add more later.

  5. The last step creates a private agent channel for your team. Assist suggests a name based off your project key, but you can rename it if you want. Select Create to finish setup.

    1. Learn how to use an existing channel instead.

Some request type fields aren’t supported and won’t show on the request form. If you have an unsupported required field in a request type, you can’t use it in chat. If you want to use the request type without the unsupported field, make sure it’s not required.

Set up your channels in Slack

Agent channel

An agent channel is a private channel within your Slack workspace where agents can assign, edit, and respond to requests.

Assist creates an agent channel for you during the initial onboarding steps, or you can also use a channel you already have:

  1. In Slack, find the private channel or create a new one.

  2. Add Assist to the channel:

    1. Type /add as a message in the channel.

    2. Select Add apps to this channel.

    3. Search for Assist.

    4. Select Add.

  3. Select the service project you’d like to connect to the agent channel.

  4. Go back to the chat onboarding steps and refresh the page to view your settings.

Request channels

A request channel is where people can ask your team for help.

Like agent channel setup, you can either have Assist create a request channel for you or use an existing one.

Create request channel with Assist

  1. From your chat settings, under the Channels heading, select Create request channel.

  2. Assist suggests a name based off your project key, but you can rename it if you want.

  3. Select Create.

Use an existing channel for requests

To set up a request channel:

  1. In Slack, find the channel or create a new one.

  2. Add Assist to the channel:

    1. Type /add as a message in the channel.

    2. Select Add apps to this channel.

    3. Search for Assist.

    4. Select Add.

  3. When prompted, select that you want to use the channel as a Request channel.

  4. Select the correct service project from the list.

Additional Help