Preset for the Microsoft Teams feature can be defined for chats and channel conversations. Learn more about the configuration process below.
Configure a Preset for Teams chats
Click through this short demo to configure a Preset for Teams chats.
Configure a Preset for Teams Channel conversations
Click through this short demo to configure a Preset for Teams channel conversations.
Preset blueprints
You can create presets from scratch (first two options) or from a preconfigured blueprint (see options below under “recommendations”). Blueprints are available for specific use cases, such as incident chat or internal chat.
Teams chat/channel Preset blueprints provide pre-filled configuration options for:
-
Participants (Jira or static field)
-
Access options (sharing)
-
Chat notifications
-
Built-in automations
You can adjust or accept these options.
When creating a Preset, you can choose between a JSM or Jira project. Configuration options differ based on the Preset type.
Preset settings: Teams chat
Preset framework
This setting applies for chats & channels.
Framework settings
not editable by the user
When selecting a Preset option, decide on a name & icon, a tag and add a short description.
|
Preset icon & name |
Choose a specific name and icon so that users understand the usage of the Preset. |
|
Preset tag |
Use tags e.g. “internal” / “external” / “sensitive” etc. to categorize the Preset for the user. |
|
Preset description |
Be as precise as possible to distinguish easier among your Presets. |
Chat settings
To access chat participants, you must log in with your Microsoft 365 account via this button on the bottom of the page. 
Set defaults
editable by the user
Decide on participants (Jira field or Microsoft user).
Add a template (or create a new one!) to predefine the message content.
Set access options.
The user can edit settings in Jira, if required.
|
Participants |
Static user: Search by email for a required persons.
|
|
Access |
Decide whether to share the content of the chat or to keep it private. |
|
Template |
Choose among defined chat/channel templates to define the message content when using the Preset in Jira. Creating a global Preset?
Creating a project specific Preset?
Want to create a new template?
|
Chat notifications
Only one app per Preset can be selected!
Notification settings
not editable by the user
Choose which app should post updates about the request or work item into the chat.
|
Smart Connect app
|
If the preset is for Jira spaces, only the Smart Connect app is available. The Teams portal app is hidden. Operating as a bot, our Smart Connect app will post updates (as selected) into the corresponding chat/channel. 
|
|
Helpdesk
|
If the Preset is set up for JSM spaces, the admin can choose between the Smart Connect app or Teams portal app. Teams portal bot (referred to as “Helpdesk” below):
Smart Connect bot:
Learn more about notifications in JSM projects here. 
|
Built-in automations
Choose from built-in automations that integrate Microsoft 365 features with Jira and make workflows more efficient in Jira and/or JSM projects. No manual setup is required. These settings are active throughout the chat's lifecycle and are not running into Atlassian’s automation run limits.
Built-in automations
not editable by the user
Define built-in automations for the Preset to make workflows even smarter.
|
Jira SERVICE MANAGEMENT |
|
|
Chat created
|
Whenever a Teams chat is created, a comment will be added to the request (and involved persons will be notified via email). |
|
Chat created
|
The user will automatically be assigned to the request, if they start a chat (provided that the user has permissions to assign themselves). |
|
Chat created
|
As soon as a chat is started from Jira related to the request, a MS Teams call will automatically be initiated with all involved people. This can be helpful when requests need to be solved quickly. |
|
Request resolved
|
Generate a backup of the Microsoft Teams chat linked to this Preset and attach it as a PDF file in the Jira issue. Prompt a summary as a comment when the following toggle is enabled and choose the language: 
|
|
Request resolved
|
Hide the chat connected to this Preset in Microsoft Teams. Reporter, customer users and request participants will still be able to see the chat. |
|
Request resolved
|
Reporter and request participants will be removed from the Microsoft Teams chat, once the issue is resolved. This is useful in a JSM context, so customers won’t use the existing communications for new topics. However, they will not be able to complete the CSAT survey. |
|
Scheduled
|
*coming soon* |
|
project specific
and Chat message received (after resolution)
|
When a chat linked to a JSM request is created, the rule triggers a predefined workflow transition on that request. Choose which transitions to use when the chat starts. You can:
Please note:
|
|
Jira SOFTWARE |
|
|
Chat created
|
Whenever a Teams chat is created, a Jira comment will be added to the work item (and involved persons will be notified via email). |
|
Chat created
|
The user will automatically be assigned to the work item, if they start a chat (provided that the user has permissions to assign themselves). |
|
Chat created
|
As soon as a chat is started from Jira related to the work item, a MS Teams call will automatically be initiated with all involved people. This can be helpful when requests need to be solved quickly. |
|
Work item resolved
|
Generate a backup of the Microsoft Teams chat linked to this Preset and attach it as a PDF file in the Jira issue. Prompt a summary as a comment when the following toggle is enabled and choose the language: 
|
|
Work item resolved
|
Hide the chat connected to this Preset in Microsoft Teams. Reporter, customer users and work item participants will still be able to see the chat. |
|
Scheduled
|
*coming soon* |
|
project specific
|
When a chat linked to a Jira work item is created, the rule triggers a predefined workflow transition on that request. Choose which transitions to use when the chat starts. You can:
Please note:
|
Built-in automation: Transition request/work item
The following explanation is based on the Teams preset.
-
Select one or more transitions from specific workflows and have them also listed in the shared across workflows tab, if the selected ones also exist in other workflows.
-
Start by selecting transitions which are shared across workflows. Switch to the tab for specific workflows to see all workflows containing the selected transition. Delete or keep transitions, if desired.
Please note:
Whenever there is an “any status”-transition selected, no other transition can be selected in this workflow.
If you want to set up more advanced Jira automation rules with Microsoft 365, click here.
Preset settings: Teams channel
Teams app
Set defaults
not editable by the user
Choose between Smart Connect and your portal app.
Depending on which Teams app you select, respective channels will be available for the channel post settings.
Channel post settings
To access Microsoft Teams channels, you must log in with your Microsoft 365 account via this button on the bottom of the page.
Set defaults
editable by the user
Decide the channel to share the work item or request in.
Set access options.
Define the content options concerning message priority, notification layout (via adaptive card) and message content (template).
The user can edit settings in Jira, if required.
|
Channel |
Select the default Microsoft Teams channel where new conversations will be posted. |
|
Access |
Decide whether to share the content of the chat or to keep it private. |
|
Content |
Prioritize key content for your team and determine how its displayed. Show card first: For incidents e.g. it is highly important to retrieve key Jira information first as it contains essential facts for the support team to resolve the incident. The text provides context. Show text first: With development projects e.g., providing the team with content/information (text) can be more important than supplying brief (Jira) information . The card provides context here. Adaptive card: Choose the main layout for the card (how Jira information should appear in Teams). Template: See explanations for “Chats” above. Choose from existing templates or create a new one. |
Channel notifications
Only one app per Preset can be selected!
Notification settings
not editable by the user
Choose which app should post updates about the request or work item into the channel.
|
Smart Connect app
|
If the preset is for Jira spaces, only the Smart Connect app is available. The Teams portal app is hidden. Operating as a bot, our Smart Connect app will post updates (as selected) into the corresponding channel. 
|
|
Helpdesk
|
If the Preset is set up for JSM spaces, the admin can choose between the Smart Connect app or Teams portal app. Teams portal bot (referred to as “Helpdesk” below):
Smart Connect bot:
Learn more about notifications in JSM projects here.
|
Built-in automations
Choose from built-in automations that integrate Microsoft 365 features with Jira and make workflows more efficient in Jira and/or JSM projects. No manual setup is required. These settings are active throughout the chat's lifecycle and are not running into Atlassian’s automation run limits.
Built-in automations
not editable by the user
Define built-in automations for the Preset to make workflows even smarter.
|
Jira SERVICE MANAGEMENT |
|
|
Post created
|
Whenever a Teams channel post is created, a comment will be added to the request (and involved persons will be notified via email). |
|
Post created
|
The user will automatically be assigned to the request, if they start a chat (provided that the user has permissions to assign themselves). |
|
Request resolved
|
Generate a backup of the Microsoft Teams channel conversation linked to this Preset and attach it as a PDF file in the request. Prompt a summary as a comment when the following toggle is enabled and choose the language: 
|
|
project specific
|
When a chat linked to a JSM request is created, the rule triggers a predefined workflow transition on that request. Choose which transitions to use when the chat starts. You can:
Please note:
|
|
Jira SOFTWARE |
|
|
Post created
|
Whenever a Teams channel post is created, a comment will be added to the work item (and involved persons will be notified via email). |
|
Post created
|
The user will automatically be assigned to the request, if they start a chat (provided that the user has permissions to assign themselves). |
|
Work item resolved
|
Generate a backup of the Microsoft Teams channel conversation linked to this Preset and attach it as a PDF file in the request. Prompt a summary as a comment when the following toggle is enabled and choose the language:
|
|
project specific
|
When a chat linked to a JSM request is created, the rule triggers a predefined workflow transition on that request. Choose which transitions to use when the chat starts. You can:
Please note:
|
Built-in automation: Transition request/work item
The following explanation is based on the Teams preset.
-
Select one or more transitions from specific workflows and have them also listed in the shared across workflows tab, if the selected ones also exist in other workflows.
-
Start by selecting transitions which are shared across workflows. Switch to the tab for specific workflows to see all workflows containing the selected transition. Delete or keep transitions, if desired.
Please note:
Whenever there is an “any status”-transition selected, no other transition can be selected in this workflow.
If you want to set up more advanced Jira automation rules with Microsoft 365, click here.
Finish set-up
This setting applies for chats & channels.
Create Preset
not editable by the user
When finishing the set-up of the Teams Preset, you can decide between different activation options.
|
Create only |
Create the Preset and it will be available in the admin / project settings in Jira. It needs to be manually activated via the settings. |
|
Create + activate globally |
Create and activate the Preset and it is automatically active in all Jira projects with no project-specific settings. 📌 Please note: If there are project specific settings, the project admin still needs to activate the Preset manually via the project settings. |
|
Create + force activation |
Create and activate the Preset and it is automatically active in all Jira projects regardless of project-specific settings. 📌 Please note: Project specific settings will be overridden and the Preset will automatically be available and selectable in the Jira issue. |