pushover

Send notifications via Pushover during state runs.

Important

See Configuration for a description of available configuration parameters.

Example

pushover-message:
  pushover.post_message:
    - user: uQiRzpo4DXghDmr9QzzfQu27cmVRsG
    - token: azGDORePK8gMaC0QOYAMyEEuzJnyUi
    - title: Message from Salt
    - device: phone
    - priority: -1
    - expire: 3600
    - retry: 5
    - message: 'This state was executed successfully.'
saltext.pushover.states.pushover.post_message(name, user=None, device=None, message=None, title=None, priority=0, expire=None, retry=None, sound=None, api_version=1, token=None)[source]

Send a message to a Pushover user or group.

pushover-message:
  pushover.post_message:
    - user: uQiRzpo4DXghDmr9QzzfQu27cmVRsG
    - token: azGDORePK8gMaC0QOYAMyEEuzJnyUi
    - title: Message from Salt
    - device: phone
    - priority: -1
    - expire: 3600
    - retry: 5
name

The name of the state. Irrelevant.

user

The user or group of users to send the message to. Must be a user/group ID (key), not a name or an email address. Required if not specified in the configuration.

message

The message to send to the Pushover user or group. Required.

title

The message title to use.

device

The name of the device to send the message to.

priority

The priority of the message (integers between -2 and 2). Defaults to 0.

Note

Emergency priority (2) requires expire and retry parameters to be set.

expire

Stop notifying the user after the specified amount of seconds. The message is still shown after expiry.

retry

Repeat the notification after this amount of seconds. Minimum: 30.

token

The authentication token to use for the Pushover API. Required if not specified in the configuration.