Un webhook est une adresse internet (URL) qui, lorsqu’elle est appelée, déclenche une action sur un ou plusieurs écrans. Un webhook peut être appelé directement depuis un navigateur internet, ou par le biais d'objets connectés comme les assistants vocaux, les alarmes incendie, les détecteurs d'ouverture de porte, etc.
Depuis la rubrique Mon Compte, retrouvez les "Webhooks" dans la section Extensions.
Vous avez accès à 3 types d’action :
Déclencher la lecture d'un ou de plusieurs médias, même s’ils ne sont pas dans votre planning habituel.
Effectuer des opérations liées au fonctionnement du player : allumer ou éteindre l’écran, redémarrer le player, modifier le volume, etc
Naviguer entre les médias : passer au média suivant ou au média précédent.
1. Création :
Créez simplement un webhook en lui donnant un nom puis en cliquant sur "Créer"
2. Configuration :
Ouvrez le configurateur en cliquant sur la "roue crantée".
Depuis le configurateur, on désigne quelles sont les actions sont autorisées, quels players les exécuteront, et quels médias ou playlists seront le cas échéant joués.
N'oubliez pas d'enregistrer afin de valider la configuration.
3. Génération :
Maintenant que le webhook est configuré, nous avons besoin de connaître les différents liens qui lui sont associés. Pour cela, cliquez sur "Générer un webhook".
Il suffit de sélectionner la famille d'action, l'action et ses éventuelles options et le lien est automatiquement généré.
Vous pouvez soit le "copier" afin de l'utiliser ultérieurement, soit cliquer sur le "bouton play" afin de jouer le webhook immédiatement.
Vous l'avez compris, un webhook est simplement une URL... elle peut donc être déclenchée par n'importe quel "élément" connecté :
une personne qui lance l'adresse dans son navigateur.
un périphérique connecté (Home Assistant, système d'alarme, ...).
une application web ou smartphone.
un player d'affichage dynamique Pro Display
via les Évènements (par exemple pour lancer un jingle toutes les 10 minutes).
un lecteur de contact-sec, branché sur le player (nous consulter) : par exemple pour déclencher un média quand une porte s'ouvre, ou une alerte si un bouton d'urgence est enclenché.
un lecteur de carte RFID, branché sur le player (nous consulter) : par exemple pour déclencher un média si un objet est déposé sur le lecteur de puce RFID.
...
Comme nous l'avons vu plus haut, un webhook est une URL qui peut être appelée de n'importe où et se déclencher simultanément sur une multitude de players.
Un player peut également appeler un webhook (via les Évènements, un lecteur RFID, ou un lecteur de contact-sec), et ce, de deux manières :
comme tout autre périphérique connecté : en appelant l'URL globale via internet, comme par exemple https://wh.adyn.tv/j2asWGEqZTwEsqpz5EGcDAd/alert/play/1time. Tous les players concernés déclenchent alors le webhook (à condition qu'ils disposent bien de la connexion instantanée).
via un appel local : si on ne veut agir que sur ce player, ce n'est pas la peine de passer par Internet. Pour cela, on configure l'appel sans le début de l'URL : j2asWGEqZTwEsqpz5EGcDAd/alert/play/1time. Si d'autres players sont associés à ce webhook, ils ne seront tout simplement pas informé de ce déclenchement local.