Skip to content

Commit a0e6b4d

Browse files
author
Carlos Savcic
committed
docs(teams): clarify webhook URL format and required components
- Updated the documentation to emphasize the new Teams webhook URL format, including the organization domain. - Enhanced the explanation of the URL structure and its components for better clarity. - Changed the formatting of notes and examples for improved readability.
1 parent 1c57bb0 commit a0e6b4d

File tree

1 file changed

+20
-11
lines changed

1 file changed

+20
-11
lines changed

docs/services/teams.md

Lines changed: 20 additions & 11 deletions
Original file line numberDiff line numberDiff line change
@@ -1,6 +1,6 @@
11
# Teams
22

3-
!!! attention New webhook URL format only
3+
!!! attention "New webhook URL format only"
44
Shoutrrr now only supports the new Teams webhook URL format with organization domain.
55
You must specify your organization domain using:
66
```text
@@ -12,8 +12,17 @@
1212

1313
## URL Format
1414

15-
!!! info ""
16-
teams://__`group`__@__`tenant`__/__`altId`__/__`groupOwner`__/__`extraId`__?host=__`organization`__.webhook.office.com
15+
```
16+
teams://group@tenant/altId/groupOwner/extraId?host=organization.webhook.office.com
17+
```
18+
19+
Where:
20+
- `group`: The first UUID component from the webhook URL
21+
- `tenant`: The second UUID component from the webhook URL
22+
- `altId`: The third component (hex string) from the webhook URL
23+
- `groupOwner`: The fourth UUID component from the webhook URL
24+
- `extraId`: The fifth component at the end of the webhook URL
25+
- `organization`: Your organization name for the webhook domain
1726

1827
--8<-- "docs/services/teams/config.md"
1928

@@ -28,15 +37,15 @@ The token is extracted from your webhook URL:
2837

2938
<pre><code>https://<b>&lt;organization&gt;</b>.webhook.office.com/webhookb2/<b>&lt;group&gt;</b>@<b>&lt;tenant&gt;</b>/IncomingWebhook/<b>&lt;altId&gt;</b>/<b>&lt;groupOwner&gt;</b>/<b>&lt;extraId&gt;</b></code></pre>
3039

31-
!!! info "Webhook Format Details"
32-
The webhook URL format includes:
40+
!!! note "Important components"
41+
All parts of the webhook URL are required:
3342

34-
- `organization`: Your organization name (required)
35-
- `group`: The first UUID component (required)
36-
- `tenant`: The second UUID component (required)
37-
- `altId`: The third component (hex string) (required)
38-
- `groupOwner`: The fourth UUID component (required)
39-
- `extraId`: The additional component at the end (required)
43+
- `organization`: Your organization name
44+
- `group`: The first UUID component
45+
- `tenant`: The second UUID component
46+
- `altId`: The third component (hex string)
47+
- `groupOwner`: The fourth UUID component
48+
- `extraId`: The additional component at the end
4049

4150
## Example
4251

0 commit comments

Comments
 (0)