• Get started
  • Documentation

Set up chat in Microsoft Teams

Set up chat in your service project

A Jira site can only connect to one Microsoft Teams tenant.

To set up chat in your service project:

  1. From your service project, select Project settings, then Channels & self service, then Chat .

  2. Select Add to Teams. This opens the Teams app store listing for Assist.

  3. Select Add to a team.

  4. Search for the private team you’d like to use as your agent team with Assist and select Set up bot.

  5. Once the installation process completes, go through the onboarding tour to finish setup.

    1. During the onboarding tour, you may need to grant the app permissions. If you’re unable to grant permissions, reach out to your Teams admin for assistance. Learn more about managing app permission policies in Teams

After you’ve added Assist to your tenant, go back to the chat setup page. You should see the option to sign in with Microsoft Teams. If not, select Install in Teams again, then:

  1. Select Sign in with Teams.

  2. Select the Microsoft Teams account linked to your tenant to sign in. You may need to enter your password to continue.

  3. Select the request types you want to use in Teams, then select Add.

Some request type fields are not supported and will not be shown on the request form. If you have a required field in a request type that isn’t supported by chat, the request type can’t be used.

If you want to use the request type without the unsupported field, just make sure it’s not a required field to avoid any errors.

Set up your agent team and channels in Teams

Agent team

An agent team is a private team where agents can assign, edit, and respond to requests. Only your agents should be members of these teams, as they impact your bill.

To set up an agent team:

  1. In Teams, create a new private team.

  2. Add Assist to the team:

    1. From the left sidebar, select Apps.

    2. Search for Assist.

    3. Select Add to a team and select your new private team. You may need to request permission from the admin to add the bot.

  3. Go to the Chat tab in the sidebar and check for a message from Assist.

  4. Select Agent channel and follow the prompts to finish setting up your agent team.

  5. Add agents to the team.

Request channels

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

To set up a request channel:

  1. In Teams, create a new public team or choose an existing one.

  2. Add Assist to the team:

    1. From the left sidebar, select Apps.

    2. Search for Assist.

    3. Select Add to a team and select the public team. You may need to request permission from the admin to add the bot.

  3. Go to the Chat tab in the sidebar and check for a message from Assist.

  4. Select Request channel and follow the prompts to finish setting up your request channel.

Still need help?

The Atlassian Community is here for you.