Sending a New Message

To send a message to an app with registered devices, perform the following steps:

  • From the Dashboard, click on the name of the app you want to send a message to.
  • Click the Messages tab.
  • Click the + Send New Message button located under the messages list.

The Send Message page is where you will compose or edit your message before sending it to your registered devices.

Message Details

MessageDetails.png

This section is where you will compose the payload for your message.

Title

The title for your message, which will be displayed in the notification area. If the mode is set to 'Standard,' this will be sent along with the body as part of the message payload. If you are using the 'JSON' mode then this value is simply a useful way for you to label your message.

Mode

The type of AirBop message that you want to send. Choose from:

Standard

Choose this mode when you want to send a plain text message to your app. The payload will contain three strings: 'title', 'message', and 'url'. These correspond to the three entry fields on the Message Details web page.

JSON

Choose this mode when you want to send custom data to your apps. In this mode you will type JSON directly into the message body area of the Message Details.

Example

If you wanted to send the standard AirBop text mode message as custom JSON you would type the following JSON into the message body field:

{
    "title": "This is the message title",
    "message": "This is the body for the message. No surprise there.",
    "url": "http://www.airbop.com"
}

You can of course send any data as custom JSON, as long as you stay within the 4000 character limit:

{
    "team1": "FC Bayern Munich",
    "team2": "Manchester City F.C.",
    "score1": "2",
    "score2": "0"
}

Note: If you want help composing your JSON there are many helpful websites and editors available, such as Curious Concept’s JSON Formatter & Validator or the JSON Editor Online

Message

In Standard mode the message will make up the main text that will appear in the notification area.

Target URL

The URL that you want to display to your end users when they click on the notification.

Note: In 'Standard' mode the available fields correspond to the default suggested message implementation. However because AirBop gives developers complete control, you can do whatever you want with these values in your app. For more information on the default suggested implementation please see the sample AirBop Client

Device Targeting

Device targeting is only available on Pro or Advanced plans.

DeviceTargeting.png

This section allows to you to target specific devices based on information that was sent or calculated when the device was registered. Leaving fields blank will cause them to be ignored.

Language

Send the message only to devices whose default language matches the selected language. Targeting based on language will only work if the 'lang' parameter is passed to the AirBop servers when the devices is registered or updated.

Country

Send the message only to devices whose default country matches the selected country. The device’s country will be calculated by the AirBop servers based on an IP lookup if the 'country' parameter is not passed to the AirBop servers when the device is registered or updated.

State/Province

Allows you to target devices based upon the state or province they were in when they registered with AirBop. This setting is only valid for devices in Canada or the United States of America. It will automatically be calculated based on the IP address of the registering device, or can be set by the client if it passes the 'state' parameter when the device is registered or updated.

Near Address

For finer grained location based targeting you can send your message to devices close to a specific address. This is a free form field and will accept any reasonable address:

123 Bannatyne Ave, Winnipeg, MB, Canada

Or:

2 Macquarie Street  Sydney CBD NSW 2000, Australia

Address Radius

The radius (in kilometers) around the address where the message will be sent if the device was registered or updated within that radius. Note: One mile is approximately 1.6 kilometers.

Label

Only send to all devices with the specified label. This will be an exact match only. This is a 50 character string that can be used to ‘tag’ or ‘group’ devices. For example if you wanted to label devices registrations from tablets vs. phones you could label the phones: phone and the tablets: tablet, or standard and HD. Then you would be able to target each group separately.

GCM Settings

Dry Run

If enabled, this message will only be sent to the Google Cloud Messaging (GCM) servers. The GCM servers will not deliver the message to the devices. More information on the Dry run option can be found on the GCM Architectural Overview page. This can be useful as a way to verify your GCM settings or clean out potentially invalid or unused devices.

Delay While Idle

If enabled, the message will not be delivered to devices that are in the idle state. The GCM server will wait until the device is active in order to deliver the message.

Enable 'Time to Live' and 'Collapse Key'

Enables or disables the time to live and collapse key settings.

Time to Live

The length of time, in seconds, that the message will last on the GCM server if the device is offline. Once the time expires, the message will be removed from the GCM servers, even if it has not been delivered to all devices. More information about the time to live settings can found in the Google GCM documentation.

Collapse Key

A string used to group messages together when devices are offline. When offline devices come back online, only the last message sent with the same collapse key will be delivered to the device. More information on this setting can be found in Google’s developer documentation.

Example

If five messages are sent by AirBop using the collapse key "Collapse_me" while a device is offline, only the fifth message will be delivered when the device becomes active.

Schedule

Future date/time scheduling is only available on Pro or Advanced plans.

Schedule.png

Here you control when you want your message to be delivered. The available options are:

Save As Draft

Save the current message as a draft. The message will not be sent, but it will be stored so you can edit it in the future.

Now

Send the message as soon as the "Send Message Now" button is pressed. Note: AirBop will give you approximately 10 seconds after you hit the "Send Message Now" button to edit or delete the message before sending it.

Future Date / Time

Schedule the message so it will be sent at a future date and time.

Date / Time

The plain text date and/or time that you want the message to be sent. AirBop allows you to use many different formats for this setting. This setting must be at least 30 minutes in the future, and no further than one year in the future. Some examples are:

  • Wednesday
  • Midnight
  • Tomorrow at 5:00am
  • Friday at 10 pm
  • Fri Apr 06 00:00:00 PDT 2013
  • next Thursday at 3:30pm
  • February 14th, 2013

Time Zone

The time zone that will be used by the AirBop servers when sending the message. This time zone is only used for sending the message; the time zone of the device that receives the message has no impact on when it will be sent.

Recent Discussions

21 Aug, 2017 05:52 PM
21 Aug, 2017 01:46 PM
18 Aug, 2017 12:50 PM
17 Aug, 2017 12:09 PM
14 Aug, 2017 01:28 PM