Pre-shift and on-shift tracking

Introduction

The HyperTrack Orders API lets you track shifts throughout their lifecycle.

Tracking the shift before its expected start time allows you to preemptively monitor risk of no-call-no-shows or delays. This allows you to take mitigating actions like checking if the worker is able to make it OR informing the client of a late arrival OR finding a replacement worker if needed.

Tracking a shift while it is in progress allows you to understand how much time the worker spends at the destination and get automated updates if the worker exits the destination. All the entry and exits to the destinations are captured to help understand how much time the worker actually spent on site and when they finally left.

Both pre-shift and on-shift tracking come with HyperTrack's automated location outage reporting where we notify you if the worker's location is unavailable with actionable outage reasons so you can increase your tracking rates.

Worker Setup

To automatically track shifts using HyperTrack you must first complete your worker setup as described here.

📘

The worker app setup must integrate silent push notifications for iOS and Android. HyperTrack uses a combination of silent push notifications and sync method on the SDK to ensure that tracking starts and stops on the worker device as expected.

Pre-shift tracking

To track pre-shift risks you can call the HyperTrack Orders API tracking endpoint. Based on your business logic, you can define how much in advance of the shift start time, you should start tracking the shift.

A few key important parameters you should keep in mind for pre-shift tracking are listed below:

• Use your unique shift identifier like a shift_id to set the HyperTrack order_handle. This enables you to link shifts in your system to orders tracked in HyperTrack.
• Use the shift start time to set scheduled_at in HyperTrack. This defines the target time based on which HyperTrack will estimate delay risks using the worker live location and live traffic.
• Use the shift duration as the expected_service_time for the order. Note HyperTrack does not automatically close the order based on this parameter, but uses it as a reference.
• Use polygon geofences if available for the order destination. If polygons are not available, you can use radial geofences and improve them over time. For recurring work places, create places in HyperTrack and use the geofence_id as the order destination to auto-generate place intelligence.
• To generate delay risks based on the scheduled_attime, destination, worker live location and real time traffic based ETA set track_mode as on_shift
• Use order metadata for key shift parameters to sort/filter/query data as needed.

The screenshot below shows the HyperTrack UI with the timeline of a shift that had a significant pre-shift tracking outage and ultimately arrived late. As you can see the shift is scheduled for 1pm and tracking started at 11:30am to monitor pre-shift risks. The worker was in a tracking outage for 1h 44mins after tracking starts because the App was unreachable by server and ultimately arrive 26 minutes and 45 seconds late.

Note that you can embed this view in your dashboard or use the webhooks for significant shift updates to incorporate key risks and updates in your own control tower.

On-shift tracking

To track on-shift risks you can call the HyperTrack Orders API tracking endpoint .

Based on your business logic and worker experience, you can decide when to start on-shift tracking. For instance, if a shift is scheduled to start at 9am - you can consider automatically starting tracking the shift at the expected start time. Alternatively, if your workers are expected to clock-in at the start of a shift, then you may use that as the event to start tracking.

A few key important parameters you should keep in mind for on-shift tracking are listed below:

• Use your unique shift identifier like a shift_id to set the HyperTrack order_handle. This enables you to link shifts in your system to orders tracked in HyperTrack.
• Use the shift start time to set scheduled_at in HyperTrack. Note for on-shift tracking we do not compute delays since the assumption is that work has already commenced.
• Use the shift duration as the expected_service_time for the order. Note HyperTrack does not automatically close the order based on this parameter, but uses it as a reference.
• Use polygon geofences if available for the order destination. If polygons are not available, you can use radial geofences and improve them over time. For recurring work places, create places in HyperTrack and use the geofence_id as the order destination to auto-generate place intelligence.
• To track all geofence entry/exits and time spent inside the geofence based on the set track_mode as on_shift
• Use order metadata for key shift parameters to sort/filter/query data as needed.

The screenshot below shows the HyperTrack shift timeline for on-shift tracking. As you can see the worker reached the destination and then exited the workplace multiple times. Exits are captured in the timeline and in this case the first exit was at 5:16pm and the following entry was at 6:29pm showing the worker was outside the work place for 1 hour 13 mins.

As with any timeline view, you embed this view in your dashboard or use the webhooks to incorporate significant timeline updates in your own control tower.

Add clock-in/out tags to your shift timeline

To add clock-in/out geotags to your shift timeline and track deviations from the expected locations please refer to this section.

Managing Shifts

You can manage shifts using the following operations of the Orders API:

Retrieve a shift timeline

To retrieve a shift timeline you can use the GET Order Timeline endpoint with the order_handle. This will return the full order timeline payload as described in the API. Note - for real time updates it is recommended to listen to webhooks.

Complete or Cancel a shift

Complete or Cancel shifts by calling the related endpoint of the Orders API.

📘

Note once you complete or cancel the shift and the worker has no more shifts or work remaining to be tracked, HyperTrack will automatically stop tracking the worker's device. This requires you to integrate silent push notifications on iOS and Android.

Update a shift

Update existing shifts whenever you need to modify attributes such as destination, scheduled_at or metadata.

Get real-time shift status updates on webhooks

For real time shift updates it is recommended to listen to webhooks.

Additional Resources

• Customizing your views: HyperTrack offers you options that allow you to create customizations for your views. You can find the details here .
• Embedding views in your dashboards: To learn about embedding our views in your dashboards please refer here.

Questions?

Please do not hesitate to contact us with your questions and feedback.