diff --git a/Notify_msteams.md b/Notify_msteams.md index 1978613..379080d 100644 --- a/Notify_msteams.md +++ b/Notify_msteams.md @@ -11,20 +11,31 @@ You will need to create an **Incoming Webhook** to attach Apprise. This can be When you've completed this, it will generate you a URL that looks like: ``` -https://outlook.office.com/webhook/ \ +https://team-name.office.com/webhook/ \ abcdefgf8-2f4b-4eca-8f61-225c83db1967@abcdefg2-5a99-4849-8efc-\ c9e78d28e57d/IncomingWebhook/291289f63a8abd3593e834af4d79f9fe/\ a2329f43-0ffb-46ab-948b-c9abdad9d643 ``` Yes... The URL is that big... but at the end of the day this effectively equates to: -```https://outlook.office.com/webhook/{tokenA}/IncomingWebhook/{tokenB}/{tokenC}``` +```https://{team}.office.com/webhook/{tokenA}/IncomingWebhook/{tokenB}/{tokenC}``` Hence: +The team name can be found in the generated webhook which looks like: ``` -https://outlook.office.com/webhook/ABCD@WXYZ/IncomingWebhook/DEFG/HIJK - ^ ^ ^ - | | | - These are important <----------------^----------------------^----^ +# https://TEAM-NAME.office.com/webhook/ABCD/IncomingWebhook/DEFG/HIJK +# ^ ^ ^ ^ +# | | | | +# These are important <----------------^--------------------^----^ +``` + +vs the legacy URL which looked like (always stating `outlook` as the team name): +``` +# https://outlook.office.com/webhook/ABCD/IncomingWebhook/DEFG/HIJK +# ^ ^ ^ ^ +# | | | | +# legacy team reference: 'outlook' | | | +# | | | +# These are important <--------------^--------------------^----^ ``` So as you can see, we have is 3 separate tokens. These are what you need to build your apprise URL with. In the above example the tokens are as follows: @@ -36,12 +47,16 @@ So as you can see, we have is 3 separate tokens. These are what you need to bui ### Syntax Valid syntax is as follows: -* `https://outlook.office.com/webhook/{tokenA}/IncomingWebhook/{tokenB}/{tokenC}` +* `https://team-name.office.com/webhook/{tokenA}/IncomingWebhook/{tokenB}/{tokenC}` +* `msteams://{team}/{tokenA}/{tokenB}/{tokenC}/` + +The Legacy format is also still supported. The below URL would automatically set the team name to `outlook` * `msteams://{tokenA}/{tokenB}/{tokenC}/` ### Parameter Breakdown | Variable | Required | Description | ----------- | -------- | ----------- +| team | Yes | Extracted from the *incoming-webhook*. | tokenA | Yes | The first part of 3 tokens provided to you after creating a *incoming-webhook* | tokenB | Yes | The second part of 3 tokens provided to you after creating a *incoming-webhook* | tokenC | Yes | The last part of 3 tokens provided to you after creating a *incoming-webhook* @@ -50,11 +65,12 @@ Valid syntax is as follows: #### Example Send a Microsoft Teams notification: ```bash +# Assuming our {team} is Apprise # Assuming our {tokenA} is T1JJ3T3L2@DEFK543 # Assuming our {tokenB} is A1BRTD4JD # Assuming our {tokenC} is TIiajkdnlazkcOXrIdevi7F apprise -vv -t "Test Message Title" -b "Test Message Body" \ - msteams:///T1JJ3T3L2@DEFK543/A1BRTD4JD/TIiajkdnlazkcOXrIdevi7F/ + msteams:///Apprise/T1JJ3T3L2@DEFK543/A1BRTD4JD/TIiajkdnlazkcOXrIdevi7F/ ``` ## Templating