Document toolboxDocument toolbox

Microsoft Teams: Start a chat in Jira

Start a Microsoft Teams conversation right in your Jira issue. Select a Microsoft Teams channel or start a chat. The issue will be linked with the conversation in Microsoft Teams.

Facts & Benefits

  • Benefit: Quickly reach out out to customers (internal/external) via MS Teams chats

  • Messages from Jira or from MS Teams appear instantly in either tool (real-time communication)

  • Add even more people to an existing chat, if required

  • Benefit: Define sharing options for each chat (private, shared, shared & allow joining)

  • Benefit: Customers / team members not having access to Jira (no active Jira license), can still join the conversation in MS Teams

  • Choose between different chats and conversations in the issue and keep information documented where you need it (Meetings chats, 1:1, channel conversations)

  • Benefit: Use our chat (bot) notifications to be updated on any issue changes in MS Teams (for Jira Software and Jira Service Management)

Start a chat in Jira

Nice to know: Customers / team members not having access to Jira, can still join the conversation in MS Teams (because all information / conversation is accessible in both tools!)

Depending on how the feature appearance is configured and if you are using the new or old issue view, you can start this action a bit differently.

We assume you are using the default settings with the new Jira issue view.

Features in Jira_Start a chat in Jira.jpg

Start a chat in issue

Select the Teams icon in your Jira issue, click on it and select “chat” in the dropdown menu.

Add chat participants and enter your message.

JSM only: a label tells you, if the chat is customer facing or internal.

Sharing options

Before sending the message to a (group) chat, you can decide on chat sharing options.

Find out more

Chat notifications (JSM)

In addition, you can decide if updates on the issue should be posted into the respective MS Teams chat, as well.

For JSM projects it is the customer portal (acting like a bot).

Learn more

Chat notifications
(Jira Software/Business)

Sure, in Jira Software/Business projects you can do the same.

Decide if our Smart Connect app (acting like a bot here) should post issue updates into the MS Teams chat, too.

Learn more

Add participants to chat

You forgot to add your colleague to the chat in the first place? No problem.

Select the chat, click on the persons icon and add more participants to the chat.

Access (all) chats in Jira issue

Even with multiple chats, channel conversations and meeting notes to an issue, you have all information structed.

Choose among the drop down function which information you want to retrieve.

Chat templates

When starting a chat from your Jira issue, you can choose among preconfigured templates.

This makes it easy for e.g. agents to react on tickets even quicker via preset responses.

Find out more about our templates options - for chats, emails and meetings.

Shared chat access

When you share a chat within a Jira issue, you can give (read-only) access to other Jira users, that have access to this issue, e.g. other agents in a JSM project. Even though they are not a participant of the chat, they’ll still be able to view the chat content. This works by using our existing share-functionality, which allows you to give other Jira users very narrow access, to access the chat info on your behalf.



This respects all Teams default permissions, e.g. only members of the chat can access chat contents.


This gives read-only access to all Jira users or JSM agents that have access to this issue, and are logged in with Microsoft Teams.

Shared & allow joining

This gives read-only access to all Jira users or JSM agents that have access to this issue, and are logged in with Microsoft Teams. In addition, if a user wants to participate in the chat, they can simply join the chat on their own.

Chat notifications

With chat notifications enabled, our app will post issue updates into the MS Teams chat.

Those notifications are available for Jira Service Management and Jira Software/Business.

However, there are some technical differences about this feature and its settings. Learn more below.

Jira Software/business

With Jira Software/business projects, you can allow (chat) notifications every time you start a new MS Teams chat from the issue (see screenshot).

Technically, it is our Smart Connect for Jira app which acts like a bot here and thus posts issue updates in the respective MS Teams chat.


The configuration of the chat notifications for Jira Software/Business projects is done in our global Jira admin settings.

You can select notifications in Teams from issue changes and issue field changes.

Good to know: These settings apply to chats and channel conversations. Learn more.

Jira Service Management

With Jira Service Management projects, you can allow (chat) bot notifications every time you start a new MS Teams chat from the issue (see screenshot) - even incl. CSAT collection.

Technically, it is our customer portal app which acts like a bot here (e.g. IT Support portal) and thus, posts updates to the issue in the respective MS Teams chat.


With JSM projects, you can not define the notification settings as individually as you can do with Jira Software projects (see above).

Chat notifications in JSM projects comprise:

  • Customer facing status changes

  • Jira comments

  • Approvals

  • Resolutions

Personal notifications

You can enable personal notifications in JSM projects via the project settings.

This will send customer facing status updates, approvals, comments and resolutions to the reporter of the issue and to request participants into the activity tab in MS Teams as read-only chat messages.

Those messages are sent (just like the chat notifications for JSM projects) from the customer portal app (acting as a bot) from your e.g. IT Support portal.


  • Use personal notifications in projects where communication with customers is done via comments.

  • Use chat notifications in projects where communicating via issue-related MS Teams chats.

Compact view of chats

Just like you’re possibly using it in Microsoft Teams, we offer a compact view of your chats and channel conversations in your Jira issue. For some people this view option might help to display information a bit clearer and more compact.


You have two options to activate the compact view of MS Teams chats in your issue.

Individual setting

Use this toggle right next to your chat window (see below).

Default setting

Go to your Microsoft 365 settings in Jira and set a default for all chats created:

Add chat messages as Jira comments

One of your MS Teams chat messages contains relevant content or important information which needs to be shared with the whole team? Then make this chat message a Jira comment and keep your team updated.

Choose the respective message > click on the “..:" dots > and select the speech bubble to the bottom.

Chat with external/guest users

In Microsoft Teams, you can chat and collaborate with users of other organizations in two different ways.
You can read more about the differences here: Collaborate with people outside your organization.

External users

Creating a chat with external users (Business Accounts on Office 365) works the same way as with internal users. Just enter the email address of the external contact when creating a chat.

Check if an external user is available trough Teams chat

There are a few requirements for an external chat to work:

  • The external contact needs to have a Microsoft Teams account for their email address

  • The organization of the external contact needs to allow chats with your organization

  • Your organization needs to allow chats with the external organization

To check if this is possible:

  1. Open a new chat in Microsoft Teams and enter the email address of the contact.

  1. After clicking “Search […] externally” it will show you one of two messages:

  1. This error indicates that the user has no Teams account for this email address at all.


  1. This error indicates that your or the external users organization has restricted external chats. See below for help on this.

Guest users


You can work around this limitation by creating the chat first and then adding the guest user afterwards in Microsoft Teams.

It’s a known bug on Microsoft side and we hope to be able to support this soon.


Backup chats

You can make a backup of selected chats and channel discussions (a static PDF file will be added to the Jira issue, e. g. for audit purposes) and keywords of the discussion will be added as internal comment.

Even if the chat or conversation has been deleted in Microsoft Teams, the static PDF file will still be documented in your Jira issue.

Appearance settings

Basically we offer 3 different view settings:

  • Issue content view

  • Quick create area

  • Activity tab

Feature requirements

In order to start a MS Teams chat in Jira, the following set-up and configuration needs to done:

Jira & Microsoft deployment

  • Jira Cloud, Jira Server & Data Center (Server needs to be publicly available)

  • Microsoft 365 & MS Exchange