mirror of
https://github.com/home-assistant/developers.home-assistant.git
synced 2025-06-19 00:26:28 +00:00
5347a1b7e0
* Add notify entity platform * Add blog post * tweak * more tweaks * Also document non async method * Apply suggestions from code review Co-authored-by: Martin Hjelmare <marhje52@gmail.com> * Apply suggestions from code review Co-authored-by: Martin Hjelmare <marhje52@gmail.com> --------- Co-authored-by: Martin Hjelmare <marhje52@gmail.com>
33 lines
1.6 KiB
Markdown
33 lines
1.6 KiB
Markdown
---
|
|
author: Jan Bouwhuis
|
|
authorURL: https://github.com/jbouwh
|
|
authorImageURL: https://avatars.githubusercontent.com/u/7188918?s=96&v=4
|
|
title: New notify entity platform
|
|
---
|
|
|
|
### New notify entity platform
|
|
|
|
The notify platform is now available as an [entity platform](https://developers.home-assistant.io/docs/core/entity/notify/). The MVP for the new `notify` platform [implements](https://github.com/home-assistant/core/pull/110950) the method and service `send_message`. It accepts `message` as a required attribute.
|
|
Unlike the legacy `notify.notify` service we have no targets as argument, as it is an entity we can target multiple `notify` entities when calling `send_message`.
|
|
|
|
The [architecture discussion](https://github.com/home-assistant/architecture/discussions/1041) is ongoing, and is about the device classes to implement and the implementation of recipient support in the form of [contacts via a contact registry](https://github.com/home-assistant/architecture/discussions/1041#discussioncomment-8947842).
|
|
|
|
Existing integrations that implement the legacy `notify` services will be migrated in phases. The first step is to migrate the integrations than only use `message` as a parameter to notify.
|
|
|
|
The integrations identified for migration are:
|
|
|
|
- circuit
|
|
- clickatell
|
|
- clicksend
|
|
- command_line
|
|
- demo
|
|
- ecobee
|
|
- flock
|
|
- free_mobile
|
|
- knx
|
|
- mastodon
|
|
|
|
As soon as we have `title` and/or `recipient` support we can migrate more integrations to use the new platform.
|
|
|
|
When integrations are migrated, users will need to use the new `notify.send_message` service, so the migration changes will cause automations to break after the deprecation period is over.
|