Multi-Device Workers

Workers often use different devices throughout their day. They might check their schedule on an iPad at home before heading out, then switch to their phone for deliveries. HyperTrack handles these transitions automatically so you don't lose visibility.

How It Works

When a worker has multiple devices, HyperTrack selects the best device for tracking based on proximity to the work destination. Tracking starts with the most recently used device. In the background, HyperTrack receives location updates from all candidate devices and uses these to determine when a different device is closer. This keeps ETAs and location updates accurate regardless of which device the worker is using.

To enable automatic device switching, set device_switch_mode to closest_to_destination when starting tracking an order:

POST /orders/track
{
  "worker_handle": "driver-jane",
  "device_switch_mode": "closest_to_destination",
  "orders": [...]
}

Device Switch Modes

Mode	When to Use
`closest_to_destination`	Workers may use multiple devices. HyperTrack picks the best one automatically.
`manual`	You want explicit control over which device tracks each route.
`login`	Device switches when the worker logs into a different device.

Active Device

The device_id field in API responses shows which device is currently being used for tracking. This is the device providing location updates, ETAs, and other tracking data.

{
  "route_handle": "route-abc123",
  "device_id": "00112233-4455-6677-8899-AABBCCDDEEFF",
  "device_switch_mode": "closest_to_destination",
  "candidate_devices": ["00112233-4455-6677-8899-AABBCCDDEEFF", "11223344-5566-7788-99AA-BBCCDDEEFF00", "22334455-6677-8899-AABB-CCDDEEFF0011"]
}

When device_switch_mode is set to closest_to_destination, the active device may change automatically as the worker moves closer to the destination with a different device. When set to login, device_id will switch based on last used device.

The candidate_devices array shows all devices available for the worker. These are devices that could potentially be used for tracking.

When a worker registers a new device, it's automatically added to the candidate list for any active routes.

Webhooks

Device Switched

Sent when HyperTrack switches tracking to a different device. See orders device switched payload.

{
  "type": "order",
  "data": {
    "value": "device_switched",
    "order_handle": "order-abc123",
    "route_handle": "route-abc123",
    "status": "ongoing",
    "previous_device_id": "00112233-4455-6677-8899-AABBCCDDEEFF",
    "new_device_id": "11223344-5566-7788-99AA-BBCCDDEEFF00"
  }
}

Candidate Devices Updated

Sent when a worker's available devices change. See route candidate device updated webhook.

{
  "type": "route",
  "data": {
    "value": "candidate_devices_updated",
    "route_handle": "route-abc123",
    "status": "tracking",
    "candidate_devices": ["00112233-4455-6677-8899-AABBCCDDEEFF", "11223344-5566-7788-99AA-BBCCDDEEFF00", "22334455-6677-8899-AABB-CCDDEEFF0011"]
  }
}

Common Use Cases

Starting the day at home. Worker checks assignments on their iPad, then grabs their phone and heads out. Tracking follows them to the right device.

Phone swap. Worker's phone dies mid-shift and they switch to a backup. No disruption to tracking.

Multiple personal devices. Worker uses different phones on different days. HyperTrack figures out which one to use.