Jira cannot create agent channel when setting up JSM Chat/Assist
Platform Notice: Cloud Only - This article only applies to Atlassian products on the cloud platform.
Summary
When setting up Chat in your Jira Service Management project, you are blocked on the step where Jira tries to set up automatically the Agent channel for your project. The following error is shown:
We couldn’t create your channel. Refresh the page to try again.
Cause
This is caused by a restriction in the Slack workspace permissions, related to who can create channels in it, so Jira is unable to automatically set up the channel.
Solution
You will need to either:
- Manually set up the agent channel in Slack or
- Change the permissions on the Slack workspace to allow all users to create channels
Below are the details on how to achieve these solutions.
Manually set up the agent channel in Slack
In Slack, find a private channel or create a new one. If you don't have permission to create private channels in your workspace, ask your Slack workspace admin/owner to create a private channel for you.
Add Assist to the channel:
Type /add as a message in the channel.
Select Add apps to this channel.
Search for Assist.
Select Add.
When prompted to select the type of channel, select agent channel.
Select the service project you’d like to connect to the agent channel.
- Go back to Jira on your browser and refresh the tab.
- Proceed with your Chat set up.
Change the Slack workspace settings to allow all users to create channels
- As a Slack workspace Owner or Administrator, access [workspacename].slack.com/admin > Settings & Permissions > Permissions > Channel Management (https://[workspacename].slack.com/admin/settings#channel_management_restrictions)
- Under "People who can create private channels", change it to "Everyone, except guests". Save the update.
- Go back to the Jira tab in your browser and refresh it.
- Proceed with your Chat set up.