Le déclencheur Webhook - Zoho Flow

Le déclencheur Webhook - Zoho Flow

Qu'est-ce qu'un webhook ?

Un webhook est un rappel d'URL  (callback en anglais) défini par l'utilisateur. Il s'agit d'un mécanisme qui permet aux applications de recevoir des mises à jour de données en temps réel par le biais d'un appel d'URL. Pour faire simple, les webhooks permettent de déclencher une action suite à un événement. Ils sont généralement utilisés pour faire communiquer des systèmes. C’est la façon la plus simple de recevoir une alerte lorsque quelque chose se produit dans un autre système.
Les webhooks peuvent être extrêmement utiles lorsque vous travaillez avec des mises à jour de données qui doivent être notifiées immédiatement, telles que les transactions de paiement et les escalades de tickets.

Que pouvez-vous faire avec des webhooks ? Entre autres, vous pouvez :

  1. Synchroniser les systèmes en temps réel ;
  2. Envoyez n’importe quel type de notification ;
  3. Traitez les données comme vous le souhaitez ;
  4. Créer des rapports ;
Et bien d’autres choses encore en fonction de vos besoins !


Quelques termes importants

Webhook
Le mécanisme d'appel d'une URL lorsqu'un événement se produit. Les données sont envoyées sur une URL spécifique sur le web.

Webhook URL
L'URL par laquelle les données sont envoyées d'une application à une autre lorsqu'un événement se produit.

Payload
Les données reçues de l'application via l'URL du webhook.

HTTP
Hyper Protocole de transfert de texte. Norme de transmission de données qui définit la manière dont les serveurs et les navigateurs envoient et interprètent les données.

Headers (En-têtes)
Informations supplémentaires transférées avec la demande HTTP à des fins d'autorisation et d'identification, par exemple.

Déclencheur de webhook

Le déclencheur webhook dans Zoho Flow vous permet de démarrer votre flux en fonction des mises à jour de données reçues d'une application qui prend en charge les webhook sortants via une URL. Ces données peuvent ensuite être utilisées dans les actions de votre flux. Par exemple, vous disposez d'une application personnalisée utilisée en interne par votre entreprise pour gérer les transactions commerciales. Si elle prend en charge les webhooks configurables, vous pouvez configurer un flux pour qu'il démarre chaque fois qu'un type spécifique de mise à jour de données est effectué dans l'application.

Comment fonctionne le déclencheur webhook ?

Lorsque vous configurez ce déclencheur, une URL unique est générée par Zoho Flow. Utilisez-la pour configurer les paramètres de l'application ou du code tiers afin d'envoyer des données à Flow lorsqu'une mise à jour de données particulière a lieu.

Ce déclencheur prend en charge trois types de données :

JSON
La notation d'objet JavaScript (JSON) est un format d'échange de données léger. Il contient des données sous forme de paires clé-valeur.

Exemple : {"nom" : "Frank", "société" : "Zylker", "montant" : "400"}, ici "nom" : "Frank" est la première paire clé-valeur dans laquelle "nom" est la clé et "Frank" la valeur.

ou encore, en anglais, Example: {"name" : "Frank", "company" : "Zylker", "amount" : "400"}, 
Here "name" : "Frank" is the first key-value pair in which 'name' is the key and 'Frank' is the value.

Données du formulaire
Ensemble de paires de valeurs clés représentant les noms des champs du formulaire et leurs valeurs, qui peuvent être utilisés dans le cadre d'une requête HTTP.

Exemple : name=Frank&company=Zylker&amount=400

Texte en clair (plain text)
Si vous sélectionnez les données en texte clair, les données entrantes seront rendues telles qu'elles sont envoyées via l'URL.

Exemple : Zylker

Note : Sélectionnez Plain text pour XML. Vous pouvez le traiter davantage en utilisant une fonction personnalisée.

Zoho Flow interprète les données entrantes en fonction du type que vous sélectionnez. Il est important que vous sachiez comment vos données vont être transférées. Par exemple, si vous avez choisi Données du formulaire et que les données entrantes sont nom=Franc&entreprise=Zylker&montant=400, Zoho Flow interprétera les données comme :

nom : Frank société : Zylker montant : 400

Toutefois, si vous choisissez Texte clair et que les données entrantes sont name=Frank&company=Zylker&amount=400, Zoho Flow interprétera les données comme :

données : nom=Franc&compagnie=Zylker&montant=400

Dans certains cas, la sélection d'un mauvais type de données peut ne pas déclencher le flux comme prévu.

Comment configurer un webhook ?

  1. Dans la section Mes flux de Zoho Flow, cliquez sur Créer un flux ou sur +.
  2. Saisissez le nom du flux et, éventuellement, une description.
  3. Cliquez sur Créer.
  4. Cliquez sur Configurer dans la zone de déclenchement du Webhook.



  5. Votre URL personnalisée sera disponible. Cette URL est unique pour chaque flux. Cliquez sur Copier et collez-le dans votre code ou application.
  6. Sélectionnez le format (JSON, données de formulaire ou texte brut) dans lequel l'application/code envoie les données à Zoho Flow et cliquez sur Suivant.
  7. Cliquez sur Test pour vérifier si tout fonctionne correctement avec les données de l'échantillon.
  8. Par défaut, le flux se déclenchera pour chaque élément. Par exemple, Zoho Flow reçoit les données sous la forme [{"nom" : "Frank", "société" : "Zylker", "montant" : "400"}{"name" : "Tom", "company" : "Zylker", "amount" : "900"}] . Ici, {"nom" : "Frank", "société" : "Zylker", "montant" : "400"} est un élément et {"nom" : "Tom", "société" : "Zylker", "montant" : "900"} est un autre élément. Lorsque cette option est activée, le flux se déclenchera deux fois. Vous pouvez choisir de décocher la case.
  9. Si vous ne voulez que la valeur d'une clé particulière, vous pouvez la spécifier dans le champ "Extract part of payload". Par exemple, Zoho Flow reçoit les données sous la forme {"nom" : "Frank", "société" : "Zylker", "montant" : "400"}, et vous avez saisi le nom dans ce champ. Dans ce cas, seule la valeur de nom sera extraite et toutes les autres valeurs seront rejetées. Dans les étapes suivantes de votre flux, seul le nom sera disponible pour vous.
  10. Après la configuration, cliquez sur Terminé et ajoutez des actions à votre flux de travail.

Problèmes courants

Le déclenchement du webhook ne démarre pas lors d'une mise à jour des données.
  1. Assurez-vous que vous avez choisi le bon type de données (JSON, données de formulaire ou texte en clair) lors de la configuration du déclencheur. Si la mauvaise option est sélectionnée, le flux peut ne pas être déclenché.
  2. Le déclencheur webhook peut-il fonctionner avec des applications sur site ? Si l'application sur site prend en charge les webhooks sortants, le déclencheur webhook peut utiliser les données pour lancer un flux.