Actionable Notifications Subflow for Android

[zachowj]

Actionable Notifications Subflow for Android

Questions and comments here.

[scooper86]

this is really cool, could you possibly add the ability to add attachments so images can be included in a notification?

[cooperised]

Could there be an option to add arbitrary data to the data: portion of the service call? For example in one of my existing automations that I'd like to replicate in Node-RED, I currently use persistent: true and ttl: 0 in addition to the sticky property to create a notification that can't be dismissed. Adding all these as separate options would be fine too.

[sstratoti]

In the docs for the companion app, under iOS it states:

action_data: # Anything passed in action_data will get echoed back to Home Assistant.

There is also an action_data for android. Try that? It doesn't explicitly say, but I imagine they'd work the same.

[cooperised]

I don't think we're talking about the same thing. I was previously creating actionable, non-dismissable "critical notifications" using HA automations with YAMM like this:

title: Garage Heat
message: Garage heaters are currently on.
data:
  tag: garage_heat
  sticky: true
  persistent: true
  ttl: 0
  priority: high
  actions:
    - action: garage_heat_off
      title: Switch off

The code in this subflow that generates the service call to HA looks like this:

msg.payload = {
    service,
    data: {
        title: env.get('title'),
        message: env.get('message'),
        data: {
            tag: flow.get('notificationTag'),
            actions,
            color: env.get("color"),
            group: env.get("group"),
            sticky: env.get("sticky"),
            timeout: env.get("timeout"),
            icon: env.get("icon")
        }
    }
};

There is no way to get anything else into the body of the service call (e.g. the priority, ttl or persistent fields from above) without editing this code. Doing so is pretty trivial though, so I've added three extra fields to the UI and three extra lines in the code and I can now set these properties no problem.

[cooperised]

Forgot to add, I'll happily fork and create a PR if it would be helpful.

[zachowj]

Contributions always welcomed

[jj-uk]

@cooperised Did this ever get added? It's needed so that the notification arrives if the device is locked, without it, i think the notification only arrives when the phone is next unlocked.

[sstratoti]

Also, to comment on this subflow - this has opened up a whole new world for me. I'm working to rewrite it for iOS notifications, and it'll greatly simplify my flows. Thanks for the example!

[poldim]

@sstratoti How's your progress coming along for this? I imported the subflow and it seems to send the notification to ios without problems. However, none of the actionable responses/selections are making their way back out of the subflow. NR is getting them as I'm watching the mobile_app_notification_action events.

[bls0n]

Did you ever successfully create an ios version? I haven't had success yet and would greatly appreciate ios-specific code if you're willing to share.

[bls0n]

Found it on reddit. Thanks!
https://www.reddit.com/r/homeassistant/comments/naoe4e/nodered_20215_ios_actionable_notifications_subflow/

[aquavass]

Hi there, great work... very impressive.

I'm currently using PUSH OVER messaging service which works well as I am able to send photo snapshots which I believe is not available for android push notifications but am looking to replace all other system messages outside alerts to send actionable messages using your solution... its awesome.

Question, is it possible to execute a function node to set the payload title, message, action title 1 etc? I have tested this but does not work as the values don't appear to pass through to the actionable subflow? Do I have my syntax wrong?

Thanks

[zachowj]

I believe the latest version works, it's the one in the gist

https://gist.github.com/zachowj/a594c63e2d788d89d17fc93d01905042

[rossco555]

I get an error "Call-service error. extra keys not allowed @ data['actions']" when I try that example block above.

(For completeness, I am doing this via a function block but assume that makes no material difference:)

msg.actionable = {
    "title": "Washing Machine Done",
    "message": "override message",
    "actions": [
        null,
        {
            "title": "title 2"
        }
    ]
}

return msg

Also, how do you use this approach - assuming I can get it working - and override service? Does that just sit as a peer to title in the object?

[zachowj]

actions should be under data

msg.actionable = {
  message: "override message",
  data: {
    actions: [...]
  }
}

Doesn't look like I added the ability to override services

[rossco555]

Ok, thanks. Got it working as I saw that structure somewhere else.

To override service, I modified line 5 of 'create service call' to:

const services = msg.service || env.get('service');

