Déclencher un scénario Link’nX depuis une URL HTTP (webhook GET)

Le déclencheur HTTP de Link’nX crée une URL privée, à l’adresse de la gateway. Lorsqu’un système autorisé appelle cette URL avec la méthode GET, les scénarios associés reçoivent une demande d’exécution.

Destiné aux installateurs et administrateurs qui raccordent un autre système à un scénario Link’nX. Pour envoyer vous-même une requête depuis un scénario, utilisez plutôt une action HTTP.

Avant de commencer

• Le système appelant peut joindre la gateway à l’adresse affichée dans le formulaire. Pour un accès depuis un autre réseau ou depuis Internet, demandez la procédure adaptée au support avant de modifier la configuration réseau.
• Les actions des scénarios associés sont prêtes : l’appel de l’URL peut demander leur exécution.

Créer le déclencheur HTTP

1. Dans Déclencheurs, cliquez sur Ajouter, puis choisissez HTTP dans Sélectionner le type de déclencheur, groupe Protocoles.
2. Renseignez Nom, obligatoire, de 64 caractères maximum. Exemple fictif : « Appel accueil ».
3. Dans URL, saisissez seulement le nom de terminaison, après le préfixe déjà affiché. Exemple fictif : appel-accueil. Ce champ est obligatoire et ne doit contenir aucun slash / : ne collez pas une URL complète dans cette partie.
4. Cliquez sur la disquette en bas à droite, puis attendez la confirmation de création.

Associer le déclencheur au scénario

Associez le déclencheur au scénario, configurez ses actions et ses conditions, enregistrez, puis vérifiez l’activation du scénario.

Si plusieurs scénarios utilisent ce déclencheur, un appel peut les concerner tous. Vérifiez les scénarios liés avant de réutiliser une URL.

Copier l’URL dans le système appelant

1. Rouvrez le déclencheur HTTP et cliquez sur l’icône de deux feuilles, à gauche du champ URL, dont l’infobulle est Copier.
2. Après L’URL a été copiée dans le presse-papier, reportez l’URL dans la configuration du système autorisé et vérifiez la copie. Gardez cette URL privée.
3. Configurez ce système pour appeler l’URL copiée avec la méthode GET.

Vérifier le résultat

Effectuez un essai uniquement lorsque vous êtes prêt à accepter les actions prévues sur l’installation. Observez ensuite le résultat attendu sur les équipements et consultez l’historique du scénario. La réponse à l’appel ne suffit pas à confirmer que chaque équipement a réalisé sa commande : les conditions et l’état d’activation du scénario restent à vérifier.

Modifier ou dupliquer un déclencheur HTTP

Pour changer le nom de terminaison, ouvrez le déclencheur, modifiez URL, enregistrez, puis confirmez les scénarios affectés si la fenêtre apparaît. Copiez la nouvelle URL et mettez à jour le système appelant : les appels à l’ancienne terminaison ne doivent plus être utilisés pour ce déclencheur.

Si vous dupliquez un déclencheur HTTP pour un usage indépendant, choisissez une terminaison distincte avant d’enregistrer.

En cas de problème

Message ou symptôme	Action
Champ ‘URL’ incorrecte. Une valeur est requise.	Renseignez la terminaison
L’URL ne doit pas contenir de slash (/)	Retirez les slashs et vérifiez que vous n’avez pas collé l’adresse complète
L’appel ne produit aucun effet	Vérifiez d’abord que l’URL copiée correspond au déclencheur enregistré et que le système appelant peut joindre l’adresse affichée. Contrôlez ensuite le scénario associé, son activation, ses conditions et ses délais

Ne multipliez pas les appels pour diagnostiquer une absence de réaction. Si le problème persiste, contactez support@can-nx.com avec le produit, le contexte, le nom du déclencheur, l’heure et le résultat de l’appel, sans transmettre l’URL privée complète.