Driver Unpair Message

The UNPAIR_MESSAGE event is triggered when a driver disconnects from a vehicle that was previously paired via a Bluetooth beacon device. This event notifies the system that the driver is no longer associated with the vehicle, effectively marking the end of the active Bluetooth connection session.

**Event Name:**UNPAIR_MESSAGE

Enablement Package: NA


Trigger Condition

  • The event is triggered when a driver unpairs from a vehicle that was previously connected through a Bluetooth beacon device.
  • To capture and publish this event data, a webhook must be subscribed to the UNPAIR_MESSAGE event.

Example Payload

{
"inputBit7": 0,
"partialUpdate": false,
"inputBit4": 0,
"voiceCallActive": 0,
"inputBit3": 0,
"inputBit6": 0,
"inputBit5": 0,
"type": "PAIR_UNPAIR_MESSAGE",
"deviceId": "71503b9b-34ae-11ec-aea1-fb0cb4fb46f2",
"networkService": 0,
"pairingTypeId": 2,
"commStateConnected": 0,
"messageType": "UNPAIR_MESSAGE",
"messageIndex": "1",
"dimentionFix": 0,
"lastKnownLon": -96.5939584,
"inputBit0": 0,
"inputBit2": 0,
"id": "1c000d8d-f800-4b2c-84d8-ac8bcd45ad9b",
"state": null,
"inputBit1": 0,
"commStatusAvaliable": 0,
"locality": null,
"eventIndex": 0,
"assetNo": "",
"fixStatusCorrected": 0,
"deviceSerial": "8187654322",
"groupName": "Default Group",
"lastKnownTime": 1663778015000,
"jmsType": "",
"vehicleName": "Thor Toyota Camry",
"deviceTypeId": 1,
"destinationQueues": null,
"city": null,
"latitude": null,
"unitStatus": 0,
"invalidFix": 0,
"dataService": 0,
"noOfAccums": 0,
"customerId": 1059,
"beaconMacAddress": null,
"tripNumber": 0,
"spare": 0,
"address": null,
"roaming": 0,
"messageEventType": null,
"stateId": 0,
"updateTime": null,
"userId": null,
"batteryPercentage": 0,
"currentState": 0,
"deviceProtocolMessageId": null,
"messageEventTypeId": 0,
"zipCode": null,
"country": null,
"deviceAssociatedVIN": null,
"beaconType": null,
"groupId": "c337220c-8672-11e2-9b71-55cae3166848",
"vendorTypeId": 0,
"firmwareVersion": null,
"fixStatuslastKnown": 0,
"fixStatusHistoric": 0,
"longitude": null,
"satellites": null,
"locationTime": 1663778015000,
"odometer": 0,
"offset": 0,
"virtualTripEnd": false,
"imei_meid": null,
"insideHOO": true,
"timeOfFix": null,
"sensorNames": null,
"tripPolyline": null,
"lastKnownLat": 32.8419577,
"fixQuality": 0,
"unitStatusBit0": 0,
"unitStatusBit2": 0,
"unitStatusBit1": 0,
"unitStatusBit3": 0,
"storedLocation": false,
"protocolVersionIdChange": false,
"accumesList": null,
"accumulators": null,
"fixStatusPredict": 0,
"network3G": 0,
"lastKnownAddress": "309-499, W I- 30, Garland, TX, 75043, USA",
"privacyModeEnable": false,
"fixStatus": 0,
"vehicleId": "71503b9a-34ae-11ec-aea1-bd1b8b868207",
"lastKnownFixQuality": 0,
"fullName": "Chris Cairns",
"userName": "",
"tripState": "IGNITION_OFF",
"messageTypeId": 0,
"obdSpeed": null,
"location": {
"latitude": 32.8419577,
"longitude": -96.5939584
},
"commonState": 0,
"carrierId": null
}

Reference

Field

Description

type*
String

Type of message. Example: "PAIR_UNPAIR_MESSAGE"

deviceId*
String, UUID

Unique identifier of the telematics device. Example: "71503b9b-34ae-11ec-aea1-fb0cb4fb46f2"

pairingTypeId*
Integer

Identifies the type of pairing event. Example: 2(2 indicates Beacon pairing).

messageType*
String

Specifies whether this is a PAIR_MESSAGE or UNPAIR_MESSAGE. Example: "UNPAIR_MESSAGE"

lastKnownLon*
Float

Last known GPS coordinates at the time of event. Example: -96.5939584

id*
String, UUID

Unique identifier for the event –
Example: "1c00d95d-3301-4272-b9f6-72a0224bbf9e"

deviceSerial*
String

Serial number of the telematics device. Example: "8187654322"

groupName*
String

Name of the Group.
Example: Default Group

lastKnownTime*
Long

Timestamp of last known vehicle position. Example: 1663778015000

vehicleName*
String

Registered name of the vehicle. Example: Thor Toyota Camry

city*
String

City name.

customerId*
Integer

Customer account identifier. Example: 1059

lastKnownAddress*
String

Human-readable last known address. Example: 309-499, W I- 30, Garland, TX, 75043, USA

country*
String

Country name.

batteryPercentage*
Integer

Device’s battery level (0–100)
Example: "15"

tripState*
String

Current ignition state. Example: IGNITION_OFF

odometer*
Float

Odometer reading at event time. Example: "0"

updateTime*
String

Time when record was last updated. Example: Null

userId*
UUID

ID of user performing the action. Example: "dc5c3f84-a601-11e5-96ee-22000ac501ss"

fullName*
String

Name of the user triggering the request Example: "Chris Cairns"

userName*
String

Name of the user. Example: "Sharma"

location*
Object

Contains vehicle’s last known GPS coordinates.

latitude*
Float

Last known latitude. Example: 32.8419577

longitude*
Float

Last known longitude.
Example: -96.5939584