The Xtify Notification Configuration API provides the capability to create, modify and activate/deactivate notification configurations via a web service, instead of using the Xtify Console. The Xtify Notification Engine will deliver the configured notifications to mobile application users according to the notification settings without having to create the configurations using the Console.
Using this web service will allow you to:
- Configure a notification, with at least a frequency and either one or more triggering locations or triggering schedules.
- Associate the notification to one or multiple mobile applications across the Android, iOS and BlackBerry platforms.
- Deliver the notification to all mobile users of the application(s) or to one or many specific mobile users of the application(s).
- Make modifications to existing notifications.
- Activate, deactivate and delete existing notifications.
- Retrieve the list of all notifications configured through the Notification Configuration API.
- Retrieve the details of a specific notification configuration.
Users of this API are able to make use of a triggering schedule without location, a triggering location without schedule and a triggering schedule used in tandem with a triggering location:
Using triggering schedule (no location): Notifications are delivered to the mobile users at a specific time and date in their time zone. The schedule should be set-up for a minimum period of 30 min.
- Using triggering schedule (no location): Notifications are delivered to the mobile users at a specific time and date in their time zone. The schedule should be set-up for a minimum period of 30 min.
- Using triggering location & schedule: Notifications are delivered to the mobile users when they are within the specified radius of the location(s) and within the specified schedule(s).
- Using triggering location (no schedule): Notifications are delivered to the mobile users when they are within the specified radius of the location, anytime the device sends a location update.
Data passed to the Notification Configuration Engine via this web service will not be available for the configuration of other notifications via the Xtify Console or this web service via a subsequent call. That is, preconfigured locations, schedules and messages cannot be re-used. Data configured in the Console will not be available for use when using this web service.
However, previously submitted web service calls can be modified by sending subsequent web service calls with updated configurations along with the original ID on the request.
In the Console, at the Configured Notifications Manager tab, the notifications configured using this web service can be viewed in a non-editable format, but can be deleted and activated/de-activated. The user will not be allowed to make any changes to the notifications themselves.