createSiteRawDataWebhook
POST https://{{host}}/api/v1/sites/:site_id/webhooks
Raw data webhooks are a special subset of webhooks that provide insight into raw data packets emitted by a client, identified by their advertising MAC address (assets, discovered ble, connected wifi, unconnected wifi). The data that client raw data webhooks encompasses are reporting AP information, RSSI Data, and any special packets/telemetry packets that the client may emit. Note that client raw webhooks are the raw data coming from the client and do not contain the X,Y location data of the client. In order to get the location data for a client please see our location webhooks. Clients can be identified uniquely across these client raw data topics and location webhook topic using MAC address as the Unique identifier (client identifier).
Client Raw Data Webhooks Topics
Topics that correspond to client raw data for different client types. To be included in the http-post
message for /api/v1/sites/:site_id/webhooks
API.
1. asset-raw-rssi
- Raw data from packets emitted by named and filtered assets
2. discovered-raw-rssi
- Raw data from packets emitted by passive BLE devices
3. wifi-conn-raw
- Raw data from packets emitted by connected devices 4. wifi-unconn-raw
- Raw data from packets emitted by unconnected devices (passive)
Rules for configuring client raw data webhooks
Only one instance of a webhook object containing a client raw data webhook topic is allowed. (a site level entry will override an org level entry for the client raw data webhook topic in question)
Only one client raw data webhook topic is allowed per
http-post
message to webhooks api
Request Body
{"name"=>"test-asset-raw", "url"=>"https://xyz.abc", "enabled"=>true, "topics"=>["asset-raw-rssi"]}