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:
Per-Øyvind Bruun 2019-10-23 11:14:11 +02:00 committed by Fabian Affolter
parent eca6eea498
commit 130c2a2eb8
2 changed files with 54 additions and 0 deletions

View 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
```

Binary file not shown.

After

Width:  |  Height:  |  Size: 29 KiB