Déclencheur Webhook entrant : recevoir des données
Mis à jour le
Le déclencheur Webhook entrant lance une automatisation TimeTonic quand un outil externe envoie une requête HTTP à une URL dédiée.
L'outil externe peut être un outil d'automatisation externe, un formulaire de site web ou un script personnalisé. Le contenu de l'appel, au format JSON, devient des variables utilisables dans vos actions.
À prévoir : une automatisation TimeTonic avec ce déclencheur, et un outil capable d'envoyer une requête POST à l'URL générée.
Il connecte TimeTonic à vos autres services. Chaque événement externe peut créer ou mettre à jour une ligne, puis lancer vos actions. Voici les cas d'usage courants.
Créer une ligne depuis un formulaire externe
Un formulaire rempli sur un site web crée automatiquement une ligne dans TimeTonic.
Recevoir des données d'une application tierce
Un CRM ou un outil de prospection envoie ses données dans une table TimeTonic.
Mettre à jour une ligne existante
Un changement de statut dans un autre système met à jour la ligne correspondante.
Déclencher une automatisation
Un événement externe lance un scénario d'automatisation : nouvelle vente, nouveau contact, nouveau ticket.
Synchroniser une partie des données
Seules les informations utiles à une équipe passent de l'outil métier vers TimeTonic.
2. Que contient la fenêtre de configuration ?
La fenêtre Déclencheur Webhook se lit de haut en bas. Trois zones numérotées règlent la sécurité, les données reçues et la ligne ciblée.
1. Mot de passe du Webhook
Protège l'URL : sans mot de passe, tous les appels sont acceptés.
2. Structure de donnée
Transforme les propriétés du JSON reçu en variables locales.
3. Identification des lignes
Choisit entre créer une ligne, la retrouver par son ID ou par la valeur d'un champ.
3. Comment sécuriser le webhook avec un mot de passe ?
Le mot de passe est facultatif. S'il est défini, TimeTonic accepte seulement les appels qui portent la bonne signature. Sans mot de passe, tous les appels passent sans vérification.
3.1 Appeler le webhook sans mot de passe
Aucune authentification n'est requise. La requête HTTP part sans en-tête supplémentaire.
Calculez le hachage sur le corps exact que vous envoyez : un espace de plus ou de moins change le résultat.
4. Comment définir la structure des données ?
La structure des données extrait des éléments du JSON reçu et les transforme en variables locales. Vous les réutilisez ensuite dans vos actions d'automatisation.
Champ de la structure
Exemple
Description
Nom de la variable locale
age
Le nom que vous donnez à la variable dans TimeTonic pour la réutiliser dans vos actions.
Nom de la propriété du Webhook
Age_du_participant
Le nom exact de la clé dans le JSON reçu. Les espaces sont interdits.
Vous pouvez aussi coller un JSON dans l'éditeur, avec le bouton Use JSON structure :
{
"cle1": "valeur1",
"cle2": "valeur2"
}
Résultat : TimeTonic lit le JSON et crée les variables locales cle1 et cle2, avec le nom des propriétés.
5. Comment choisir l'identification de la ligne ?
Dans la dernière étape de la fenêtre, trois options définissent ce que TimeTonic fait des lignes à chaque appel reçu.
Option
Effet
À utiliser quand
Création de ligne unique
Crée une nouvelle ligne.
Chaque appel doit produire une ligne distincte.
Identifier via l'ID de la ligne
Cherche la ligne par son ID TimeTonic.
Vous connaissez déjà l'ID de la ligne à mettre à jour.
Identifier via la valeur d'un champ
Compare une variable reçue à un champ de la table.
Un champ unique identifie la ligne : e-mail, code client.
5.1 Création de ligne unique
Chaque appel crée une ligne, sans vérifier si elle existe déjà. Cette option convient aux formulaires, aux enregistrements et aux journaux continus.
1
Dans l'outil externe
Placez dans le corps de la requête les propriétés qui portent vos informations. Exemple : nom Age_du_participant, valeur 24.
L'appel cible une ligne précise grâce à son ID TimeTonic. Utilisez cette option quand l'ID vient d'une étape précédente ou d'un autre système.
1
Dans l'outil externe
Placez dans le corps de la requête l'ID de la ligne et les valeurs à écrire. Exemple : ID = 12096043, puis Age_du_participant = 24.
2
Dans TimeTonic
Cochez Identifier via l'ID de la ligne, puis sélectionnez la variable locale qui porte l'ID.
3
Écrivez dans la ligne identifiée
Ajoutez l'action Écrire dans un champ. La variable du webhook est en bas de la liste déroulante.
5.3 Identifier via la valeur d'un champ
TimeTonic compare la valeur reçue à un champ de la table. Il met à jour la première ligne qui correspond. Sans correspondance, le scénario s'arrête.
1
Dans l'outil externe
Placez dans le corps la valeur d'identification et les autres paires à mettre à jour. Exemple : Age_du_participant = 24.
2
Dans TimeTonic
Cochez Identifier via la valeur d'un champ. Sélectionnez le champ de la table et la variable qui porte la valeur.
3
Écrivez dans la ligne identifiée
Ajoutez l'action Écrire dans un champ. La variable du webhook est en bas de la liste déroulante.
6. Comment obtenir l'URL du webhook ?
L'URL n'existe qu'une fois l'automatisation créée. Suivez ces étapes, puis copiez l'URL dans vos services externes.
1
Validez le webhook
Validez les réglages du déclencheur Webhook entrant.