Webhooks
Les Webhooks sont des mécanismes de rappel basés sur HTTP qui permettent une communication événementielle entre le système KentixONE et des services externes. Ils sont configurés et gérés dans cette section de menu.
Pour implémenter un Webhook, les paramètres suivants sont requis :
- URL (Uniform Resource Locator) du service externe en tant que point de terminaison de communication
- Méthode HTTP pour le type d'interaction (interroger, envoyer, modifier ou supprimer des données)
- Content-Type pour classifier le format des données pour le service externe
- Les données transmises par le Webhook
Les Webhooks configurés peuvent ensuite être intégrés comme gestionnaires d'événements dans les groupes d'alarme ou les configurations de capteurs. La gestion est affichée de manière claire dans une vue tabulaire, permettant l'ajout et la modification de Webhooks existants.
Variables possibles
Alarmes
| Nom de la variable | Description |
|---|---|
| $ACTIVE_ALARM_SENSOR_NAME$ | Nom |
| $ACTIVE_ALARM_MEASUREMENT_VALUE$ | Valeur mesurée |
| $ACTIVE_ALARM_ALARM_VALUE$ | État d'alarme |
| $ACTIVE_ALARM_SMS_RECEIVER$ | Destinataire du SMS d'alarme |
| $ALARM_EVENT_ID$ | ID API de l'entrée correspondante dans le journal des événements |
Note
États d'alarme possibles :
- 0 : OK
- 1 : Alarme
- 2 : Alarme accusable
- 3 : Avertissement
- 4 : Préalarme
- 5 : Avertissement accusable
Utilisateurs
| Nom de la variable | Description |
|---|---|
| $USER_ID$ | ID |
| $USER_NAME$ | Nom |
| $USER_FULLNAME$ | Nom complet |
| $USER_MAIL$ | Adresse e-mail |
| $USER_RFID_UID$ | RFID UID |
| $USER_RFID_DATA$ | Données RFID |
| $USER_PIN$ | PIN |
| $USER_UUID$ | UUID |
| $USER_PHONE_NUMBER$ | Numéro de téléphone |
Accès
| Nom de la variable | Description |
|---|---|
| $ACCESS_STATE$ | État de réservation |
| $ACCESS_EVENT_ID$ | ID API de l'entrée correspondante dans le journal d'accès |
Note
États de réservation possibles :
- 0 : OK
- 1 : Demande d'ouverture à distance non valide
- 2 : Appareil inexistant
- 3 : RFID inconnu
- 4 : PIN inconnu
- 5 : Échec de l'authentification à deux facteurs
- 6 : Utilisateur inconnu
- 7 : Réservation en dehors du profil horaire autorisé
- 8 : Pas d'autorisation de porte
- 9 : Erreur générale
Appareils
| Nom de la variable | Description |
|---|---|
| $DEVICE_ID$ | ID |
| $DEVICE_NAME$ | Nom |
| $DEVICE_ADDRESS$ | Adresse |
| $DEVICE_MAC$ | Adresse MAC |
| $DEVICE_SERIAL$ | Numéro de série |
| $DEVICE_UUID$ | UUID |
| $DEVICE_TYPE$ | Type d'appareil |
Capteurs et mesures
Info
Pour toutes les variables de capteurs, les règles suivantes s'appliquent :
- "..._VALUE" = Valeur mesurée
- "..._ALARM" = État d'alarme
- "...[number]" = Numéro/Index de l'entrée numérique ou analogique. Les crochets [ ] ne doivent pas être inclus.
Note
États d'alarme possibles :
- 0 : OK
- 1 : Alarme
- 2 : Alarme accusable
- 3 : Avertissement
- 4 : Préalarme
- 5 : Avertissement accusable
| Nom de la variable | Description |
|---|---|
| $INPUT_VALUE[number]$ | Valeur mesurée de l'entrée |
| $INPUT_ALARM[number]$ | État d'alarme de l'entrée |
| $DI_NAME[number]$ | Nom de l'entrée numérique |
| $BATTERY_ALARM$ | État d'alarme de la batterie |
| $BATTERY_VALUE$ | Valeur mesurée de la batterie |
| $BATTERY_LEVEL$ | Niveau de batterie |
| $BATTERY_VOLTAGE$ | Tension de la batterie |
| $SIGNAL_LEVEL$ | Niveau de signal de réception radio |
| $SIGNAL_STRENGTH$ | Puissance du signal de réception radio en dBm |
| $CO2_VALUE$ | Valeur mesurée de CO2 |
| $CO2_ALARM$ | État d'alarme de CO2 |
| $DEWPOINT_VALUE$ | Valeur mesurée du point de rosée |
| $DEWPOINT_ALARM$ | État d'alarme du point de rosée |
| $HUMIDITY_VALUE$ | Valeur mesurée de l'humidité relative |
| $HUMIDITY_ALARM$ | État d'alarme de l'humidité relative |
| $LATENCY_VALUE$ | Valeur mesurée de la latence |
| $LATENCY_ALARM$ | État d'alarme de la latence |
| $MOTION_VALUE$ | Valeur mesurée de détection de mouvement |
| $MOTION_ALARM$ | État d'alarme de détection de mouvement |
| $REED_VALUE$ | Valeur mesurée du contact de porte |
| $REED_ALARM$ | État d'alarme du contact de porte |
| $SABOTAGE_VALUE$ | Valeur mesurée de détection de sabotage |
| $SABOTAGE_ALARM$ | État d'alarme de détection de sabotage |
| $CONNECTION_VALUE$ | Valeur de l'état de connexion |
| $CONNECTION_ALARM$ | État d'alarme de la connexion |
| $EXTPOWER_VALUE$ | Valeur de l'alimentation externe |
| $EXTPOWER_ALARM$ | État d'alarme de l'alimentation externe |
| $TEMPERATURE_VALUE$ | Valeur mesurée de la température ambiante |
| $TEMPERATURE_ALARM$ | État d'alarme de la température ambiante |
| $TILT_VALUE$ | Valeur mesurée du capteur d'inclinaison |
| $TILT_ALARM$ | État d'alarme du capteur d'inclinaison |
| $VIBRATION_VALUE$ | Valeur mesurée de détection de vibration |
| $VIBRATION_ALARM$ | État d'alarme de détection de vibration |
| $SNMP_VALUE$ | Valeur mesurée de la requête SNMP |
| $SNMP_ALARM$ | État d'alarme de la requête SNMP |
| $AIR_QUALITY_VALUE$ | Mesure de la qualité de l'air (surveillance) |
| $AIR_QUALITY_ALARM$ | État d'alarme de la qualité de l'air (surveillance) |
| $AIR_QUALITY_FIRE_VALUE$ | Mesure de la qualité de l'air (détection incendie) |
| $AIR_QUALITY_FIRE_ALARM$ | État d'alarme de la qualité de l'air (détection incendie) |
| $FIRE_HEAT_VALUE$ | Valeur mesurée du capteur de chaleur |
| $FIRE_HEAT_ALARM$ | État d'alarme du capteur de chaleur |
| $FIRE_TI_VALUE$ | Valeur mesurée de température IR |
| $FIRE_TI_ALARM$ | État d'alarme pour la température IR |
| $FIRE_CO_VALUE$ | Valeur mesurée de CO |
| $FIRE_CO_ALARM$ | État d'alarme de CO |
| $SURGE_PROTECTION_VALUE$ | Valeur mesurée de protection contre surtension |
| $SURGE_PROTECTION_ALARM$ | État d'alarme de la protection contre surtension |