Notify_onesignal

OneSignal Notifications

• Source: https://onesignal.com
• Icon Support: Yes
• Message Format: Text
• Message Limit: 32768 Characters per Message

Account Setup

1. Visit https://onesignal.com to create your account.
2. To acquire your {appid} and {apikey} Clic on the Keys and IDs.
   

Syntax

The syntax is as follows:

• onesignal://{app_id}@{apikey}/#{include_segment}
• onesignal://{app_id}@{apikey}/#{include_segment1}/#{include_segment2}/#{include_segmentN}
• onesignal://{app_id}@{apikey}/{player_id}/
• onesignal://{app_id}@{apikey}/{player_id1}/{player_id2}/{player_idN}
• onesignal://{app_id}@{apikey}/@{user_id}/
• onesignal://{app_id}@{apikey}/@{user_id1}/@{user_id2}/@{user_idN}
• onesignal://{app_id}@{apikey}/{email}/
• onesignal://{app_id}@{apikey}/{email1}/{email2}/{emailN}

You can also mix/match the targets:

• onesignal://{app_id}@{apikey}/{email}/@{user_id}/#{include_segment}/{player_id}

If you defined a template with OneSignal, you can use it as well:

• onesignal://{template_id}:{app_id}@{apikey}/#{include_segment}
• onesignal://{template_id}:{app_id}@{apikey}/#{include_segment1}/#{include_segment2}/#{include_segmentN}
• onesignal://{template_id}:{app_id}@{apikey}/{player_id}/
• onesignal://{template_id}:{app_id}@{apikey}/{player_id1}/{player_id2}/{player_idN}
• onesignal://{template_id}:{app_id}@{apikey}/@{user_id}/
• onesignal://{template_id}:{app_id}@{apikey}/@{user_id1}/@{user_id2}/@{user_idN}
• onesignal://{template_id}:{app_id}@{apikey}/{email}/
• onesignal://{template_id}:{app_id}@{apikey}/{email1}/{email2}/{emailN}

Parameter Breakdown

Variable	Required	Description
app_id	Yes	This is the Application ID associated with your OneSignal account.
apikey	Yes	This is the API Key associated with your OneSignal account.
template_id	No	The UUID Template ID you wish to use
player_id	No	A Player ID to notify
user_id	No	A User ID to notify. Note: these must be prefixed with an @ symbol or it will be interpreted as a Player ID
include_segment	No	An include segment. Note: these must be prefixed with an # symbol or it will be interpreted as a Player ID
email	No	An email to notify.
subtitle	No	The subtitle of your push. Only appears on iOS devices.
language	No	The 2 character language code to push your message as. By default this is set to en if not specified.
image	No	to include the icon/image associated with the message. By default this is set to yes.

Example

Send a OneSignal notification to all devices associated with a project:

# Assume:
#  - our {app_id} is abc123
#  - our {apikey} is a6k4ABnck26hDh8AA3EDHoOVdDEUlw3nty
#  - our {player_id} is 3456-2345-a3ef
apprise -vv -t "Test Message Title" -b "Test Message Body" \
   onesignal://abc123@a6k4ABnck26hDh8AA3EDHoOVdDEUlw3nty/3456-2345-a3ef

# Override the subtitle (Mac users only) by doing the following:
# You must use URL encoded strings, below the spaces are swapped with %20
apprise -vv -t "Test Message Title" -b "Test Message Body" \
   onesignal://abc123@a6k4ABnck26hDh8AA3EDHoOVdDEUlw3nty/3456-2345-a3ef?subtitle=A%20Different%20Subtitle