# Pushover Binding
![](/logos/pushover.png)
The Pushover binding allows you to notify mobile devices of a message using the Pushover REST API (opens new window). To get started you first need to register (a free process) to get an API token. Initially you have to create an application, set its name and optionally upload an icon, and get the API token in return. Once you have the token, you need a user key (or group key) and optionally a device name for each user to which you want to push notifications.
# Supported Things
There is only one Thing available - the pushover-account
.
You are able to create multiple instances of this Thing to broadcast to different users, groups or devices.
# Thing Configuration
Configuration Parameter | Type | Description |
---|---|---|
apikey | text | Your API token / key (APP_TOKEN) to access the Pushover Message API. mandatory |
user | text | Your user key or group key (USER_KEY) to which 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 notification sound on target device (default: default ) (see supported notification sounds (opens new window)). This list will be populated dynamically during runtime with 21 different sounds plus user-defined custom sounds (opens new window). |
retry | integer | The retry parameter specifies how often (in seconds) the Pushover 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 |
timeout | integer | The timeout parameter specifies maximum number of seconds a request to Pushover can take. advanced |
The retry
and expire
parameters are only used for emergency-priority notifications.
# Channels
Currently the binding does not support any Channels.
# Thing Actions
All actions return a Boolean
value to indicate if the message was sent successfully or not.
If the communication to Pushover servers fails the binding does not try to send the message again.
One has to take care of that on its own if it is important.
The parameter message
is mandatory, the title
parameter defaults to whatever value you defined in the title
related configuration parameter.
Parameters declared as @Nullable
are not optional.
One has to pass a null
value if it should be skipped or the default value for it should be used.
sendMessage(String message, @Nullable String title, @Nullable String sound, @Nullable String url, @Nullable String urlTitle, @Nullable String attachment, @Nullable String contentType, @Nullable Integer priority, @Nullable String device)
- This method is used to send a plain text message providing all available parameters.sendMessage(String message, @Nullable String title)
- This method is used to send a plain text message.sendHtmlMessage(String message, @Nullable String title)
- This method is used to send a HTML message.sendMonospaceMessage(String message, @Nullable String title)
- This method is used to send a monospace message.sendAttachmentMessage(String message, @Nullable String title, String attachment, @Nullable String contentType)
- This method is used to send a message with an attachment. It takes a local path or URL to the attachment (parameterattachment
mandatory). Additionally you can pass a data URI scheme to this parameter. Optionally pass acontentType
to define the content-type of the attachment (default:image/jpeg
or guessed from image data).sendURLMessage(String message, @Nullable String title, String url, @Nullable String urlTitle)
- This method is used to send a message with an URL. A supplementaryurl
to show with the message and aurlTitle
for the URL, otherwise just the URL is shown.sendMessageToDevice(String device, String message, @Nullable String title)
- This method is used to send a message to a specific device. Parameterdevice
mandatory is the name of a specific device (multiple devices may be separated by a comma).
The sendPriorityMessage
action returns a String
value (the receipt
) if the message was sent successfully, otherwise null
.
sendPriorityMessage(String message, @Nullable String title, @Nullable Integer priority)
- This method is used to send a priority message. Parameterpriority
is the priority (-2
,-1
,0
,1
,2
) to be used (default:2
).
The cancelPriorityMessage
returns a Boolean
value to indicate if the message was cancelled successfully or not.
cancelPriorityMessage(String receipt)
- This method is used to cancel a priority message.
# Full Example
demo.things:
Thing pushover:pushover-account:account [ apikey="APP_TOKEN", user="USER_KEY" ]
demo.rules:
val actions = getActions("pushover", "pushover:pushover-account:account")
// send HTML message
actions.sendHtmlMessage("Hello <font color='green'>World</font>!", "openHAB")
val actions = getActions("pushover", "pushover:pushover-account:account")
// send message with attachment
actions.sendAttachmentMessage("Hello World!", "openHAB", "/path/to/my-local-image.png", "image/png")
actions.sendAttachmentMessage("Hello World!", "openHAB", "https://www.openhab.org/openhab-logo-square.png", null)
actions.sendAttachmentMessage("Hello World!", "openHAB", "data:[<media type>][;base64],<data>", null)
// in case you want to send the content of an Image Item (RawType)
actions.sendAttachmentMessage("Hello World!", "openHAB", myImageItem.state.toFullString, null)
val actions = getActions("pushover", "pushover:pushover-account:account")
// send priority message
var receipt = actions.sendPriorityMessage("Emergency!!!", "openHAB", 2)
// wait for your cancel condition
if( receipt !== null ) {
actions.cancelPriorityMessage(receipt)
receipt = null
}
← Pushbullet Pushsafer →