Help us improve your experience.

Let us know what you think.

Do you have time for a two-minute survey?

 
 

Configurer les événements d’entrée et de sortie de zone (cas d’usage)

Utilisez cet exemple comme modèle pour créer des webhooks qui vous avertissent des événements d’entrée et de sortie des zones de vos plans d’étage.

Les webhooks sont des messages unidirectionnels d’un serveur source ou d’une application vers un serveur ou une application de destination. La méthodologie des webhooks est « fire and forget », ce qui signifie que vous utilisez les webhooks principalement pour planifier des messages basés sur des événements à des fins d’alerte et de surveillance. Dans un réseau Juniper Mist, vous pouvez utiliser des webhooks pour envoyer des messages en fonction de rubriques Organisation ou Site. Cela signifie que vous utilisez principalement les webhooks pour planifier des messages basés sur des événements à des fins d’alerte et de surveillance.

Pour ce cas d’utilisation, à partir de l’API Juniper Mist, vous configurez une notification webhook chaque fois qu’un appareil entre ou sort d’une zone. Cette notification est utile pour un site avec une automatisation de bâtiment. Un utilisateur qui entre ou sort d’une zone définie dans Juniper Mist (telle qu’une pièce) et qui a un appareil suivi en main peut déclencher un événement qui est envoyé de Juniper Mist au système d’automatisation du bâtiment pour allumer ou éteindre les lumières. Pour en savoir plus sur les zones d’emplacement, reportez-vous à la rubrique Ajouter des zones d’emplacement à un plan d’étage.

Pour configurer des webhooks dans le portail Juniper Mist, vous avez besoin des éléments de configuration suivants (et vous pouvez également utiliser l’élément facultatif répertorié) :

  • Nom de l’instance de webhook (obligatoire)

  • URL (destination pour recevoir les webhooks Juniper Mist (obligatoire)

  • API de diffusion en continu dans la section Webhooks du site (sélectionnez la rubrique « Événements d’entrée/sortie de zone » pour diffuser vers la destination) (obligatoire)

  • Secret, comme un mot de passe, pour authentifier la communication entre le Juniper Mist et la destination du webhook (facultatif)

Une fois que vous avez ces informations, vous pouvez configurer le webhook dans les paramètres du site.

Pour configurer les événements d’entrée et de sortie de zone :

  1. Dans le menu de gauche du portail Juniper Mist, sélectionnez Organisation > Administrateur > Configuration du site.
  2. Cliquez sur Ajouter un webhook, entrez les informations, puis cliquez sur Ajouter.
    Pour plus d’informations sur les champs à remplir, consultez Ajouter un webhook dans le portail Juniper Mist.

    Chaque fois qu’un appareil entre ou sort d’une zone, Juniper Mist crée un webhook POST vers l’URL spécifiée. La charge utile de la requête entrante, telle qu’elle est formatée en JavaScript Object Notation (JSON), ressemble à ceci :

    À l’aide de ces informations, vous pouvez activer d’autres automatisations dans un système tiers, telles que l’extinction des lumières dans la zone 33294994-6a5f-4804-xxxx-xxxxxxxxxxxxxxx en fonction du déclencheur de exit.

Documentation connexe