Bot

May 16, 2026 · View on GitHub


Device List Information

KeyValue TypeDescription
deviceIdStringdevice ID
deviceNameStringdevice name
deviceTypeStringdevice type. Bot
enableCloudServiceBooleandetermines if Cloud Service is enabled or not for the current device
hubDeviceIdStringdevice's parent Hub ID

Device Status

KeyValue TypeDescription
deviceIdStringdevice ID
deviceTypeStringdevice type. Bot
powerStringON/OFF state
batteryIntegerFour-segment battery level division,<10%, shown as 9;10%~20%, shown as 19;20%~60%, shown as 59;≥60%, shown as 100
versionStringthe current firmware version, e.g. V6.3
deviceModeStringpressMode, switchMode, or customizeMode
hubDeviceIdStringdevice's parent Hub ID

Control Commands

deviceTypecommandTypeCommandcommand parameterDescription
BotcommandturnOffdefaultset to OFF state
BotcommandturnOndefaultset to ON state
Botcommandpressdefaulttrigger press

Webhook Events

Key NameValue TypeDescription
eventTypeStringthe type of events
eventVersionStringthe current event version
contextObjectthe detail info of the event
deviceTypeStringthe type of the device
deviceMacStringthe MAC address of the device
powerStringthe current state of the device. This state is only valid for Switch Mode, where "on" stands for on and "off" stands for off. It will return "on" or "off" in Press Mode or Customize Mode, but the returned value can be neglected.
timeOfSampleLongthe time stamp when the event is sent
{
    "eventType": "changeReport",
    "eventVersion": "1",
    "context": {
        "deviceType": "WoHand",
        "deviceMac": DEVICE_MAC_ADDR,
        "power": "on",//"on"or"off"
        "battery": 10,
        "deviceMode": "pressMode",//pressMode,switchMode,customizeMode
        "timeOfSample": 123456789
    }
}