Page tree
Skip to end of metadata
Go to start of metadata

Push Notifications allow drivers to be automatically and immediately informed of changes affecting their jobs, which have been made in the CartonCloud web app (e.g. by an Admin adding a new job onto a driver).

Supported App Versions

  • iOS: >1.2.7
  • Android: >4.1.3

How Push Notifications Are Displayed

The way push notifications are displayed on the mobile devices depends on the state of the CartonCloud app at the time of receiving the notification.

  • The app is open, showing the job list
    A drop-down info bar will be displayed upon receiving a notification and the job list will be refreshed automatically.

    If you are using an Android device and do not see the a drop-down info bar upon receiving a push notification (only a CartonCloud icon in the notification bar), you may have to enable "Heads up" notifications in your device's Notification settings (see "Enabling Push Notifications" below for more information).

    iOSAndroid

  • The app is open, not showing the job list (e.g. recording a POD)
    On iOS devices a drop-down info bar will be displayed upon receiving a notification (whereas on Android devices the CartonCloud logo will appear in the notification bar) but the job list will NOT be refreshed automatically. This is to prevent interferences while using the app to record PODs, lodge errors etc. Upon returning to the job list, it will automatically be refreshed.

    iOSAndroid

  • The app is running in the background
    The device will show a standard notification informing the user that the CartonCloud app has received a notification. Upon tapping on the notification (or swiping if in lock screen on iOS), the CartonCloud app will be opened and the job list automatically refreshed. 

    iOSAndroid

  • The app is closed
    The device will show a standard notification informing the user that the CartonCloud app has received a notification. Upon tapping on the notification (or swiping if in lock screen), the CartonCloud app will be opened and the job list automatically refreshed. 
    (displayed same as above, app running in the background)


Once notifications have been received, they can be viewed in the Notifications View, which can be accessed via slide-in menu within the app (button in top left corner). This view gives the driver some more information about affected jobs and allows direct access to the Consignment Detail View if the job is available in the job list.




Trigger Events

Not all actions performed in the web app trigger notifications to avoid spamming the drivers and to keep pushed information relevant.

Changes that trigger a notification being sent to a driver include:

  • Adding a job: The driver the job has been added to will be notified. Also, if the job was previously assigned to a different driver, this driver will also be notified about the job having been removed from their list.
  • Removing a job: The driver the job has been removed from will be notified. Also, if the job has been re-assigned to a different driver in the process, this driver will also be notified about the job having been added to their list.
  • Modifying a job: A notification will be sent to the assigned driver.
    • Addresses: If an address that affects a job does get modified in the system. For example, the delivery address of a delivery job, the pickup address of a pickup job or either the pickup or delivery address of a point-to-point job.
    • Quantities: A change in quantities, e.g. the number of pallets or cartons in a Consignment.
    • COD Value: Modified Cash On Delivery value.
    • Special instructions: Modified special instructions text.

Only changes on jobs that are in the driver's current job list (or will be part of it once added) trigger notifications. This means for example that drivers will not be informed about changes to completed deliveries.

Moreover, if a change affects multiple Consignments (e.g. when changing the driver assigned to a run sheet), notifications will be bundled as to not overwhelm the driver with notifications. All details of bundled notifications can still be viewed in the Notifications view within the app.

Enabling Push Notifications

A driver can choose to receive notifications or (temporarily) disable them. This prevents drivers from receiving notifications while not working, for example as adjustments get made overnight.

There are 3 conditions that need to be fulfilled for a driver to receive notifications:

  1. Notifications enabled on the mobile device
    iOS: On first starting up the app after installing it or after an update from a version prior to 1.2.7, the app will automatically request access to Notifications on the device. This setting can be modified at any stage, either by seeking out the CartonCloud app settings in the device settings (Settings > Notifications > CartonCloud > Notifications) or by using the shortcut button provided in the Settings view within the CartonCloud app.
    If notifications are disabled for the CartonCloud app no notifications will be received, irrespective of whether the user is logged in and clocked in. 


    Android: On first starting up the app after installing it or after an update from a version prior to 4.1.3, the app will automatically be given access to Notifications. This setting can be modified at any stage, either by seeking out the CartonCloud app settings in the device settings (Settings > Apps / App Manager > CartonCloud) or by using the shortcut button provided in the Settings view within the CartonCloud app. For more fine-grain adjustments to Notifications, go to Settings > Notifications > CartonCloud on your device. Additionally, if you are not seeing drop-down info bars ("Heads Up" Notifications) when receiving a Push Notification while using the app, ensure that this setting is enabled in Settings > Notifications.
    If notifications are disabled for the CartonCloud app no notifications will be received, irrespective of whether the user is logged in and clocked in. 

    Settings > Apps / App Manager > CartonCloudSettings > Notifications > CartonCloudSettings > Notifications

  2. Logged in
    The driver needs to be logged in to receive notifications. On logout, no more notifications will be sent to the device until all conditions are fulfilled again.


  3. "Clocked on" - going online / offline IMPORTANT: MAKE SURE YOU ARE CLOCKED ON TO RECEIVE NOTIFICATIONS - THEY DON'T WORK IF YOU'RE CLOCKED OFF.
    A driver may choose to log into the app to check their job list but decide not to receive notifications at this particular time. To allow for this case, a driver needs to specifically choose to receive notifications while using the app by activating the "Clock On" button in the top right corner of the main view. On clocking off, no more notifications will be sent to the device until all the conditions are fulfilled again.

    iOSAndroid

Disabling Push Notifications

If any of the conditions described under Enabling Push Notifications are not fulfilled, no notifications will be sent out to the driver's device. This means Push Notification can simply be disabled by selecting the "Clock Off" button in the top right corner, as described above.

Sharing Devices

If a mobile device is shared between several drivers, only notifications that affect the driver that is currently logged into the CartonCloud app (and fulfils all the conditions under Enabling Push Notifications) will be sent to the device.

Multiple Devices

If a driver is logged into multiple devices at the same time, notifications will be sent to all their devices if the conditions under Enabling Push Notifications are fulfilled.

  • No labels