Debian Codegraph @

docs/services/chat/teams/index.md

raw
1 # Teams
2
3 !!! Attention "Office 365 Connector Retirement"
4 As noted in Microsoft's [update](https://devblogs.microsoft.com/microsoft365dev/retirement-of-office-365-connectors-within-microsoft-teams/),
5 Office 365 Connectors within Microsoft Teams have been retired.
6
7 The legacy `webhook.office.com` webhook URLs and MessageCard format are no longer functional.
8
9 Shoutrrr now uses Power Automate workflow incoming webhooks exclusively.
10 Existing configurations using the old URL format must be migrated to the new
11 `teams://?host=<workflow URL>` format documented below.
12
13 ## URL Format
14
15 ```text
16 teams://?host=<Power Automate workflow URL>[&color=<hex color>][&title=<title>]
17 ```
18
19 Where:
20
21 - `host`: The full Power Automate workflow incoming webhook URL (required).
22 - `color` *(optional)*: Title text color. Accepts Adaptive Card color names (`accent`, `good`, `warning`, `attention`, `dark`, `light`, `default`) or common color names (`red`, `green`, `blue`, `yellow`, `orange`).
23 - `title` *(optional)*: Title displayed as a bold header in the Adaptive Card.
24
25 --8<-- "docs/services/chat/teams/config.md"
26
27 ## Setting up a webhook
28
29 To use the Microsoft Teams notification service with Power Automate, create a new
30 workflow in Power Automate and add the "When a Teams webhook request is received"
31 trigger. Copy the generated webhook URL from the trigger.
32
33 For more information, see the
34 [Microsoft Learn documentation](https://learn.microsoft.com/en-us/connectors/teams/#microsoft-teams-webhook).
35
36 ## Example
37
38 Teams/Power Automate workflow webhook URL:
39
40 ```text
41 https://prod-00.westus.logic.azure.com:443/workflows/abc123/triggers/manual/paths/invoke?api-version=2016-06-00&sp=/triggers/manual/run&sv=1.0&sig=XXXXXXXX
42 ```
43
44 Shoutrrr URL:
45
46 ```text
47 teams://?host=https%3A%2F%2Fprod-00.westus.logic.azure.com%3A443%2Fworkflows%2Fabc123%2Ftriggers%2Fmanual%2Fpaths%2Finvoke%3Fapi-version%3D2016-06-00%26sp%3D%2Ftriggers%2Fmanual%2Frun%26sv%3D1.0%26sig%3DXXXXXXXX&title=Alert
48 ```
49
50 In this example:
51
52 - The `host` param is the full Power Automate workflow webhook URL (percent-encoded).
53 - `title=Alert` adds a bold title header to the Adaptive Card.