From edc023f45aa4021247bb4cb2289e23fdf6d39e77 Mon Sep 17 00:00:00 2001
From: c0ffeeca7 <38767475+c0ffeeca7@users.noreply.github.com>
Date: Thu, 12 Sep 2024 08:52:25 +0200
Subject: [PATCH] Notify: add state (#34693)
---
source/_integrations/notify.markdown | 29 ++++++++++++------
.../integrations/notify/state_notify.png | Bin 0 -> 20885 bytes
2 files changed, 19 insertions(+), 10 deletions(-)
create mode 100644 source/images/integrations/notify/state_notify.png
diff --git a/source/_integrations/notify.markdown b/source/_integrations/notify.markdown
index f436504551e..b1d60495d02 100644
--- a/source/_integrations/notify.markdown
+++ b/source/_integrations/notify.markdown
@@ -17,16 +17,25 @@ If you want to send notifications to the Home Assistant web interface, you may u
{% include integrations/building_block_integration.md %}
+## The state of a notify entity
+
+The state of a notify entity is the date and time when a message was last sent.
+
+
+
+Screenshot showing the state of a notify entity in the developer tools.
+
+
## Action
The legacy `notify` platform will expose a generic `notify` action that can be called to send notifications.
-| Data attribute | Optional | Description |
-| ---------------------- | -------- | ----------- |
-| `message` | no | Body of the notification.
-| `title` | yes | Title of the notification.
-| `target` | yes | Some platforms allow specifying a recipient that will receive the notification. See your platform page if it is supported.
-| `data` | yes | On platforms who have extended functionality. See your platform page if it is supported.
+| Data attribute | Optional | Description |
+| -------------- | -------- | -------------------------------------------------------------------------------------------------------------------------- |
+| `message` | no | Body of the notification. |
+| `title` | yes | Title of the notification. |
+| `target` | yes | Some platforms allow specifying a recipient that will receive the notification. See your platform page if it is supported. |
+| `data` | yes | On platforms who have extended functionality. See your platform page if it is supported. |
## Usage
@@ -38,10 +47,10 @@ One notification integration is automatically included, the Persistent Notificat
Integrations can also implement the notify entity platform. Entity platform implementations will replace the legacy notify action in time. There is an entity platform action `send_message` which allows you to send notification messages to multiple notify entities.
-| Data attribute | Optional | Description |
-| ---------------------- | -------- | ----------- |
-| `message` | no | Body of the notification.
-| `title` | yes | Title of the notification.
+| Data attribute | Optional | Description |
+| -------------- | -------- | -------------------------- |
+| `message` | no | Body of the notification. |
+| `title` | yes | Title of the notification. |
## Companion app notifications
diff --git a/source/images/integrations/notify/state_notify.png b/source/images/integrations/notify/state_notify.png
new file mode 100644
index 0000000000000000000000000000000000000000..009e43d963ed7b38c7fda3b24f03d832383d6c36
GIT binary patch
literal 20885
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