Configuring FlexDeploy for Teams Webhook Operations

Microsoft 365 Connector RetirementWith 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.

FlexDeploy 10.0 Documentation

​Adding a Workflow in Teams to receive a webhook message

​Using the Webhook URL from the Teams Workflow

​Posting Messages with MICROSOFTTEAMS helper

​Authoring Adaptive Cards

​Setting up Certificates

Adding a Workflow in Teams to receive a webhook message

Using the Webhook URL from the Teams Workflow

Posting Messages with MICROSOFTTEAMS helper

Authoring Adaptive Cards

Setting up Certificates