Overview Push message Pushover



This function block sends push notifications via the Pushover service to the Pushover app (iOS, Android, desktop). Pushover supports titles, priorities (e.g. emergency with repeated delivery until acknowledged), different sounds and sending to individual devices.

Setup:

iOS app Download

Android app Download



Inputs

TR
 Trigger
 Trigger on which the message is sent. See parameter Trigger.
WT / W1..W8
 Value
 Optional values. Values can be linked here that are inserted into the title or the message. The placeholder %1 in the title or message is replaced by the value of the first value input, %2 by the second one and so on. The number of value inputs is set via the parameter Input count. The formatting depends on the data type of the linked address (integer, floating point number or string); if no address is linked, floating point is used.

Outputs
FE
 Error
 Number of errors.
AZ
 Count
 Number of messages sent.
FT
 Filter
 Remaining filter time in seconds. After a message has been sent, this output counts down from the time set in the Filter parameter to 0. As long as the value is greater than 0, no further messages are sent.

Parameters
Trigger
  • Rising edge: The message is sent on 0-1.
  • Falling edge: The message is sent on 1-0.
  • Telegram 0: The message is sent on a telegram with value 0.
  • Telegram 1: The message is sent on a telegram with a value not equal to 0.
  • Value change: Monitoring of the trigger input. The message is sent on every change of the value at the input TR, this also applies to numeric and text values. Telegrams with an unchanged value do not send a message. During the first 10 seconds after the start of the controller only the initial values are taken over, so no message is sent. Cyclic sending is not possible with this setting.
User key
 User key of the Pushover account. Shown on pushover.net after logging in. Several keys can also be entered separated by spaces or semicolons; the message is then sent to all of the specified recipients.
Title
 Optional title of the message. If this parameter is empty, the name of the application belonging to the API token is shown.
Message Message to be sent. A line break can be inserted with \n.
Priority
 Priority of the message.
  • Lowest (-2): No notification, only shown in the app.
  • Low (-1): Notification without sound.
  • Normal (0): Normal notification.
  • High (1): The notification bypasses the recipient's quiet hours.
  • Emergency (2): The notification is repeated every minute (for a maximum of 1 hour) until it is acknowledged by the recipient.
Sound
 Notification sound. With Default, the sound configured in the Pushover app is used.
Device
 Optional device name from the Pushover account. If this parameter is empty, the message is sent to all devices of the account, otherwise only to the specified device.
URL
 Optional URL shown with the message. It does not have to be a web address: if the URL scheme of an app is entered, tapping the link launches that app directly. See section Launching an app via the URL.
URL title
 Optional title for the URL. If this parameter is empty, the URL itself is shown.
E-mail
 Optional e-mail address. If this parameter is filled in, the same message is also sent as an e-mail to this address in parallel to the push notification. Several addresses can be entered separated by semicolons. The SMTP server from the project's mail server configuration is used. If the parameter is left empty, no e-mail is sent.
Filter
 Waiting time in seconds until the next message is sent (default 300 seconds). After a message has been sent, further messages are discarded for this time. The output FT Filter shows the remaining time.
Send cyclically
 If this option is enabled, the message is sent cyclically as long as the trigger condition is present. With a rising edge this means the message is sent repeatedly as long as the input is 1, with a falling edge as long as the input is 0. With the setting value change there is no condition present, therefore the parameter is not shown.
Cycle time
 Time in minutes for cyclic sending, minimum 15 minutes. This parameter is only shown when cyclic sending is enabled.
Input count
 Number of value inputs (1 to 8, default 1) for the placeholders %1 to %8.

The placeholders %1, %2 and so on can be used in both the title and the message. They are replaced by the values of the value inputs, %1 by the first value input, %2 by the second one and so on. For example, the message "Error sensor above %1 degrees" becomes "Error sensor above 50 degrees". The formatting depends on the data type of the linked address; if no address is linked, floating point is used.

Launching an app via the URL: The URL parameter does not necessarily expect a web address. If the URL scheme of an app is entered instead, tapping the link in the Pushover message opens that app directly. The scheme for the uni-PRO APP is unipro:// (equivalent to pt2020pro://). This allows, for example, a doorbell message to be set up so that tapping it immediately opens the visualisation. With unipro://page/Frontdoor a specific page is opened right away, optionally on a different installation - see Opening the APP via an address. Other apps use their own respective scheme.

The app must be installed on the device, otherwise nothing happens when the link is tapped. On Android this requires APP version 2.3130 or later; on iOS no minimum version is required. A title for the link is set via the URL title parameter.

Limit: The number of messages is limited per hour and per day. This limit is fixed in the controller, applies to all Pushover function blocks together and protects against unintended continuous sending (e.g. caused by a bouncing input). If the limit is exceeded, the message is discarded, the output FE Error is incremented and an error message is written to the debug log.

See also the common parameters of all function blocks.