Skip to end of metadata
Go to start of metadata

You are viewing an old version of this page. View the current version.

Compare with Current View Page History

« Previous Version 2 Next »

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 to leverage Teams Workflows to send messages.

Adding a Workflow in Teams to receive a webhook message

  1. You will need to add a Workflow in Teams by clicking the three dot menu and selecting the Workflows application.

image-20241204-202544.png

  1. Once viewing the Workflows page, click the ➕ New Flow button on the top right.

image-20241204-202750.png

  1. You can optionally select a template but for this walkthrough just click the ➕ Create from blank button.

image-20241204-203050.png

  1. The first step should be When a Teams webhook request is received

image-20241204-203146.png

  1. Select Anyone for “Who can trigger the flow?” and click on the ➕ New Step button.

image-20241204-203335.png

  1. The second and final step should be Post card in a chat or channel.

image-20241204-203506.png

  1. 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.

image-20241204-204317.png

  1. Save your Workflow and re-open the first step so you can copy the webhook URL.

image-20241204-204713.png

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:

image-20241204-205527.png

More Advanced Messages

Note that you can also pass a json string to the MICROSOFTTEAMS.sendTeamsWebhookMessage function which allows you to send more advanced messages. The json string just needs to conform to Teams Adaptive Card Schema.

Microsoft also provides a playground where you can design your own messages in realtime.

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.

  • No labels