(I think I had to put outside of the actionable object to avoid the same error in my original post... haven't looked into it in detail but this is maybe because your function block packages up everything it sees inside actionable and sends it off to the HA call service node, which throws the error?)

[rossco555]

For anyone interested re my previous line of posts, I wanted to override service from the message object because I want to semi-dynamically determine that. I have created a "Notification" wrapper for "Actionable Notification" that looks at a series of input_selects in Home Assistant for different "types" (/categories/classes) of notification where I can choose any combination of three notifiable devices (my phone, my wife's phone, and a wall tablet). This means if my wife gets annoyed with "camera" alerts for example, she can disable those notifications without just disabling everything in Android as she has in the past (and so missing washing machine "appliance" alerts she should be tending to - I shouldn't joke in a PC world).

The wrapper, for anyone interested is a subflow as below:

[
    {
        "id": "6dc0247c.d7210c",
        "type": "subflow",
        "name": "Actionable Notification",
        "info": "Android actionable notification v1.0.0\n\n[Documentation](https://zachowj.github.io/node-red-contrib-home-assistant-websocket/cookbook/actionable-notifications-subflow-for-android.html)\n\nRG 3/5/22: added image in myself\n",
        "category": "HA Actions",
        "in": [
            {
                "x": 84,
                "y": 80,
                "wires": [
                    {
                        "id": "9d85d137.fe487"
                    }
                ]
            }
        ],
        "out": [
            {
                "x": 1188,
                "y": 128,
                "wires": [
                    {
                        "id": "974bd48d.c253e8",
                        "port": 0
                    }
                ]
            },
            {
                "x": 1188,
                "y": 176,
                "wires": [
                    {
                        "id": "974bd48d.c253e8",
                        "port": 1
                    }
                ]
            },
            {
                "x": 1188,
                "y": 224,
                "wires": [
                    {
                        "id": "974bd48d.c253e8",
                        "port": 2
                    }
                ]
            },
            {
                "x": 964,
                "y": 240,
                "wires": [
                    {
                        "id": "5bc7345c.07b1cc",
                        "port": 1
                    }
                ]
            }
        ],
        "env": [
            {
                "name": "service",
                "type": "str",
                "value": "",
                "ui": {
                    "label": {
                        "en-US": "Notify Service"
                    },
                    "type": "input",
                    "opts": {
                        "types": [
                            "str"
                        ]
                    }
                }
            },
            {
                "name": "title",
                "type": "str",
                "value": "",
                "ui": {
                    "label": {
                        "en-US": "Title"
                    },
                    "type": "input",
                    "opts": {
                        "types": [
                            "str"
                        ]
                    }
                }
            },
            {
                "name": "message",
                "type": "str",
                "value": "",
                "ui": {
                    "label": {
                        "en-US": "Message"
                    },
                    "type": "input",
                    "opts": {
                        "types": [
                            "str"
                        ]
                    }
                }
            },
            {
                "name": "action1Title",
                "type": "str",
                "value": "",
                "ui": {
                    "label": {
                        "en-US": "Action 1 Title"
                    },
                    "type": "input",
                    "opts": {
                        "types": [
                            "str"
                        ]
                    }
                }
            },
            {
                "name": "action1Uri",
                "type": "str",
                "value": "",
                "ui": {
                    "label": {
                        "en-US": "Action 1 URI (optional)"
                    },
                    "type": "input",
                    "opts": {
                        "types": [
                            "str"
                        ]
                    }
                }
            },
            {
                "name": "action2Title",
                "type": "str",
                "value": "",
                "ui": {
                    "label": {
                        "en-US": "Action 2 Title"
                    },
                    "type": "input",
                    "opts": {
                        "types": [
                            "str"
                        ]
                    }
                }
            },
            {
                "name": "action2Uri",
                "type": "str",
                "value": "",
                "ui": {
                    "label": {
                        "en-US": "Action 2 URI (optional)"
                    },
                    "type": "input",
                    "opts": {
                        "types": [
                            "str"
                        ]
                    }
                }
            },
            {
                "name": "action3Title",
                "type": "str",
                "value": "",
                "ui": {
                    "label": {
                        "en-US": "Action 3 Title"
                    },
                    "type": "input",
                    "opts": {
                        "types": [
                            "str"
                        ]
                    }
                }
            },
            {
                "name": "action3Uri",
                "type": "str",
                "value": "",
                "ui": {
                    "label": {
                        "en-US": "Action 3 URI (optional)"
                    },
                    "type": "input",
                    "opts": {
                        "types": [
                            "str"
                        ]
                    }
                }
            },
            {
                "name": "userInfo",
                "type": "bool",
                "value": "false",
                "ui": {
                    "label": {
                        "en-US": "Populate User Information"
                    },
                    "type": "checkbox"
                }
            },
            {
                "name": "sticky",
                "type": "bool",
                "value": "false",
                "ui": {
                    "label": {
                        "en-US": "Sticky"
                    },
                    "type": "checkbox"
                }
            },
            {
                "name": "group",
                "type": "str",
                "value": "None",
                "ui": {
                    "label": {
                        "en-US": "Group"
                    },
                    "type": "select",
                    "opts": {
                        "opts": [
                            {
                                "l": {
                                    "en-US": "None"
                                },
                                "v": ""
                            },
                            {
                                "l": {
                                    "en-US": "Cameras"
                                },
                                "v": "camera"
                            },
                            {
                                "l": {
                                    "en-US": "Security"
                                },
                                "v": "security"
                            },
                            {
                                "l": {
                                    "en-US": "Garage"
                                },
                                "v": "garage"
                            },
                            {
                                "l": {
                                    "en-US": "Laundry Room"
                                },
                                "v": "laundry_room"
                            }
                        ]
                    }
                }
            },
            {
                "name": "color",
                "type": "str",
                "value": "",
                "ui": {
                    "label": {
                        "en-US": "Color"
                    },
                    "type": "input",
                    "opts": {
                        "types": [
                            "str"
                        ]
                    }
                }
            },
            {
                "name": "timeout",
                "type": "num",
                "value": "",
                "ui": {
                    "label": {
                        "en-US": "Timeout"
                    },
                    "type": "input",
                    "opts": {
                        "types": [
                            "num"
                        ]
                    }
                }
            },
            {
                "name": "icon",
                "type": "str",
                "value": "",
                "ui": {
                    "label": {
                        "en-US": "Icon"
                    },
                    "type": "input",
                    "opts": {
                        "types": [
                            "str"
                        ]
                    }
                }
            },
            {
                "name": "image_uri",
                "type": "str",
                "value": ""
            }
        ],
        "meta": {},
        "color": "#46B1EF",
        "outputLabels": [
            "Action 1",
            "Action 2",
            "Action 3",
            "Cleared"
        ],
        "icon": "font-awesome/fa-mobile-phone",
        "status": {
            "x": 244,
            "y": 272,
            "wires": [
                {
                    "id": "204dbcfc.144ae4",
                    "port": 0
                }
            ]
        }
    },
    {
        "id": "f9e57204.71076",
        "type": "function",
        "z": "6dc0247c.d7210c",
        "name": "create service call",
        "func": "msg._originalPayload = msg.payload;\nflow.set('latestMessage', msg);\n\n// const services = env.get('service');\nconst services = msg.service || env.get('service');\nif(!services) {\n    node.status({\n        text: 'no services defined',\n        shape: 'ring',\n        fill: 'red'\n    });\n    return;    \n}\n\nconst actions = [1, 2, 3].reduce((acc, i) => {\n    const name = `action${i}`\n    const id = flow.get(`${name}Id`);\n    const title = getActionProperty(i, \"title\") ?? env.get(`${name}Title`);\n    const uri = getActionProperty(i, \"uri\") ?? env.get(`${name}Uri`);\n    const action = uri.length ? 'URI' : title ? id : undefined;\n\n    acc.push({ action, title, uri });\n\n    return acc;\n}, []);\n\nconst tag = flow.get('notificationTag');\nconst data = mergeDeep({\n        title: env.get('title'),\n        message: env.get('message'),\n        data: {\n            tag,\n            color: env.get(\"color\"),\n            group: env.get(\"group\"),\n            sticky: env.get(\"sticky\"),\n            timeout: env.get(\"timeout\"),\n            icon: env.get(\"icon\"),\n            image: env.get(\"image_uri\")\n        },\n    },    \n    msg.actionable,    \n    {data: {actions}},\n);\n\nif(tag !== data?.data?.tag) {\n    flow.set('notificationTag', data?.data?.tag);\n}\n\nservices.trim().split(/,\\s*/).forEach(service => {\n    if(!service) return;\n    \n    msg.payload = {\n        service,\n        data,\n    };\n    node.send(msg);\n});\n\nnode.done();\n\nfunction getActionProperty(index, prop) {\n    const i = index - 1;\n\n    return msg?.actionable?.data?.actions?.[i]?.[prop];\n}\n\n/**\n * Simple object check.\n * @param item\n * @returns {boolean}\n */\nfunction isObject(item) {\n    return (item && typeof item === 'object' && !Array.isArray(item));\n}\n\n/**\n * Deep merge two objects.\n * @param target\n * @param sources\n */\nfunction mergeDeep(target, ...sources) {\n    if (!sources.length) return target;\n    const source = sources.shift();\n\n    if (isObject(target) && isObject(source)) {\n        for (const key in source) {\n            if (isObject(source[key])) {\n                if (!target[key]) Object.assign(target, { [key]: {} });\n                mergeDeep(target[key], source[key]);\n            } else {\n                Object.assign(target, { [key]: source[key] });\n            }\n        }\n    }\n\n    return mergeDeep(target, ...sources);\n}\n",
        "outputs": 1,
        "noerr": 0,
        "initialize": "const randomId = () => Math.random().toString(36).replace(/[^a-z]+/g, '').substr(0, 5);\n\n[1,2,3].forEach(i => {\n    flow.set(`action${i}Id`, `action${i}_${randomId()}`);\n})\n\n\nflow.set('notificationTag', `${env.get('title')}_${randomId()}`);",
        "finalize": "",
        "libs": [],
        "x": 298,
        "y": 80,
        "wires": [
            [
                "368c9723.5876f8"
            ]
        ]
    },
    {
        "id": "974bd48d.c253e8",
        "type": "switch",
        "z": "6dc0247c.d7210c",
        "name": "which action?",
        "property": "eventData.event.action",
        "propertyType": "msg",
        "rules": [
            {
                "t": "eq",
                "v": "action1Id",
                "vt": "flow"
            },
            {
                "t": "eq",
                "v": "action2Id",
                "vt": "flow"
            },
            {
                "t": "eq",
                "v": "action3Id",
                "vt": "flow"
            }
        ],
        "checkall": "true",
        "repair": false,
        "outputs": 3,
        "x": 1024,
        "y": 176,
        "wires": [
            [],
            [],
            []
        ]
    },
    {
        "id": "204dbcfc.144ae4",
        "type": "status",
        "z": "6dc0247c.d7210c",
        "name": "",
        "scope": [
            "f9e57204.71076",
            "5bc7345c.07b1cc",
            "a622c92a.2d9898",
            "368c9723.5876f8"
        ],
        "x": 124,
        "y": 272,
        "wires": [
            []
        ]
    },
    {
        "id": "5bc7345c.07b1cc",
        "type": "function",
        "z": "6dc0247c.d7210c",
        "name": "build message",
        "func": "const latestMessage = flow.get('latestMessage');\nconst event = msg.payload.event;\n\nlatestMessage.eventData = msg.payload;\nlatestMessage.payload = latestMessage._originalPayload;\ndelete latestMessage._originalPayload;\ndelete latestMessage.actionable;\n\nif(env.get('userInfo')) {\n    const userData = msg.userData.find(u => u.id === msg.payload.context.user_id);\n    latestMessage.userData = userData;\n}\n\nif(msg.event_type === 'mobile_app_notification_cleared') {\n    node.status({\n        text: `cleared at: ${getPrettyDate()}`,\n        shape: 'dot',\n        fill: 'blue'\n    });\n    \n    return [null, latestMessage];\n}\n\nconst index = [1,2,3].find(i => event[`action_${i}_key`] === event.action);\nnode.status({\n    text: `${event[`action_${index}_title`]} at: ${getPrettyDate()}`,\n    shape: 'dot',\n    fill: 'green'\n});\n\nreturn latestMessage;\n\n\nfunction getPrettyDate() {\n    return new Date().toLocaleDateString('en-US', {\n        month: 'short',\n        day: 'numeric',\n        hour12: false,\n        hour: 'numeric',\n        minute: 'numeric',\n    });\n}",
        "outputs": 2,
        "noerr": 0,
        "initialize": "",
        "finalize": "",
        "libs": [],
        "x": 832,
        "y": 176,
        "wires": [
            [
                "974bd48d.c253e8"
            ],
            []
        ]
    },
    {
        "id": "8d3bdc0c.37493",
        "type": "switch",
        "z": "6dc0247c.d7210c",
        "name": "belongs here?",
        "property": "payload.event.tag",
        "propertyType": "msg",
        "rules": [
            {
                "t": "eq",
                "v": "notificationTag",
                "vt": "flow"
            }
        ],
        "checkall": "true",
        "repair": false,
        "outputs": 1,
        "x": 432,
        "y": 176,
        "wires": [
            [
                "83ad2004.d04d"
            ]
        ]
    },
    {
        "id": "271e4479.b9249c",
        "type": "ha-api",
        "z": "6dc0247c.d7210c",
        "name": "get user info",
        "server": "a0706da5e5446e30",
        "version": 1,
        "debugenabled": false,
        "protocol": "websocket",
        "method": "get",
        "path": "",
        "data": "{\"type\": \"config/auth/list\"}",
        "dataType": "json",
        "responseType": "json",
        "outputProperties": [
            {
                "property": "userData",
                "propertyType": "msg",
                "value": "",
                "valueType": "results"
            }
        ],
        "x": 822,
        "y": 128,
        "wires": [
            [
                "5bc7345c.07b1cc"
            ]
        ]
    },
    {
        "id": "3618f055.6909a",
        "type": "server-events",
        "z": "6dc0247c.d7210c",
        "name": "mobile_app_notification_cleared",
        "server": "a0706da5e5446e30",
        "version": 1,
        "event_type": "mobile_app_notification_cleared",
        "exposeToHomeAssistant": false,
        "haConfig": [
            {
                "property": "name",
                "value": ""
            },
            {
                "property": "icon",
                "value": ""
            }
        ],
        "waitForRunning": false,
        "outputProperties": [
            {
                "property": "payload",
                "propertyType": "msg",
                "value": "",
                "valueType": "eventData"
            },
            {
                "property": "topic",
                "propertyType": "msg",
                "value": "$outputData(\"eventData\").event_type",
                "valueType": "jsonata"
            },
            {
                "property": "event_type",
                "propertyType": "msg",
                "value": "$outputData(\"eventData\").event_type",
                "valueType": "jsonata"
            }
        ],
        "x": 194,
        "y": 224,
        "wires": [
            [
                "8d3bdc0c.37493"
            ]
        ]
    },
    {
        "id": "83ad2004.d04d",
        "type": "switch",
        "z": "6dc0247c.d7210c",
        "name": "fetch user info?",
        "property": "userInfo",
        "propertyType": "env",
        "rules": [
            {
                "t": "true"
            },
            {
                "t": "else"
            }
        ],
        "checkall": "true",
        "repair": false,
        "outputs": 2,
        "x": 624,
        "y": 176,
        "wires": [
            [
                "271e4479.b9249c"
            ],
            [
                "5bc7345c.07b1cc"
            ]
        ]
    },
    {
        "id": "9d85d137.fe487",
        "type": "switch",
        "z": "6dc0247c.d7210c",
        "name": "",
        "property": "clear_notification",
        "propertyType": "msg",
        "rules": [
            {
                "t": "null"
            },
            {
                "t": "nnull"
            }
        ],
        "checkall": "true",
        "repair": false,
        "outputs": 2,
        "x": 143,
        "y": 80,
        "wires": [
            [
                "f9e57204.71076"
            ],
            [
                "a622c92a.2d9898"
            ]
        ],
        "l": false
    },
    {
        "id": "a622c92a.2d9898",
        "type": "function",
        "z": "6dc0247c.d7210c",
        "name": "create clear notification",
        "func": "const services = env.get('service');\nif(!services) {\n    node.status({\n        text: 'no services defined',\n        shape: 'ring',\n        fill: 'red'\n    });\n    return;    \n}\n\nservices.trim().split(/,\\s*/).forEach(service => {\n    if(!service) return;\n    \n    msg.payload = {\n        service,\n        data: {\n            message: \"clear_notification\",\n            data: {\n                tag: flow.get('notificationTag'),\n            }\n        }\n    };\n    node.send(msg);\n});\n\nnode.status({text: \"cleared\"});\nnode.done();",
        "outputs": 1,
        "noerr": 0,
        "initialize": "",
        "finalize": "",
        "libs": [],
        "x": 318,
        "y": 128,
        "wires": [
            [
                "368c9723.5876f8"
            ]
        ]
    },
    {
        "id": "9bfe567c.3d10c8",
        "type": "server-events",
        "z": "6dc0247c.d7210c",
        "name": "mobile_app_notification_action",
        "server": "a0706da5e5446e30",
        "version": 1,
        "event_type": "mobile_app_notification_action",
        "exposeToHomeAssistant": false,
        "haConfig": [
            {
                "property": "name",
                "value": ""
            },
            {
                "property": "icon",
                "value": ""
            }
        ],
        "waitForRunning": false,
        "outputProperties": [
            {
                "property": "payload",
                "propertyType": "msg",
                "value": "",
                "valueType": "eventData"
            },
            {
                "property": "topic",
                "propertyType": "msg",
                "value": "$outputData(\"eventData\").event_type",
                "valueType": "jsonata"
            },
            {
                "property": "event_type",
                "propertyType": "msg",
                "value": "$outputData(\"eventData\").event_type",
                "valueType": "jsonata"
            }
        ],
        "x": 194,
        "y": 176,
        "wires": [
            [
                "8d3bdc0c.37493"
            ]
        ]
    },
    {
        "id": "368c9723.5876f8",
        "type": "api-call-service",
        "z": "6dc0247c.d7210c",
        "name": "",
        "server": "a0706da5e5446e30",
        "version": 5,
        "debugenabled": false,
        "domain": "notify",
        "areaId": [],
        "deviceId": [],
        "entityId": [],
        "data": "",
        "dataType": "json",
        "mergeContext": "",
        "mustacheAltTags": false,
        "outputProperties": [],
        "queue": "all",
        "x": 550,
        "y": 80,
        "wires": [
            []
        ]
    },
    {
        "id": "a0706da5e5446e30",
        "type": "server",
        "name": "Home Assistant",
        "version": 4,
        "addon": false,
        "rejectUnauthorizedCerts": true,
        "ha_boolean": "y|yes|true|on|home|open",
        "connectionDelay": true,
        "cacheJson": true,
        "heartbeat": false,
        "heartbeatInterval": "30",
        "areaSelector": "friendlyName",
        "deviceSelector": "friendlyName",
        "entitySelector": "friendlyName",
        "statusSeparator": "at: ",
        "statusYear": "hidden",
        "statusMonth": "short",
        "statusDay": "numeric",
        "statusHourCycle": "h23",
        "statusTimeFormat": "h:m"
    },
    {
        "id": "d7045db4775debcf",
        "type": "subflow",
        "name": "Notifications",
        "info": "",
        "category": "",
        "in": [
            {
                "x": 40,
                "y": 40,
                "wires": [
                    {
                        "id": "fb5ae0dc1a6ef6b2"
                    }
                ]
            }
        ],
        "out": [
            {
                "x": 920,
                "y": 40,
                "wires": [
                    {
                        "id": "2149411044a9dab3",
                        "port": 0
                    }
                ]
            },
            {
                "x": 940,
                "y": 100,
                "wires": [
                    {
                        "id": "2149411044a9dab3",
                        "port": 1
                    }
                ]
            },
            {
                "x": 940,
                "y": 160,
                "wires": [
                    {
                        "id": "2149411044a9dab3",
                        "port": 2
                    }
                ]
            },
            {
                "x": 920,
                "y": 220,
                "wires": [
                    {
                        "id": "2149411044a9dab3",
                        "port": 3
                    }
                ]
            }
        ],
        "env": [
            {
                "name": "type",
                "type": "str",
                "value": "general"
            },
            {
                "name": "service",
                "type": "str",
                "value": ""
            },
            {
                "name": "title",
                "type": "str",
                "value": ""
            },
            {
                "name": "message",
                "type": "str",
                "value": ""
            },
            {
                "name": "action1Title",
                "type": "str",
                "value": ""
            },
            {
                "name": "action1Uri",
                "type": "str",
                "value": ""
            },
            {
                "name": "action2Title",
                "type": "str",
                "value": ""
            },
            {
                "name": "action2Uri",
                "type": "str",
                "value": ""
            },
            {
                "name": "action3Title",
                "type": "str",
                "value": ""
            },
            {
                "name": "action3Uri",
                "type": "str",
                "value": ""
            },
            {
                "name": "userInfo",
                "type": "bool",
                "value": "false"
            },
            {
                "name": "sticky",
                "type": "bool",
                "value": "false"
            },
            {
                "name": "group",
                "type": "str",
                "value": "None"
            },
            {
                "name": "color",
                "type": "str",
                "value": ""
            },
            {
                "name": "timeout",
                "type": "str",
                "value": ""
            },
            {
                "name": "icon",
                "type": "str",
                "value": ""
            },
            {
                "name": "image_uri",
                "type": "str",
                "value": ""
            }
        ],
        "meta": {},
        "color": "#A6BBCF",
        "outputLabels": [
            "Action 1",
            "Action 2",
            "Action 3",
            "Cleared"
        ],
        "icon": "font-awesome/fa-commenting-o",
        "status": {
            "x": 280,
            "y": 280,
            "wires": [
                {
                    "id": "33d4706215dfe888",
                    "port": 0
                }
            ]
        }
    },
    {
        "id": "2149411044a9dab3",
        "type": "subflow:6dc0247c.d7210c",
        "z": "d7045db4775debcf",
        "name": "notify",
        "env": [
            {
                "name": "action2Title",
                "value": " ",
                "type": "str"
            },
            {
                "name": "action3Title",
                "value": " ",
                "type": "str"
            },
            {
                "name": "group",
                "value": "",
                "type": "str"
            }
        ],
        "x": 750,
        "y": 120,
        "wires": [
            [],
            [],
            [],
            []
        ]
    },
    {
        "id": "fb5ae0dc1a6ef6b2",
        "type": "api-current-state",
        "z": "d7045db4775debcf",
        "name": "notifications permissible?",
        "server": "a0706da5e5446e30",
        "version": 3,
        "outputs": 2,
        "halt_if": "on",
        "halt_if_type": "str",
        "halt_if_compare": "is",
        "entity_id": "binary_sensor.notifications_permissive",
        "state_type": "str",
        "blockInputOverrides": false,
        "outputProperties": [
            {
                "property": "payload",
                "propertyType": "msg",
                "value": "",
                "valueType": "entityState"
            },
            {
                "property": "data",
                "propertyType": "msg",
                "value": "",
                "valueType": "entity"
            }
        ],
        "for": "0",
        "forType": "num",
        "forUnits": "minutes",
        "override_topic": false,
        "state_location": "payload",
        "override_payload": "msg",
        "entity_location": "data",
        "override_data": "msg",
        "x": 210,
        "y": 40,
        "wires": [
            [
                "b7c8986d2071d993"
            ],
            []
        ]
    },
    {
        "id": "b7c8986d2071d993",
        "type": "api-get-history",
        "z": "d7045db4775debcf",
        "name": "get all notification recipient settings",
        "server": "a0706da5e5446e30",
        "version": 0,
        "startdate": "",
        "enddate": "",
        "entityid": "_notification_recipients",
        "entityidtype": "includes",
        "useRelativeTime": true,
        "relativeTime": "0s",
        "flatten": true,
        "output_type": "array",
        "output_location_type": "msg",
        "output_location": "payload",
        "x": 240,
        "y": 120,
        "wires": [
            [
                "55547da98ecaba63"
            ]
        ]
    },
    {
        "id": "55547da98ecaba63",
        "type": "function",
        "z": "d7045db4775debcf",
        "name": "determine recipient services",
        "func": "// determine the recipient services for the provided notificationType\n\nvar recipientSettingsObj = {};\n\nvar servicesObj = {\n    MyAir: 'mobile_app_pic8gs8',\n    Ross: 'mobile_app_ross_s_pixel_4',\n    Wife: 'mobile_app_wife_s_pixel_6',\n}\n\nmsg.payload.forEach(item => {\n    settingName = item[0].entity_id\n                    .replace('input_select.', '')\n                    .replace('_notification_recipients', '');\n    recipientSettingsObj[settingName] = item[0].state;\n})\n\nmsg.payload = \"actionable\" // no effect, visual only\n\nmsg.service = (recipientSettingsObj[msg.type] ?? '')\n                .split(', ')\n                .map(name => servicesObj[name] ?? null)\n                .join(',')\n\nreturn msg;",
        "outputs": 1,
        "noerr": 0,
        "initialize": "",
        "finalize": "",
        "libs": [],
        "x": 540,
        "y": 120,
        "wires": [
            [
                "2149411044a9dab3",
                "1668fe9b64bdb625"
            ]
        ]
    },
    {
        "id": "591943eced056847",
        "type": "comment",
        "z": "d7045db4775debcf",
        "name": "// notifications wrapper to allow custom routing (or disabling) of notifications by type",
        "info": "",
        "x": 390,
        "y": 220,
        "wires": []
    },
    {
        "id": "1668fe9b64bdb625",
        "type": "debug",
        "z": "d7045db4775debcf",
        "name": "debug 20",
        "active": true,
        "tosidebar": true,
        "console": false,
        "tostatus": false,
        "complete": "true",
        "targetType": "full",
        "statusVal": "",
        "statusType": "auto",
        "x": 760,
        "y": 340,
        "wires": []
    },
    {
        "id": "33d4706215dfe888",
        "type": "status",
        "z": "d7045db4775debcf",
        "name": "",
        "scope": [
            "2149411044a9dab3"
        ],
        "x": 160,
        "y": 280,
        "wires": [
            []
        ]
    },
    {
        "id": "d08b79becec6a317",
        "type": "comment",
        "z": "d7045db4775debcf",
        "name": "// added image ('image_uri', intentionally lowercase for identification) as an env var",
        "info": "",
        "x": 710,
        "y": 540,
        "wires": []
    },
    {
        "id": "b7323155b6dd489a",
        "type": "comment",
        "z": "d7045db4775debcf",
        "name": "// modified 'create service call' function, line 5 (see details)",
        "info": "const services = msg.actionable.data.service || env.get('service');",
        "x": 630,
        "y": 580,
        "wires": []
    },
    {
        "id": "30a6497ece70dab5",
        "type": "comment",
        "z": "d7045db4775debcf",
        "name": "My mods to Actionable Notification (v1.0.0)",
        "info": "",
        "x": 580,
        "y": 500,
        "wires": []
    }
]

My HA input_selects are of the example form below, and all finish with _notification_recipients so they are picked up by the wrapper to reconcile the notification type against... and then determine the recipients' names.

appliance_notification_recipients:
  name: Appliance Related Notification Recipients
  icon: mdi:account-multiple-check
  options:
    - Ross, Wife
    - Ross
    - Wife
    - MyAir
    - Ross, Wife, MyAir
    - Ross, MyAir
    - Wife, MyAir
    - None

I have hard-coded the logic to translate the input_select options "Ross", "Wife", "MyAir" into service names as can be seen in my code. Obviously there are ways to avoid this (or define in HA) but I figured that was even further over engineering.

Whenever I have the need for an Actionable Notification, I hydrate my own "Notification" node with a function node I call "prepare message" and it has a structure like this:

msg.actionable = {
    title: "Clothes Dryer Done",
    message: "bla",
    data: {
        actions: [
            null,
            {
                "title": "Action 2 Title"
            }
        ]
    }
}

msg.type = 'appliance'
msg.service = 'mobile_app_ross_s_pixel_4'

return msg

Take it or leave it, just thought I would share.

[sanderlv]

What and where do I need to change when I have translated the message? I do not see any output in my debug node
. This is not my final flow but am testing.

EDIT: I copied again, now it's working.

1 tip and 1 question however.

Can you please make the examples with a separate sub-flow if possible upon copying a new in node red it copies a second subflow but this is not needed.

Question: I only get the notifications on android when the screen is turned on, can this be changed somewhere?

[sanderlv]

note 2 self for question:

add this here:
priority: "high",

[greghesp]

Does anyone else get the following error?
"Call-Service attempted without connection to server."

[zachowj]

I would guess you're triggering the flow before NR has had a chance to connect to NR. This normally happens when you start a flow with a inject node or some other node that triggers right after it has been loaded by NR.

In a recent release, I added a queue system to the call-service node to help with these use cases.

[greghesp]

Ah that makes perfect sense actually! Will keep playing, thanks :)

