Integrate an Automation rule with Microsoft Teams
Platform Notice: Data Center Only - This article only applies to Atlassian products on the Data Center platform.
Note that this KB was created for the Data Center version of the product. Data Center KBs for non-Data-Center-specific features may also work for Server versions of the product, however they have not been tested. Support for Server* products ended on February 15th 2024. If you are running a Server product, you can visit the Atlassian Server end of support announcement to review your migration options.
*Except Fisheye and Crucible
Summary
If you want to send a message to a Microsoft Teams channel, you first need to integrate Microsoft Teams and Automation for Jira Server. This provides a webhook URL that Automation for Jira uses to send messages to your Microsoft Teams channels. This integration can be revoked at any time.
Solution
Setting up a Microsoft Teams integration can be done in a few simple steps:
Navigate to Microsoft Teams, choose More options (...) next to the channel name, then choose Connectors
Scroll through the list of Connectors to Incoming Webhook, and choose Add
Enter Automation for Jira as the name for the webhook, upload an image to associate with data from the webhook (you can download and use Curly), and choose Create
Copy the webhook URL to the clipboard and choose Done
The next steps will depend on the Automation For Jira version that you are using
For Automation For Jira on any version below 9.0.0
Go to your Automation rule and the Send Microsoft Teams Notification action
Paste the webhook URL from step 4 into the Webhook URL field
For Automation For Jira on any version from 9.0.0
Create a new Secret Key by following the instructions from this documentation and using the Webhook URL obtained from the Microsoft Teams interface
Go to your Automation rule and the Send Microsoft Teams Notification action
Click on the Webhook URL dropdown menu and select the secret key created earlier
All done! You are now integrated with your Microsoft Teams Channel.
Markdown support
Microsoft Team messages support basic markdown for rich formatting. The only limitations are you can't insert:
Images
Inline HTML
HTML Blocks
Custom nodes
Tip
If you're using characters such as # or * and you want them to appear as characters in your message content, you need to escape them else they'll be performing a markdown function. You can do this surrounding them with backslashes e.g. \#\
Example
Send a message to a Microsoft Teams channel when a bug is raised:
The message body is using smart values formatted with markdown language:
When this rule is triggered, a message in Microsoft Teams looks like this:
Done! You should now be able to be able to send messages with Microsoft Teams.
Was this helpful?