Home Assistant

Microsoft Teams

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 Variables

Looking for your configuration file?
name string (Optional, default: notify)

Setting this parameter allows multiple notifiers to be created. The notifier will bind to the service notify.NOTIFIER_NAME.

url string Required

The webhook URL created in the setup step.

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.

The image must be an HTTPS URL, and as outlined by Microsoft in the Documentation, the picture must be on a publicly available location.

Example for posting file from URL:

title: Title of the message.
message: Message that will be added.
data:
  image_url: URL_OF_IMAGE