Driver Pair Message

**Event Name:**PAIR_MESSAGE

Enablement Package: NA

Trigger Condition

This event is triggered immediately when a driver successfully pairs with a vehicle through a Bluetooth beacon device.
To receive and process this event data, a webhook must be subscribed to the PAIR_MESSAGE event. Once subscribed, the system will automatically publish the event payload to the configured webhook endpoint in real time.

Example Payload

{
"inputBit7": 0,
"partialUpdate": false,
"inputBit4": 0,
"voiceCallActive": 0,
"inputBit3": 0,
"inputBit6": 0,
"inputBit5": 0,
"type": "PAIR_UNPAIR_MESSAGE",
"deviceId": "c8af22d5-11bf-11ed-a5d3-73c9cdfac6ce",
"networkService": 0,
"pairingTypeId": 0,
"commStateConnected": 0,
"messageType": "PAIR_MESSAGE",
"messageIndex": "1",
"dimentionFix": 0,
"lastKnownLon": 79.746475,
"inputBit0": 0,
"inputBit2": 0,
"id": "1c009375-5900-48c2-b104-2419ba4d0bb3",
"state": null,
"inputBit1": 0,
"commStatusAvaliable": 0,
"locality": null,
"eventIndex": 0,
"assetNo": "",
"fixStatusCorrected": 0,
"deviceSerial": "9765611524",
"groupName": "Group B",
"lastKnownTime": 1663781819000,
"jmsType": "",
"vehicleName": "9765611524",
"deviceTypeId": 1,
"destinationQueues": null,
"city": null,
"latitude": null,
"unitStatus": 0,
"invalidFix": 0,
"dataService": 0,
"noOfAccums": 0,
"customerId": 15047,
"beaconMacAddress": null,
"tripNumber": 0,
"spare": 0,
"address": null,
"roaming": 0,
"messageEventType": null,
"stateId": 0,
"updateTime": null,
"userId": "8a938091-8258-01d0-0182-5a7685d400e4",
"batteryPercentage": 0,
"currentState": 0,
"deviceProtocolMessageId": null,
"messageEventTypeId": 0,
"zipCode": null,
"country": null,
"deviceAssociatedVIN": null,
"beaconType": null,
"groupId": "9d5962ad-11bf-11ed-a5d3-356110c9a0b7",
"vendorTypeId": 0,
"firmwareVersion": null,
"fixStatuslastKnown": 0,
"fixStatusHistoric": 0,
"longitude": null,
"satellites": null,
"locationTime": 1663829122000,
"odometer": 0,
"offset": 0,
"virtualTripEnd": false,
"imei_meid": null,
"insideHOO": true,
"timeOfFix": null,
"sensorNames": null,
"tripPolyline": null,
"lastKnownLat": 15.355929,
"fixQuality": 1,
"unitStatusBit0": 0,
"unitStatusBit2": 0,
"unitStatusBit1": 0,
"unitStatusBit3": 0,
"storedLocation": false,
"protocolVersionIdChange": false,
"accumesList": null,
"accumulators": null,
"fixStatusPredict": 0,
"network3G": 0,
"lastKnownAddress": " Vardhineni Palem, Andhra Pradesh 523271, India",
"privacyModeEnable": false,
"fixStatus": 0,
"vehicleId": "c8af22d4-11bf-11ed-a5d3-51bf6ebbe66a",
"lastKnownFixQuality": 0,
"fullName": "Locking User",
"userName": "Rohit Sharma",
"tripState": "IGNITION_OFF",
"messageTypeId": 0,
"obdSpeed": null,
"location": {
"latitude": 0,
"longitude": 0
},
"commonState": 0,
"carrierId": null
}

Reference

Field	Description
*type** String	Identifies the event type. Example: `"PAIR_MESSAGE"`
deviceId String	Unique identifier of the telematics or beacon device. Example: "c8af22d5-11bf-11ed-a5d3-73c9cdfac6ce"
*pairingTypeId** Integer	Identifies the type of pairing event. Example: `1`(1 indicates Bluetooth beacon device pairing).
*messageType** String	Specifies whether it’s a pairing (PAIR_MESSAGE) event. Example: `"PAIR_MESSAGE"`
lastKnownLon* Float	Last known GPS coordinates at the time of event. Example: `77.611127`
id* String, UUID	Unique identifier for the event – Example: `"1c00d95d-3301-4272-b9f6-72a0224bbf9e"`
deviceSerial* String	Device serial number (IMEI or unique identifier). Example: `"3339076777"`
groupName* String	Fleet or customer group to which the vehicle belongs. Example: `"Group B"`
lastKnownTime* Long, Epoch	UTC epoch time when the event was recorded. Example: `1662630015000`
vehicleName* String	Display name or registration number of the vehicle. Example: `"3339076777"`
*city** String	City name.
*customerId** Integer	Customer account identifier. Example: `1059`
userId* UUID	ID of user performing the action
batteryPercentage* integer	Battery percentage of the beacon or device. Example: `19`
locationTime* timestamp	UTC epoch time when the location data was captured.
*odometer** Float	Odometer reading at event time. Example: "0"
_lastKnownAddress* String	Reverse-geocoded address of the vehicle’s last known location. Example: `"Vardhineni Palem, Andhra Pradesh 523271, India"`
*vehicleId** String, UUID	Unique identifier of the vehicle associated with the event. Example: `"c8af22d4-11bf-11ed-a5d3-51bf6ebbe66a"`
lastKnownAddress* String	Reverse-geocoded address of the vehicle’s last known location.
deviceSerial* string	Device serial number (IMEI or unique identifier).
groupId* String	Unique ID of the customer group/fleet.
*fullName** Integer	Full name of the driver. Example: `Locking User`
userName* String	Username of the driver. Example: `"Rohit Sharma"`
tripState* String	Vehicle’s ignition state at the time. Example: `"IGNITION_OFF"`