Configuring FlexDeploy for Teams Webhook Operations
- Karl Henselin
- Joel Wenzel
Microsoft 365 Connector Retirement
With the retirement of Office 365 connectors in Teams, the only supported approach of sending messages in Microsoft teams in through Microsoft Teams Workflows.
The following page will cover how to configure FlexDeploy @since 9.0.0.1 to leverage Teams Workflows to send messages.
Adding a Workflow in Teams to receive a webhook message
You will need to add a Workflow in Teams by clicking the three dot menu and selecting the Workflows application.
Once viewing the Workflows page, click the New Flow button on the top right.
You can optionally select a template but for this walkthrough just click the Create from blank button.
The first step should be When a Teams webhook request is received
Select Anyone for “Who can trigger the flow?” and click on the New Step button.
The second and final step should be Post card in a chat or channel.
Specify which Team, Channel, or Group Chat you want to post the message to. Finally select Body as the Adaptive Card content. Body represents the entire input payload that will be sent to the webhook.
If you do not see Body as an available option, then try saving your workflow, closing it, and re-editing it.
Save your Workflow and re-open the first step so you can copy the webhook URL.
Using the Webhook URL from the Teams Workflow
The Webhook URL copied from the Teams Workflow is what will be used when configuring Plugin Operations and using our MICROSOFTTEAMS groovy helper.
Posting Messages with MICROSOFTTEAMS helper
The following script creates and posts a message that leverages most of the card features supported by our MicrosoftTeamsMessageCard helper class.
import flexagon.ffi.microsoftteams.pojos.MicrosoftTeamsMessageCard;
LOG.info("Running function: ${FUNCTION_NAME}");
def teams_url= "YOUR_WEBHOOK_URL_COPIED_FROM_ABOVE"
MicrosoftTeamsMessageCard card = new MicrosoftTeamsMessageCard()
card.setTitle("Main Title")
card.setActivityTitle("Card Subtitle")
card.setIconUrl("https://png.pngtree.com/element_pic/00/16/09/2057e0eecf792fb.jpg")
card.setSectionText("This is the main body of the card. This is longer form content.")
card.addFact("Fact 1", "This is neat huh")
card.addFact("Fact 2", "I sure think so")
card.addAction("Action.OpenUrl", ["url":"https://google.com", "title":"Open Google"])
card.setTableHeaders(["Project", "Workflow", "Release"])
card.addTableRow(["Samples", "BuildGit", "Weekly Release"])
card.addTableRow(["Natours", "BuildGit", "Monthly Release"])
MICROSOFTTEAMS.sendTeamsWebhookMessage(teams_url, card)The final result looks like the following:
Authoring Adaptive Cards
Both the MICROSOFTTEAMS helper and Plugin Operations support passing a json string which allows the full Adaptive Card schema to be leveraged.
Microsoft provides a webpage to view the schema and a playground to create your own messages, which can be found below.
https://adaptivecards.io/explorer/AdaptiveCard.html
https://adaptivecards.io/designer/
Setting up Certificates
You may need to install the certificate for https://graph.microsoft.com/.default into your Java keystore. If this is the case, you will get an error about building a certificate path.
- style