[greghesp]

@zachowj Do you know where the throttle node is coming from?

I don't seem to have this one installed and cant find it anywhere

[zachowj]

If I wrote that today I would just use a delay node set to rate limit. I would just swap that node out.

[zupancicmarko]

Hi @zachowj , quick quesiton...

I get this error when trying to call the "mobile_app_jason" service.
"Call-service API error. Error Message: Service not found."

Any ideas?

[zachowj]

You have an incorrect service defined in the config

[zupancicmarko]

Awesome! Thanks for the quick reply. Changed it to "notify" and now its working! 🙌
Thanks a million!

[jwilleke]

I give up. What is supposed to be in there for mobile_app_jason?
Where does "mobile_app_jason" this come from?

[zachowj]

It's normally the name of your phone.

You can find it by dropping a call-service node down then entering notify as the domain and the autocomplete should show up with available options. You can also do this from the HA dev tools.

[jwilleke]

Thanks!

[pixel217]

hello,
I have issues trying to get this to work

I am using nodered version 10 and it requested to update the nodes of the subflow....

I am focussing on one error at a time, and for the first one : I tried to put the correct Notify Service (mobile_app_xxx) that works in another service call for non actionable notifications :/

[zachowj]

Open up the subflow and then open up each HA node so it sets the server then deploy.

