Help us improve your experience.

Let us know what you think.

Do you have time for a two-minute survey?

 
ON THIS PAGE
 

Webhook Hierarchy

SUMMARY Understand the relationship between organizational- and site-level webhooks. Get familiar with the webhook topics that you can configure at each level.

Webhook Hierarchy Overview

Juniper Mist has two configuration hierarchies for webhooks: the organization level and site level. The configuration method is the same for both; however, not all webhooks are available at both levels.

  • All webhooks that are available at the organization level are also available for specific site-level webhooks.

  • The available site-level webhooks are not available at the organization level.

Be aware of the hierarchy when configuring webhooks.

As an example, if you have two sites and you configure the Alerts webhook at the organization level, you will receive all organization-level alerts for both sites.

Conversely, if you do not configure the Alerts webhook at the organization level and only configure the Alerts webhook on one of the two sites, you will receive alerts only for that single site.

Finally, if you configure the Alerts webhook at the organization level and a single site, the webhook receiver will receive duplicate messages (assuming they are sent to the same receiver URL).

You can configure multiple webhook receivers for a single webhook (and its topics) from the API. It is recommended to have a single webhook that includes all the available topics and then parse the information that you want from messages received by the webhook receiver.

Organization Webhooks

You can configure these topics at the organization level:

  • Alerts—Juniper Mist-defined alarm events configurable on a per-site basis in the alert framework.

  • Audits—A topic that tracks configuration changes made from the Juniper Mist dashboard.

  • Client Join—The webhook that Juniper Mist triggers whenever a client joins a wireless network.

  • Client Sessions—The webhook that includes information about each specific client.

  • Device Events—A topic that is specific to events that occur on devices (currently AP, switch, and gateway).

  • Device Up/Downs—The topic that generates a message when a device starts up or goes down.

  • Juniper Mist Edge Events—The topic that generates messages for a Juniper Mist Edge port and link status changes and link aggregation control protocol (LACP) port and link changes.

Site Webhooks

You can configure these topics at the site level:

Location Webhooks

To use location webhooks, you must upload a floorplan with accurate AP placement through the Juniper Mist portal to correlate the client data. For more information, see the Floorplan Setup Overview in the Juniper Mist Location Services Guide.

  • Location Coordinates—Data sent at regular intervals of less than one per second.

  • Zone—Data pushed any time a client enters or exits one of the defined areas.

    • Occupancy Alerts—Alerts on a configured zone occupancy threshold being exceeded.

    • RSSI Zones—Alerts based upon a WLAN’s minimum RSSI value of a client’s signal strength in relation to the site’s APs.

    • SDK Client Scan Data—Specific data about a client that isn’t available without installing an application (using the SDK) on the client itself.

    • Virtual Beacon Entry and Exit Events—Data pushed any time a client enters or exits one of these areas.

    • Zone Entry and Exit Events—Data pushed any time a client enters or exits one of these areas.

Infrastructure Webhooks

  • Alerts—Juniper Mist-defined alarm events configurable on a per-site basis in the alert framework.

  • Audits—A topic designed to track configuration changes made from the Juniper Mist portal.

  • Client Join—This Juniper Mist webhook triggers whenever a client connects to a wireless network.

  • Client Sessions—The webhook that includes information about each specific client.

  • Device Events—The topic that is specific to events that occur on devices (currently AP, switch, and gateway). 

    • Device Updowns—The topic that generates a message when a device starts up or goes down.

    • Juniper Mist Edge Events—The topic that generates messages for the Juniper Mist edge port and link status changes and for an LACP port (if configured) and link changes.