The Pushsafer binding addon you can download and install by the openhab binding installer.
The Pushsafer binding allows you to notify mobile devices of a message using the Pushsafer API. To get started you first need to register (a free process) to get a Private Key. Initially you have to register a device with one of the client apps, to get a device id.
There is only one Thing available - the pushsafer-account
.
You are able to create multiple instances of this Thing to broadcast to different devices or groups with push-notification content and setting.
Configuration Parameter | Type | Description |
---|---|---|
apikey |
text | Your private-key to access the Pushsafer Message API. mandatory |
user |
text | Your username or email address to validate against the Pushsafer Message API. mandatory |
device |
text | Your device or group id to which device(s) you want to push notifications. mandatory |
title |
text | The default title of a message (default: "openHAB" ). |
format |
text | The default format ("none" , "HTML" or "monospace" ) of a message (default: none ). |
sound |
text | The default notification sound on target device (default: 1 ) (see supported notification sounds). |
vibration |
text | How often the device should vibrate. empty=device default or a number 1-3. |
icon |
text | The default notification icon on target device (default: 1 ) (see supported notification icons). |
color |
text | The color (hexadecimal) of notification icon (e.g. #FF0000). |
url |
text | URL or URL Scheme send with notification. |
urlTitle |
text | Title of URL. |
retry |
integer | The retry parameter specifies how often (in seconds) the Pushsafer servers will send the same notification to the user (default: 300 ). advanced |
expire |
integer | The expire parameter specifies how long (in seconds) your notification will continue to be retried (default: 3600 ). advanced |
confirm |
integer | Integer 10-10800 (10s steps) Time in seconds after which a message should be sent again before it is confirmed. (default: 0 ). advanced |
time2live |
integer | Time in minutes, after a message automatically gets purged (default: 0 ). advanced |
answer |
integer | 1 = enables reply to push notifications (default: 0 ). advanced |
The retry
and expire
parameters are only used for emergency-priority notifications.
Currently the binding does not support any Channels.
All actions return a Boolean
value to indicate if the message was sent successfully or not.
The parameter message
is mandatory, the title
parameter defaults to whatever value you defined in the title
related configuration parameter.
sendPushsaferMessage(String message, @Nullable String title)
- This method is used to send a plain text message.
sendPushsaferHtmlMessage(String message, @Nullable String title)
- This method is used to send a HTML message.
sendPushsaferMonospaceMessage(String message, @Nullable String title)
- This method is used to send a monospace message.
sendPushsaferAttachmentMessage(String message, @Nullable String title, String attachment, @Nullable String contentType, @Nullable String authentication)
- This method is used to send a message with an image attachment. It takes a local path or URL to the image attachment (parameter attachment
mandatory), an optional contentType
to define the content-type of the attachment (default: "jpeg"
, possible values: "jpeg"
, "png"
, "gif"
) and an optional authentication
for the given URL to define the credentials to authenticate a user if needed (default: ""
, example: "user:password"
).
sendPushsaferURLMessage(String message, @Nullable String title, String url, @Nullable String urlTitle)
- This method is used to send a message with an URL. A supplementary url
to show with the message and a urlTitle
for the URL, otherwise just the URL is shown.
sendPushsaferPriorityMessage(String message, @Nullable String title, @Nullable Integer priority)
- This method is used to send a priority message. Parameter priority
is the priority (-2
, -1
, 0
, 1
, 2
) to be used (default: 2
).
demo.rules
```java
val actions = getActions("pushsafer", "pushsafer:pushsafer-account:account")
// send message with attachment
actions.sendPushsaferAttachmentMessage("Hello World!", "openHAB", "/path/to/my-local-image.png", "png", null)
actions.sendPushsaferAttachmentMessage("Hello World!", "openHAB", "https://www.openhab.org/openhab-logo-square.png", "png", "user:password")
actions.sendPushsaferAttachmentMessage("Hello World!", "openHAB", "data:[<media type>][;base64],<data>", null, null)
// in case you want to send the content of an Image Item (RawType)
actions.sendPushsaferAttachmentMessage("Hello World!", "openHAB", myImageItem.state.toFullString, null, null)