[pixel217]

going to try this, will report if successful

[pixel217]

wonderfull!!! that worked!

this subflow is bliss!

thanks for that great developement!

[BigManDave]

Greetings,
I've just found this subflow today and I love it, great work!

I'm seeing an issue where as soon as I enter a URI for an action it no longer outputs from the node. i.e It puts a stop to my flow.
Do you have any advice please?

P.S. Sorry for any language errors, I'm very new to Node-Red :)

[zachowj]

Are you getting any errors in the debug panel?

[BigManDave]

Thanks for responding so quickly.
Nope, I'm not seeing anything in the debug panel. I've even tried adding a debug node to the output with the URI and still nothing.

[zachowj]

I need to update the cookbook but give my latest version a try and see if it works for you.

https://gist.github.com/zachowj/a594c63e2d788d89d17fc93d01905042

[BigManDave]

Thanks for sending that over. Unfortunately it's still performing the same.

[dbs179]

Hello,

Great work, this subflow and your examples have helped me tremendously. Someone asked it above, but I didn't see a response. Is there anyway to include an attachment within this? I'm using it for a doorbell notification and have the flow taking a snapshot at the doorbell cam, but can't figure out how to include it.

Thanks for sharing this with the community!!

[dbs179]

Excellent. I'll have a look at this new version and samples!!!

