Skip to content

Pushover

The Pushover modules allow you to send messages and interact with the Pushover API.

Getting Stared with Pushover

Prerequisites

  • A Pushover account

  • A valid device

  • A registered application

In order to use Pushover with Ibexa Connect, you must have a Pushover account. If you do not have one, you can create one at pushover.net.

Note

The module dialog fields that are displayed in bold (in the Ibexa Connect scenario, not in this documentation article) are mandatory!

Connecting Pushover to Ibexa Connect

To connect your Pushover account to Ibexa Connect, you need your User Key and an API Token.

  1. Log in to your Pushover account.

  2. You can find your User Key on the homepage.

    pushover_1.png

  3. To obtain an API Token, you must register an application. Scroll to the bottom of the page and click Create an Application/API Token.

    pushover_2.png

  4. Configure the application how you'd like. Click Create Application.

  5. Go to your newly created application to find the API Token.

  6. In Ibexa Connect, choose the Pushover module you want to use. Next to Connection, click Add.

  7. Enter your User Key and API Token in the respective fields.

  8. Click Save.

You have established the connection.

Actions

Send a Message

Sends the written message to your pushover devices.

Message

Enter the body of your message. Messages are currently limited to 1024 characters.

Title

Enter the title of your message. The title is currently limited to 250 characters.

If you don't specify a title, the application's name will show by default.

HTML

Select whether to format your message with HTML tags. If Yes, the normal message content in your message parameter will display as HTML. May not be used together with monospace.

Monospace

Select whether to enable monospace messages. May not be used if html is used, and vice versa.

Device

Choose the name of one of your devices to send just to that device, instead of all devices.

URL

Enter a supplementary URL to show with your message.

URL Title

Enter a title for the URL specified as the url parameter, otherwise just the URL is shown.

Timestamp

Enter a timestamp to show to the message receiver. See the list of supported date and time parameters.

Note

In some cases, such as when messages have been queued on a remote server before reaching the Pushover servers, or delivered to Pushover out of order, this default timestamping may cause a confusing order of messages when viewed on the user's device. For these scenarios, your app may send messages to the API with the timestamp parameter set to the time of the original message.

Priority

Select the priority of your message and how the message is presented to the receiver.

  • No Notification / Alert

    Considered the lowest priority and does not generate any notification.

  • Send as a Quiet Notification

    Considered low priority and does not generate any sound or vibration, but still generates a popup/scrolling notification depending on the client operating system.

  • Default User's Settings

    Messages trigger sound, vibration, and display an alert according to the user's device settings.

  • Bypass User's Quiet Hours

    High priority messages that bypass a user's quiet hours. These messages will always play a sound and vibrate (if the user's device is configured to) regardless of the delivery time.

  • Repeat Until the User has Acknowledged

    Similar to high-priority notifications, but they repeat until the notification is acknowledged by the user.

Sound

Select the sound to play when receiving notifications, rather than the standard Pushover tone. You can sample the full list o available sounds here.

File

Choose whether to add any attachments to your message.

Make an API Call

Performs an arbitrary authorized API call.

URL

Enter a path relative to https://api.pushover.net. For example: /1/users/validate.json

For the list of available endpoints, refer to the Pushover API Documentation.

Method

Select the HTTP method you want to use:

GET to retrieve information for an entry.

POST to create a new entry.

PUT to update/replace an existing entry.

PATCH to make a partial entry update.

DELETE to delete an entry.

Headers

Enter the desired request headers. You don't have to add authorization headers; we already did that for you.

Query String

Enter the request query string.

Body

Enter the body content for your API call.

Example of Use - List Users

The following API call returns all the users from your Pushover account:

URL: /1/users/validate.json

Method: POST

pushover_3.png

Matches of the search can be found in the module's Output under Bundle > Body. Our example returned 1 user:

pushover_4.png