Skip to main content
Skip table of contents

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.

Features in Jira_Start a chat in Jira_shared chat access.jpg

Sharing options

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

Find out more

Features in Jira_Start a chat in Jira_JSM chat notifications.jpg

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

Features in Jira_Start a chat in Jira_Jira Software chat notifications.jpg

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

Features in Jira_Start a chat in Jira_Add participants to chat.jpg

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.

Features in Jira_Start a chat in Jira_Dropdown chats.jpg

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

Features in Jira_Start a chat in Jira_Templates.jpg

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

Features in Jira_Start a chat in Jira_shared chat access.jpg

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.

Permissions

🔐 Private

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

👫 Shared

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

Features in Jira_Start a chat in Jira_Jira Software chat notifications.jpg

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.

Settings

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

Features in Jira_Start a chat in Jira_JSM chat notifications.jpg

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.

Please note: This feature is available in JSM cloud projects and only after completing the Enable notifications” processof the Teams customer portal app.

Settings

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

Good to know: They are available for both chats with internal and external customers/users.

Please refer to Customer Portal app I Enable chat notifications to learn about this process and constraints.

Personal notifications

Please note: Jira Service Management projects only!

Microsoft Teams app_JSM project settings_Personal notifications.jpg

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.

Requirement: The customer portal app needs to be installed.

Microsoft Teams app_JSM project settings_Personal notifications_Activity tab Teams.jpg

Recommendations

  • 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

Features in Jira_Start a chat in Jira_Compact view_setting.jpg

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.

Features in Jira_Start a chat in Jira_Compact view_off.jpg

Compact view: off

Features in Jira_Start a chat in Jira_Compact view_on.jpg

Compact view: on

Setting

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

Features in Jira_Start a chat in Jira_Compact view_setting.jpg

Individual setting

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

Features in Jira_Start a chat in Jira_Compact view_setting_default.jpg

Default setting

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

Add chat messages as Jira comments

This function makes sense, if there are people involved in the issue, but not in the respective chat, to keep them up to date on specific information.

Features in Jira_Start a chat in Jira_Add chats as Jira comments.jpg

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

Features in Jira_Start a chat in Jira_External users.jpg

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.

Please note: We’re not able to check in advance, if a chat with the user will be possible.
There are a few requirements for this to work (see below).

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

Please note: Chatting with guest users is currently not supported, due to limitations on the Microsoft Teams side.

Workaround

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.

Please note: Even when you are using our workaround the Microsoft Graph API (the API used to create chats) is notoriously known for not handling guest / external users correctly sometimes.

References

https://docs.microsoft.com/en-us/microsoftteams/communicate-with-users-from-other-organizations

https://docs.microsoft.com/en-us/microsoftteams/manage-external-access

https://docs.microsoft.com/en-us/microsoftteams/guest-access

Backup & summarize chats using AI

Features in Jira_Start a chat in Jira_Backup chats.jpg

You can create 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 or an AI summary 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.

To enable the AI powered summarization feature, please activate AI features via General settings.

Good to know: Check out our Microsoft 365 automation to backup MS Teams chat automatically if there is a specific condition met in Jira. 🚀

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:

Starting a simple chat from Jira does not require the installation of the Microsoft Teams app.

Jira & Microsoft deployment

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

  • Microsoft 365 & MS Exchange

JavaScript errors detected

Please note, these errors can depend on your browser setup.

If this problem persists, please contact our support.