[dbs179]

Thanks again. I was able to use this to do what I was trying to do. I greatly appreciate it!

[sanderlv]

May I ask how to use the "clear_notification" in a flow instead of a manual trigger?

[zachowj]

change node

[sorted01]

Hi @zachowj
First of all, thank you for that awesome subflow. It works like a charm as long as my phone is not "sleeping". If that is the case if have to wait until I unlock it. There is a whole thread about this issue on samsung phones like mine:
https://community.home-assistant.io/t/notification-delay-samsung-s10/222615/34

The solution seems following:
I came here to share my experience with my S10+. I managed to solve my delay by using “priority” instead of “importance” as well. I’m glad there’s a topic here and that you’re helping others already! I wish I had found this thread before wasting many hours on it.

But as I am quite new to home assistant and node-red I don't know where and how to change it in your subflow :)

Any help would be highly welcome!

Thank you!

EDIT

Seems to be answered above. I'll give it a try! :) - priority: "high"

[sanderlv]

Another question about this flow for the trigger "Override with image and action". What is this meant for? To send a picture along? I can't get this going...

What should I do?

{
    "title": "override title",
    "message": "override message",
    "data": {
        "image": "https://raw.githubusercontent.com/home-assistant/assets/master/logo/logo.png",
        "actions": [
            null,
            {
                "title": "Home Assistant",
                "uri": "https://home-assistant.io"
            }
        ]
    }
}

[zachowj]

It's meant as an example of how you can override any settings of the notification from a message property. For this to work correctly you need to be using the export from the last gist or after I have updated the example to the gist version.

https://gist.github.com/zachowj/a594c63e2d788d89d17fc93d01905042

[ffurious01]

Hi Zach,

I am getting following error: "Call-Service attempted without connection to server." when I try testing the demo flow by just replacing the "Notify Service" env variable with the reference of my phone.

What am I doing wrong? Please help.

[zachowj]

Need to wait for NR to connect to HA.

[ffurious01]

Thanks Zach. It worked! It looks like a HA restart cleared up things.

[lewtopia]

Fantastic recipe!

My question, which is sort of answered in part above:

How to adjust the properties of the subflow and service call for HA instances with more than one mobile device?

ie: send the notification to one of the mobiles registered with HA.

The only solution I could envision is not using a subflow, or making multiple copies of the subflow for each mobile device. (But that would then defeat the purpose of the subflow...)

Any suggestion on how to pass the notify service to the subflow to allow for multiple mobile_app_{{device_id}} ?

[ffurious01]

Lewtopia,

Regarding how to call service on more than one device, I was able to add multiple devices to the "Notify Service" property (comma separated) and all the devices get notifications.

[lewtopia]

That is a possibility.

My intent is to send an actionable notification when device connects to home wifi with an action to unlock the door.

So, it doesn't make the best sense to send the notification to all phones, since not all would be connecting to wifi at the same time, or rather, not all phones would be arriving home at the same time.

Nor would I want family members unlocking doors when not at home (that would be checked in/before the service call).

[zachowj]

You could change this line in the create service call function

const services = env.get('service');

to

const services = msg.service || env.get('service');

If the msg object with the property service set it will override the value set in the subflow config.

[xvlw]

This looks fantastic. I am also getting this error msg : string[38] "Call-service error. Service not found." when trying to deploy the Demo Flow that I can't solve.

I believe it may have to do with this node

What part did I not do right haha. When I first opened this node up it was blank, just had notify in the Domain field, I filled in the Service (not sure if i needed to). Is it because I don't have an entity or should I be filling this node out at all.

[zachowj]

remove notify. from the service field just use the service part and not the domain

[zachowj]

[xvlw]

Yessss! Thank you!!!

[xvlw]

Kinda curious, I wonder if there is a way to use the fingerprint authentication from Android to confirm if the button action should be initiated.

Enter Zone > Push Notification > Action Button > Fingerprint Auth > Action Performed.

Puts an extra security layer on the action for unlocking doors and that kind of stuff

[vaderag]

Wondering if this is the same thing I'm seeing here: #311 (comment)

I'm not clear how to get to that Environment Variables option - i see this on that node:

[theoracle09]

Hi zachowj and thank you so much for putting the time and support into this subflow. I didn't even know NR was capable of these things, which is gonna get me really digging into it.

I've read this thread 3 times now as well as picking through the code but can't find a solution: can the notification be removed from android's status bar once the action has been pressed? I see the sticky tick box, but ticked or unticked the notification stays. Once the action is over (I'm using it to open the HA app to a certain lovelace dash) I do see in NR the subflow text at the bottom says "cleared" with date and time. But I'd like it to clear the notification on press of the action button. Am I missing something?

Edit to add: with the sticky box unticked if I tap the notification itself it opens HA and the notification gets removed. But if I click Action 1 (which is a uri: "/lovelace/mail") it launched the correct dashboard but keeps the notification in the status bar.

One more edit: I just looked over your Expiration Date Monitor in your cookbook and realize you're the one that helped me with that almost two years ago. Dang! Thanks for all that you do!

[ACiDGRiM]

I moved one of my home assistant os installs to a simple docker compose of home assistant and nodded, now I'm getting this error suddenly

InputError: Invalid merge context: callServiceData

Which is occurring where the function node hands-off the payload with notify options to the notify service node.

I can't find an explination. Has anyone run into this?

[salleq]

