130c2a2eb8
* 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
1.6 KiB
title, description, logo, ha_category, ha_release
| title | description | logo | ha_category | ha_release | |
|---|---|---|---|---|---|
| Microsoft Teams | Instructions on how to send a notification to a Microsoft Teams channel. | msteams.jpg |
|
0.101 |
The Microsoft Teams platform allows you to send notifications from Home Assistant to a team channel in Microsoft Teams.
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:
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:
title: Title of the message.
message: Message that will be added.
data:
image_url: URL_OF_IMAGE