Webhooks
- Dernière mise à jour le 15 mai 2023 à 13:51
Note : Vous ne trouvez pas cette fonction dans votre Cloud ? Cet article contient des fonctionnalités disponibles avec le plan Essential (ou Plus) de TimeMoto Cloud. Si vous voulez tirer le meilleur parti de votre compte TimeMoto, assurez-vous de mettre votre plan à niveau en accord avec vos besoins !
Voulez-vous profiter davantage de l'expérience TimeMoto Cloud ? Alors que notre système fonctionne déjà par lui-même avec différents modules comme nos TimeMoto Clocks ainsi qu'un navigateur et une application mobile, vous pouvez faire encore plus ! Découvrez comment vous pouvez utiliser les webhooks pour faire communiquer TimeMoto avec vos propres systèmes pour en faire la meilleure option adaptée exactement à vos besoins.
Vous trouverez les options pour les développeurs en défilant vers le bas depuis n'importe quel endroit de votre de votre cloud et en sélectionnant le lien [Options du développeur]
dans votre cloud.
Options du développeur
Les Options pour les développeurs sont divisées en deux segments. [Options du développeur]
et [Webhooks]
. Dans les options de développement, vous pouvez définir la version globale de vos webhooks.
Webhooks
Cliquez sur [Webhooks]
pour accéder aux paramètres spécifiques de vos webhooks.
Vous y trouverez une liste des webhooks déjà ajoutés, contenant les éléments suivants :
- e nom des webhooks
- l'URL du webhook
- la version du protocole de communication utilisé par le webhook
- l'état activé du webhook
- le taux d'erreur du webhook (tentatives échouées)
Comment fonctionne un webhook ?
Un webhook est un moyen d'informer un logiciel des événements d'un autre logiciel.
Imaginez un employé de la réception qui est censé informer son collègue de l'arrivée d'un si un client particulier est arrivé dans le bâtiment. Une fois que l'employé de la réception l'employé de la réception voit le client en question, il décroche le téléphone et appelle son collègue pour l'en informer.
C'est ainsi que fonctionne un webhook. Pour transposer cela dans le monde des logiciels : Vous créez un événement qui doit déclencher le webhook (comme, dans cet exemple, la réception). Une fois que l'événement s'est produit (l'arrivée du client), les webhooks envoient l'information à une URL (celle du collègue) pour transmettre les détails.
Ajouter des webhooks
Assurez-vous d'avoir sélectionné la section. Pour créer un nouveau webhook, cliquez sur le bouton [Ajouter un webhook] dans le coin supérieur droit. Dans le formulaire suivant, remplissez tous les détails nécessaires :
- Donnez un nom au webhook. Un nom permet d'identifier le webhook et de le retrouver plus facilement dans votre liste.
- Le statut indique si le webhook est actif ou inactif.
- Insérez l'URL de l'adresse du webhook. Gardez à l'esprit qu'il doit s'agir d'une adresse HTTPS.
- En option, vous pouvez rattacher le webhook à une version spécifique du protocole de communication ou le laisser vide. Si vous laissez ce champ vide, le webhook utilisera la version globale définie dans vos options de développement ou, si celle-ci est également vide, la dernière version stable prédéfinie.
- Sélectionnez les événements qui doivent déclencher le webhook. Vous pouvez sélectionner plusieurs événements, tels que l'insertion, la mise à jour ou la suppression de données utilisateur.
Une fois que vous avez terminé, cliquez sur [Enregistrer] pour ajouter le webhook à votre liste.
Dès que vous avez créé le webhook, vous pouvez cliquer dessus pour en savoir plus.
Secret
Non, nous ne parlons pas des secrets cachés d'une entreprise. Un secret est un qui est censé garantir que votre URL ne reçoit que des données légitimes de la part des webhooks de TimeMoto Cloud légitimes provenant des webhooks de TimeMoto Cloud. Il s'agit en quelque sorte d'un sceau d'approbation.
Tentatives
Si vous voulez vous assurer que le webhook fonctionne comme prévu, vous pouvez voir ici une liste de toutes les tentatives de sortie documentées avec l'état, le type d'événement, l'ID de l'événement et l'heure exacte de la sortie. En cas d'échec d'une tentative échouée, vous verrez également quand le système va réessayer la sortie.
Si vous ne souhaitez pas attendre qu'un événement réel se produise, vous pouvez également cliquer sur [Envoyer le test]
, vous pouvez également cliquer sur [Send test webhook]
pour déclencher une tentative de test. Cette tentative sera classée comme suit.
Vous avez des questions ?
Vous cherchez des réponses mais ne savez pas par où commencer ? Consultez notre glossaire ! Il s'agit d'une ressource précieuse qui vous aidera à trouver les informations dont vous avez besoin. Si vous avez besoin d'aide supplémentaire, veuillez nous contacter via le formulaire de contact.