mirror of
https://github.com/home-assistant/home-assistant.io.git
synced 2025-07-17 14:26:51 +00:00
New platform Microsoft Teams (#10911)
* Created documentation for the new Microsoft Teams platform * Added service data * Changed from webook_url to url * Added missing logo and changed some things after code review
This commit is contained in:
parent
eca6eea498
commit
130c2a2eb8
54
source/_integrations/msteams.markdown
Normal file
54
source/_integrations/msteams.markdown
Normal file
@ -0,0 +1,54 @@
|
|||||||
|
---
|
||||||
|
title: "Microsoft Teams"
|
||||||
|
description: "Instructions on how to send a notification to a Microsoft Teams channel."
|
||||||
|
logo: msteams.jpg
|
||||||
|
ha_category:
|
||||||
|
- Notifications
|
||||||
|
ha_release: 0.101
|
||||||
|
---
|
||||||
|
|
||||||
|
The `Microsoft Teams` platform allows you to send notifications from Home Assistant to a team channel in [Microsoft Teams](https://products.office.com/en-us/microsoft-teams/group-chat-software).
|
||||||
|
|
||||||
|
## Setup
|
||||||
|
|
||||||
|
To send a notification to teams, you need to add the Incoming Webhook app to your team channel. When the app is added, you will receive a webhook URL that needs to be added to your `configuration.yaml`.
|
||||||
|
|
||||||
|
|
||||||
|
## Configuration
|
||||||
|
|
||||||
|
To add the Microsoft Teams platform to your installation, add the following to your `configuration.yaml` file:
|
||||||
|
|
||||||
|
```yaml
|
||||||
|
notify:
|
||||||
|
- platform: msteams
|
||||||
|
url: https://outlook.office.com/webhook/<ID>
|
||||||
|
```
|
||||||
|
|
||||||
|
{% configuration %}
|
||||||
|
name:
|
||||||
|
description: Setting this parameter allows multiple notifiers to be created. The notifier will bind to the service `notify.NOTIFIER_NAME`.
|
||||||
|
required: false
|
||||||
|
type: string
|
||||||
|
default: "notify"
|
||||||
|
url:
|
||||||
|
description: The webhook URL created in the setup step.
|
||||||
|
required: true
|
||||||
|
type: string
|
||||||
|
{% endconfiguration %}
|
||||||
|
|
||||||
|
### Microsoft Teams service data
|
||||||
|
|
||||||
|
The following attributes can be placed inside `data` for extended functionality.
|
||||||
|
|
||||||
|
| Service data attribute | Optional | Description |
|
||||||
|
| ---------------------- | -------- | ----------- |
|
||||||
|
| `image_url` | yes | Attach an image to the message.
|
||||||
|
|
||||||
|
Example for posting file from URL:
|
||||||
|
|
||||||
|
```yaml
|
||||||
|
title: Title of the message.
|
||||||
|
message: Message that will be added.
|
||||||
|
data:
|
||||||
|
image_url: URL_OF_IMAGE
|
||||||
|
```
|
BIN
source/images/supported_brands/msteams.jpg
Normal file
BIN
source/images/supported_brands/msteams.jpg
Normal file
Binary file not shown.
After Width: | Height: | Size: 29 KiB |
Loading…
x
Reference in New Issue
Block a user