This started happening for me as well. But I've been on dockerised HA/Node Red for a long time, so it must've been some of the latest updates for the HA websocket.

EDIT: I realised I'm once again in the Android subflow thread (I'm using iOS right now) but thought worth mentioning.

[salleq]

Not sure if this is a correct way to fix it, but I noticed that "Send notifications" Service Call node had "callServiceData" in the merge context field. I removed that and it started working again🤷

[zachowj]

In the next release 0.62.3 if the mergeContext doesn't exist it won't through an error.

[antb33]

How do I use the action REPLY feature? I would like to be able to add a comment when I click the action on Android, then use the inputed data in the subsequent flow.

From the HA documentation about actions: When set to REPLY, you will be prompted for text to send with the event.. I can't figure out how to configure this.

This subflow fantastic, many thanks!

[zachowj]

REPLY currently won't work with this subflow

[antb33]

OK thanks

[dovy6]

Thanks for this, it's super helpful to me and many others.
Question for you. Is there a way to have multiple channels, for different notifications? For example, I want a different notification on my phone when someone rings my doorbell (my phones play doorbell.mp3) than when the garage door is open

const data = mergeDeep({
        title: env.get('title'),
        message: env.get('message'),
        data: {
            tag,
            color: env.get("color"),
            group: env.get("group"),
            sticky: env.get("sticky"),
            timeout: env.get("timeout"),
            icon: env.get("icon"),
            ttl: 0,
            priority: "high",
            channel: "doorbell",

This appears to be set "node-red-wide" and not just for a specific call to "actionable notifications." My goal would be able to have perhaps more than one copy of the function so I could set more than one channel. Is this possible?

Thanks again @zachowj

Dovy

[zachowj]

A temporary solution would be to have a change node before the subflow that sets the channel property.

{
 "data": {
    "channel": "doorbell"
  }
}

or if you're feeling adventurous you can add a new field to the subflow and then add it where you have channel defined above.

channel: env.get("channel"),`

[dovy6]

Thanks so much, adding a channel field and env.get("channel"), appears to have worked super well and was super easy to implement!

If I may bother you for another question, I'm trying to warn myself that the garage door has been open for x minutes. For some reason, the notification that comes in only says "The garage door has been open for minutes," not parsing the {{minutes}} as a variable. What do I need to change?

[{"id":"6dc0247c.d7210c","type":"subflow","name":"Actionable Notifications","info":"Android actionable notification v1.0.0\n\n[Documentation](https://zachowj.github.io/node-red-contrib-home-assistant-websocket/cookbook/actionable-notifications-subflow-for-android.html)\n","category":"HA Actions","in":[{"x":50,"y":30,"wires":[{"id":"9d85d137.fe487"}]}],"out":[{"x":160,"y":30,"wires":[]}],"env":[{"name":"service","type":"str","value":"mobile_app_pixel_7_pro","ui":{"label":{"en-US":"Notify Service"},"type":"input","opts":{"types":["str"]}}},{"name":"title","type":"str","value":"","ui":{"label":{"en-US":"Title"},"type":"input","opts":{"types":["str"]}}},{"name":"message","type":"str","value":"","ui":{"label":{"en-US":"Message"},"type":"input","opts":{"types":["str"]}}},{"name":"action1Title","type":"str","value":"","ui":{"label":{"en-US":"Action 1 Title"},"type":"input","opts":{"types":["str"]}}},{"name":"action1Uri","type":"str","value":"","ui":{"label":{"en-US":"Action 1 URI (optional)"},"type":"input","opts":{"types":["str"]}}},{"name":"action2Title","type":"str","value":"","ui":{"label":{"en-US":"Action 2 Title"},"type":"input","opts":{"types":["str"]}}},{"name":"action2Uri","type":"str","value":"","ui":{"label":{"en-US":"Action 2 URI (optional)"},"type":"input","opts":{"types":["str"]}}},{"name":"action3Title","type":"str","value":"","ui":{"label":{"en-US":"Action 3 Title"},"type":"input","opts":{"types":["str"]}}},{"name":"action3Uri","type":"str","value":"","ui":{"label":{"en-US":"Action 3 URI (optional)"},"type":"input","opts":{"types":["str"]}}},{"name":"userInfo","type":"bool","value":"false","ui":{"label":{"en-US":"Populate User Information"},"type":"checkbox"}},{"name":"sticky","type":"bool","value":"false","ui":{"label":{"en-US":"Sticky"},"type":"checkbox"}},{"name":"group","type":"str","value":"None","ui":{"label":{"en-US":"Group"},"type":"select","opts":{"opts":[{"l":{"en-US":"None"},"v":""},{"l":{"en-US":"Cameras"},"v":"camera"},{"l":{"en-US":"Security"},"v":"security"},{"l":{"en-US":"Garage"},"v":"garage"},{"l":{"en-US":"Laundry Room"},"v":"laundry_room"}]}}},{"name":"color","type":"str","value":"","ui":{"label":{"en-US":"Color"},"type":"input","opts":{"types":["str"]}}},{"name":"timeout","type":"num","value":"","ui":{"label":{"en-US":"Timeout"},"type":"input","opts":{"types":["num"]}}},{"name":"icon","type":"str","value":"","ui":{"label":{"en-US":"Icon"},"type":"input","opts":{"types":["str"]}}},{"name":"channel","type":"str","value":""}],"meta":{},"color":"#46B1EF","icon":"font-awesome/fa-mobile-phone","status":{"x":280,"y":275,"wires":[{"id":"204dbcfc.144ae4","port":0}]}},{"id":"f9e57204.71076","type":"function","z":"6dc0247c.d7210c","name":"create service call","func":"msg._originalPayload = msg.payload;\nflow.set('latestMessage', msg);\n\nconst services = env.get('service');\nif(!services) {\n node.status({\n text: 'no services defined',\n shape: 'ring',\n fill: 'red'\n });\n return; \n}\n\nconst actions = [1, 2, 3].reduce((acc, i) => {\n const name = `action${i}`\n const id = flow.get(`${name}Id`);\n const title = getActionProperty(i, \"title\") ?? env.get(`${name}Title`);\n const uri = getActionProperty(i, \"uri\") ?? env.get(`${name}Uri`);\n const action = uri.length ? 'URI' : title ? id : undefined;\n\n acc.push({ action, title, uri });\n\n return acc;\n}, []);\n\nconst tag = flow.get('notificationTag');\nconst data = mergeDeep({\n title: env.get('title'),\n message: env.get('message'),\n data: {\n tag,\n color: env.get(\"color\"),\n group: env.get(\"group\"),\n sticky: env.get(\"sticky\"),\n timeout: env.get(\"timeout\"),\n icon: env.get(\"icon\"),\n ttl: 0,\n priority: \"high\",\n channel: env.get(\"channel\"),\n\n },\n }, \n msg.actionable, \n {data: {actions}},\n);\n\nif(tag !== data?.data?.tag) {\n flow.set('notificationTag', data?.data?.tag);\n}\n\nservices.trim().split(/,\\s*/).forEach(service => {\n if(!service) return;\n \n msg.payload = {\n service,\n data,\n };\n node.send(msg);\n});\n\nnode.done();\n\nfunction getActionProperty(index, prop) {\n const i = index - 1;\n\n return msg?.actionable?.data?.actions?.[i]?.[prop];\n}\n\n/**\n * Simple object check.\n * @param item\n * @returns {boolean}\n */\nfunction isObject(item) {\n return (item && typeof item === 'object' && !Array.isArray(item));\n}\n\n/**\n * Deep merge two objects.\n * @param target\n * @param sources\n */\nfunction mergeDeep(target, ...sources) {\n if (!sources.length) return target;\n const source = sources.shift();\n\n if (isObject(target) && isObject(source)) {\n for (const key in source) {\n if (isObject(source[key])) {\n if (!target[key]) Object.assign(target, { [key]: {} });\n mergeDeep(target[key], source[key]);\n } else {\n Object.assign(target, { [key]: source[key] });\n }\n }\n }\n\n return mergeDeep(target, ...sources);\n}\n","outputs":1,"noerr":0,"initialize":"const randomId = () => Math.random().toString(36).replace(/[^a-z]+/g, '').substr(0, 5);\n\n[1,2,3].forEach(i => {\n flow.set(`action${i}Id`, `action${i}_${randomId()}`);\n})\n\n\nflow.set('notificationTag', `${env.get('title')}_${randomId()}`);","finalize":"","libs":[],"x":298,"y":80,"wires":[["368c9723.5876f8"]]},{"id":"974bd48d.c253e8","type":"switch","z":"6dc0247c.d7210c","name":"which action?","property":"eventData.event.action","propertyType":"msg","rules":[{"t":"eq","v":"action1Id","vt":"flow"},{"t":"eq","v":"action2Id","vt":"flow"},{"t":"eq","v":"action3Id","vt":"flow"}],"checkall":"true","repair":false,"outputs":3,"x":1024,"y":176,"wires":[["bca9029fca6a433f"],[],[]]},{"id":"204dbcfc.144ae4","type":"status","z":"6dc0247c.d7210c","name":"","scope":["f9e57204.71076","5bc7345c.07b1cc","83ad2004.d04d","a622c92a.2d9898","368c9723.5876f8","9bfe567c.3d10c8"],"x":124,"y":272,"wires":[[]]},{"id":"5bc7345c.07b1cc","type":"function","z":"6dc0247c.d7210c","name":"build message","func":"const latestMessage = flow.get('latestMessage');\nconst event = msg.payload.event;\n\nlatestMessage.eventData = msg.payload;\nlatestMessage.payload = latestMessage._originalPayload;\ndelete latestMessage._originalPayload;\ndelete latestMessage.actionable;\n\nif(env.get('userInfo')) {\n const userData = msg.userData.find(u => u.id === msg.payload.context.user_id);\n latestMessage.userData = userData;\n}\n\nif(msg.event_type === 'mobile_app_notification_cleared') {\n node.status({\n text: `cleared at: ${getPrettyDate()}`,\n shape: 'dot',\n fill: 'blue'\n });\n \n return [null, latestMessage];\n}\n\nconst index = [1,2,3].find(i => event[`action_${i}_key`] === event.action);\nnode.status({\n text: `${event[`action_${index}_title`]} at: ${getPrettyDate()}`,\n shape: 'dot',\n fill: 'green'\n});\n\nreturn latestMessage;\n\n\nfunction getPrettyDate() {\n return new Date().toLocaleDateString('en-US', {\n month: 'short',\n day: 'numeric',\n hour12: false,\n hour: 'numeric',\n minute: 'numeric',\n });\n}","outputs":2,"noerr":0,"initialize":"","finalize":"","libs":[],"x":855,"y":275,"wires":[["974bd48d.c253e8"],[]]},{"id":"8d3bdc0c.37493","type":"switch","z":"6dc0247c.d7210c","name":"belongs here?","property":"payload.event.tag","propertyType":"msg","rules":[{"t":"eq","v":"notificationTag","vt":"flow"}],"checkall":"true","repair":false,"outputs":1,"x":432,"y":176,"wires":[["83ad2004.d04d"]]},{"id":"271e4479.b9249c","type":"ha-api","z":"6dc0247c.d7210c","name":"get user info","server":"","version":1,"debugenabled":true,"protocol":"websocket","method":"get","path":"","data":"{\"type\": \"config/auth/list\"}","dataType":"json","responseType":"json","outputProperties":[{"property":"userData","propertyType":"msg","value":"","valueType":"results"}],"x":822,"y":128,"wires":[["5bc7345c.07b1cc"]]},{"id":"3618f055.6909a","type":"server-events","z":"6dc0247c.d7210c","name":"mobile_app_notification_cleared","server":"","version":2,"eventType":"mobile_app_notification_cleared","exposeToHomeAssistant":false,"eventData":"","haConfig":[{"property":"name","value":""},{"property":"icon","value":""}],"waitForRunning":false,"outputProperties":[{"property":"payload","propertyType":"msg","value":"","valueType":"eventData"},{"property":"topic","propertyType":"msg","value":"$outputData(\"eventData\").event_type","valueType":"jsonata"},{"property":"event_type","propertyType":"msg","value":"$outputData(\"eventData\").event_type","valueType":"jsonata"}],"x":194,"y":224,"wires":[["8d3bdc0c.37493"]]},{"id":"83ad2004.d04d","type":"switch","z":"6dc0247c.d7210c","name":"fetch user info?","property":"userInfo","propertyType":"env","rules":[{"t":"true"},{"t":"else"}],"checkall":"true","repair":false,"outputs":2,"x":624,"y":176,"wires":[["271e4479.b9249c"],["5bc7345c.07b1cc"]]},{"id":"9d85d137.fe487","type":"switch","z":"6dc0247c.d7210c","name":"","property":"clear_notification","propertyType":"msg","rules":[{"t":"null"},{"t":"nnull"}],"checkall":"true","repair":false,"outputs":2,"x":143,"y":80,"wires":[["f9e57204.71076"],["a622c92a.2d9898"]],"l":false},{"id":"a622c92a.2d9898","type":"function","z":"6dc0247c.d7210c","name":"create clear notification","func":"const services = env.get('service');\nif(!services) {\n node.status({\n text: 'no services defined',\n shape: 'ring',\n fill: 'red'\n });\n return; \n}\n\nservices.trim().split(/,\\s*/).forEach(service => {\n if(!service) return;\n \n msg.payload = {\n service,\n data: {\n message: \"clear_notification\",\n data: {\n tag: flow.get('notificationTag'),\n }\n }\n };\n node.send(msg);\n});\n\nnode.status({text: \"cleared\"});\nnode.done();","outputs":1,"noerr":0,"initialize":"","finalize":"","libs":[],"x":318,"y":128,"wires":[["368c9723.5876f8"]]},{"id":"9bfe567c.3d10c8","type":"server-events","z":"6dc0247c.d7210c","name":"mobile_app_notification_action","server":"","version":2,"eventType":"mobile_app_notification_action","exposeToHomeAssistant":false,"eventData":"","haConfig":[{"property":"name","value":""},{"property":"icon","value":""}],"waitForRunning":false,"outputProperties":[{"property":"payload","propertyType":"msg","value":"","valueType":"eventData"},{"property":"topic","propertyType":"msg","value":"$outputData(\"eventData\").event_type","valueType":"jsonata"},{"property":"event_type","propertyType":"msg","value":"$outputData(\"eventData\").event_type","valueType":"jsonata"}],"x":194,"y":176,"wires":[["8d3bdc0c.37493"]]},{"id":"368c9723.5876f8","type":"api-call-service","z":"6dc0247c.d7210c","name":"","server":"","version":5,"debugenabled":false,"domain":"notify","service":"notify","areaId":[],"deviceId":[],"entityId":[],"data":"","dataType":"json","mergeContext":"","mustacheAltTags":false,"outputProperties":[],"queue":"all","x":540,"y":80,"wires":[[]]},{"id":"bca9029fca6a433f","type":"api-call-service","z":"6dc0247c.d7210c","name":"","server":"","version":5,"debugenabled":false,"domain":"cover","service":"close_cover","areaId":[],"deviceId":["ec1c05644d3ead8779dafcab6ae83be4"],"entityId":[],"data":"","dataType":"jsonata","mergeContext":"","mustacheAltTags":false,"outputProperties":[],"queue":"none","x":1240,"y":175,"wires":[[]]},{"id":"fe352a1c.f6e4f8","type":"api-current-state","z":"b767f94fe7c1f884","name":"Is garage door open?","server":"","version":3,"outputs":2,"halt_if":"open","halt_if_type":"str","halt_if_compare":"is","entity_id":"cover.ratgdo","state_type":"str","blockInputOverrides":false,"outputProperties":[{"property":"payload","propertyType":"msg","value":"","valueType":"entityState"},{"property":"data","propertyType":"msg","value":"","valueType":"entity"}],"for":0,"forType":"num","forUnits":"minutes","x":550,"y":300,"wires":[["c772d2ec.4b0e6"],[]]},{"id":"c772d2ec.4b0e6","type":"function","z":"b767f94fe7c1f884","name":"Calculate minutes","func":"var minutes = flow.get('minutes');\nif (minutes == 1) {\n minutes = 0;\n} else {\n\tminutes += 30;\n}\nflow.set('minutes', minutes);\n// make it part of the outgoing msg object\nmsg.minutes = minutes;\nreturn msg;","outputs":1,"noerr":0,"initialize":"","finalize":"","libs":[],"x":760,"y":250,"wires":[["1cfa7770.a38049"]]},{"id":"1cfa7770.a38049","type":"switch","z":"b767f94fe7c1f884","name":"30 minute alerts","property":"minutes","propertyType":"flow","rules":[{"t":"gt","v":"1","vt":"str"}],"checkall":"true","repair":false,"outputs":1,"x":980,"y":300,"wires":[["12b38de21a3742f9","51d3a9fc5369cf50"]]},{"id":"51d3a9fc5369cf50","type":"subflow:6dc0247c.d7210c","z":"b767f94fe7c1f884","name":"","env":[{"name":"service","value":"mobile_phones","type":"str"},{"name":"title","value":"Garage Door STILL OPEN","type":"str"},{"name":"message","value":"The garage door has been open for {{minutes}} minutes","type":"str"},{"name":"action1Title","value":"Close it","type":"str"},{"name":"action2Title","value":"open HA","type":"str"},{"name":"action2Uri","value":"/lovelace/0","type":"str"},{"name":"userInfo","type":"bool","value":"true"},{"name":"group","value":"garage","type":"str"},{"name":"timeout","value":"180","type":"num"},{"name":"channel","value":"garage","type":"str"}],"x":860,"y":450,"wires":[["9ee8f8b2aebc63ba"]]}]

(yes I know the 30 minute timer is currently only 1 minute long, did that for testing purposes)
Thanks so much for your quick response

[Takore2002]

This is probably one of my most used nodes in Home Assistant so thank you!

Do you have any ideas on how I can generate multiple messages from a single trigger event without the messages overwriting each-other?

I've modified it fairly heavily so I can use nodes earlier in the flow to dynamically change different fields like the services/title/message/etc. I recently ran into an issue where I'm trying to trigger multiple messages off of one trigger event.

[RickTorresJr]

Is it possible to get an example of setting the overrides via a Function node? I'm having trouble mapping the actions portion. Thanks.

msg.actionable = {
  title: "override this title",
  message: "override this message",
  
  data: {
    color: "red",
    sticky: "true?",
    "actions": [
        1,
        {
            "title": "title 1"
        }
    ]
  }
};
return msg;

[zachowj]

As it is currently written you are unable to override actions.

[RickTorresJr]

Thank you for the reply. I apologize but I guess I have a misunderstanding of overrides in Node-Red or I'm missing something.

The Cookbook says Any setting can be set or overwritten using msg.actionable to pass a notification object into the node. I'm just trying to pass in the values via msg.actionable depending on the situation. The array syntax is the one giving me problems. It works but in my example above title 1 is intended to the the first action but is placed as the second. I'm looking for an example of the correct syntax for 3 actions.

#311 (reply in thread)

[jsbrich]

Noticed today that I haven't been getting any notifications on things that go through this subflow. I don't get a lot of them, so I'm not exactly sure when it stopped or what all has been updated lately. When I open the subflow template, under the "create service call" function, it is showing some errors. Are these normal?
Lines 17 and 18 have this

Line 43:

Line 44:

Line 62:

[rossco555]

Yeah, Node Red doesn't seem to think it supports those operators... but it does from my experience and I see those to and don't have issues. I don't think these are the source of your problem.

[jsbrich]

So I added debugs to the subflow

When a send is triggered, Debug 4 shows msg, it doesn't contain msg.clear_notifications as expected. Debug 5 is triggered, same message as 4. But that's it. Debug 2 doesn't show anything like I would expect. But no error that I can find.

[rossco555]

Why don't you expect debug 2 to show anything? Did you set the debugs up to show the complete message, not just "message"?

[jsbrich]

I switched to the whole message. When a message is triggered, I see some values in the payload object of data I populate in the parent flow in Debug 4 and 5, but Debug 2 is never triggered. Which, to me indicates something is going wrong in the "create service call" box, but I don't see any error messages or anything in the debug window

[jsbrich]

I figured it out, updating from Node.js 14 to 20 resolved the issue. I'm not sure why it just suddenly stopped working before, but it seems to be good now.

[LikeableHades]

How would I change the title on the fly for a notification? I have tried

msg.actionable = { title: "override this title", message: "override this message", }; return msg;

In a function node immediately prior to the notification node, but no luck.

[zachowj]

What you have works for me. Are you sure you're running the current subflow linked at the top?

[LikeableHades]

Just remade the subflow with a copy of what's above, and that did fix it. Odd. Not sure where I got the other subflow code from, then.

[LikeableHades]

What you have works for me. Are you sure you're running the current subflow linked at the top?

Is there a way to get a separate notification per channel? I'm trying to have just one flow that detects my lights, and if they are on for more than 15 minutes, send a notification to let me turn them off. But, if I turn on multiple lights, the latest notification overrides all others.

[vaderag]

Just noticed this had stopped working for me - I use it for a flow that triggers when I go on holiday and when I went on holiday I got no notification

I assume this is due to the way that notifications changed in HA recently, but I'm not quite sure - I don't see a new version on the main page tho so can anyone help me to understand how to fix this?!
From what I can tell it's the notification portion that is failing

[zachowj]

It is still working on the latest release of HA, 2024.6.0

[vaderag]

It is still working on the latest release of HA, 2024.6.0

Hmm okay, strange. Bit more digging and it seems related to my notification group not working.

[teek541]

One thing I noticed, the node takes the actionIDs and stores them as flow variables. This used to get stored in the primary flow where I called this node, but I'm not seeing it there anymore. Anyone else realize this? It's affecting some of my notifications.

[Destix]

Is it only me, or was anyone else getting the "ValidationError: 'service' is required" ?

I fixed it by changing the create service call node from this:

services.trim().split(/,\s*/).forEach(service => {
    if(!service) return;
    msg.payload = {
        action: `notify.${service}`,
        data,
    };
    node.send(msg);
});

to this:

services.trim().split(/,\s*/).forEach(service => {
    if(!service) return;
    msg.payload = {
        service,
        data,
    };
    node.send(msg);
});

[zachowj]

The action property is for the current version of the HA nodes and service has been deprecated.

[dagreen86]

I get this error too but I'm running 2024.8.2, so doesn't make sense to me that action doesn't work.

[zachowj]

That's the version of Home Assistant not the version of this package. The latest version of this package is v0.68.9 https://github.com/zachowj/node-red-contrib-home-assistant-websocket/releases

You can find the version of this package in use under the manage palette in Node-RED or using the diagnostic button https://zachowj.github.io/node-red-contrib-home-assistant-websocket/guide/diagnostics.html

[dagreen86]

Thanks for the explanation. I was able to update to the latest package and it works! Awesome

[jj-uk]

Is the code on the main page the latest? Comment says v1.1.0, comment in the code says 1.0.2.
https://zachowj.github.io/node-red-contrib-home-assistant-websocket/cookbook/actionable-notifications-subflow-for-android.html

[jj-uk]

doesn't work for me. Cannot select which phone to send the notification to. Jason is the default, and nothing else can be selected.

[zachowj]

Click on "Edit Subflow Template" to modify the Notify Service field and adjust it to match your setup.

[jj-uk]

Thanks for the help, it's now working.

One thing that I noticed doesn't work is notification icon on Android phone.
https://companion.home-assistant.io/docs/notifications/notifications-basic#notification-status-bar-icon
To fix this, "icon" needs to changed to "notification_icon" in the template's field.

I also added "icon_url" which allows a small image (100x100px) to be displayed next to the notification.
https://companion.home-assistant.io/docs/notifications/notifications-basic#notification-icon

then in the "create service call" object, add/edit the following:

Then use these in the flow:

/media/local/ is the 'media' folder in home assistant
https://www.home-assistant.io/integrations/media_source/#local-media

Hopefully these changes can be added to your master code.

[rlyons20]

I'm using this to notify a specific person, based on which phone triggers the alert. It was previously working, but the changes to the input node seem to have broken the setup I had. Basically, I need to use the name of the person/device from the trigger to dynamically set the notify target. Here's what I had that worked:

[maartenvsco]

Hello,
Everything seems to work but I get a warning about Action notify not found?

[jj-uk]

Same as this?
#311 (reply in thread)

[maartenvsco]

Don't think so, I think the notify action does not exist anymore, it seems to be called notify.send_message now?

[jj-uk]

Is that actionable notification?

[maartenvsco]

Yes

[maartenvsco]

Hmm, but now I got an warning on that as well: