containrrr / shoutrrr

Notification library for gophers and their furry friends.
https://containrrr.dev/shoutrrr/
MIT License
961 stars 60 forks source link

Teams: Message format about to change #446

Open Selaron opened 1 month ago

Selaron commented 1 month ago

Teams is adding a warning to all notifications submitted via webhook:

Action Required: O365 connectors within Teams will be deprecated and notifications from this service will stop. Learn more about the timing and how the Workflows app provides a more flexible and secure experience. If you want to continue receiving these types of messages, you can use a workflow to post messages from a webhook request.

There's additional documentation on how to submit notifications to Teams: https://learn.microsoft.com/en-us/microsoftteams/platform/webhooks-and-connectors/how-to/connectors-using?tabs=cURL%2Ctext1

Viajaz commented 1 month ago

https://devblogs.microsoft.com/microsoft365dev/retirement-of-office-365-connectors-within-microsoft-teams/

Starting August 15th, 2024 we will be retiring the Office 365 connectors feature from Microsoft Teams. We recommend Power Automate workflows as the solution to relay information into and out of Teams in a scalable, flexible, and secure way. We will gradually roll out this change in waves:

  • Wave 1 – effective August 15th, 2024: All new Connector creation will be blocked within all clouds
  • Wave 2 – effective October 1st, 2024: All connectors within all clouds will stop working

It should be noted they are already adding warnings to the bottom of every message card posted on Microsoft Teams webhooks:

Action Required: O365 connectors within Teams will be deprecated and notifications from this service will stop. Learn more about the timing and how the Workflows app provides a more flexible and secure experience. If you want to continue receiving these types of messages, you can use a workflow to post messages from a webhook request. Set up workflow.

Use of Microsoft Teams webhooks, example: teams://deadbeef-dead-beef-dead-deadbeefdeadbeefdeadb-dead-beef-dead-deadbeefdead/deadbeefdeadbeefdeadbeefdeadbeef/deadbeef-dead-beef-dead-beefdeadbeef?host=example.webhook.office.com will cease working.

The Flow webooks can accept the same MessageCard/AdaptiveCard format as the Microsoft Teams webhook when using the appropriate Post to a channel when a webhook request is received Flow Template.

An example Flow Webhook from the Post to a channel when a webhook request is received Flow Template: https://prod-03.australiasoutheast.logic.azure.com:443/workflows/ffffffffffffffffffffffffffffffff/triggers/manual/paths/invoke?api-version=2016-06-01&sp=%2Ftriggers%2Fmanual%2Frun&sv=1.0&sig=ABCdefGHIjklMNOpqrST-UvwxYZabcdefghijklmnop

Perhaps a new service (teams2:// or flow://) that just accepts a Flow webhook (Eg: teams2://prod-03.australiasoutheast.logic.azure.com:443/workflows/ffffffffffffffffffffffffffffffff/triggers/manual/paths/invoke?api-version=2016-06-01&sp=%2Ftriggers%2Fmanual%2Frun&sv=1.0&sig=ABCdefGHIjklMNOpqrST-UvwxYZabcdefghijklmnop). Presumably it could be based on teams.go and teams_config.go and made to work more like generic.go and generic_config.go but still retain the MessageCard JSON payload.