Aller au contenu principal

Recherche

Laissez-vous guider !

Action : Appeler une API

Avec l'action "Appeler une API" vous pouvez envoyer une requête HTTP à un service externe. 

⬇️ Indispensable pour permettre la réalisation des cas d'usages comme :

  • Déclencher un scénario automatisé dès qu’une ligne est créée ou modifiée.
  • Créer automatiquement une ligne dans un espace de travail ou un autre outil.
  • Transmettre les informations d’un prospect validé vers une base de gestion commerciale.
  • Mettre à jour une base de données externe avec les données saisies dans TimeTonic.
  • Envoyer une notification, un message ou une alerte à un utilisateur final.

➡️ Prérequis

  • URL d’endpoint webhook et méthode HTTP POST.
  • Token ou identifiants pour l’authentification (Bearer token ou Basic).
  • Champs de votre table pour recevoir les paramètres d’entrée et stocker la réponse.

 

➡️ Étapes détaillées

Accédez à votre tableau, ouvrez l’automatisation, insérer votre déclencheur et les conditions, puis

1️⃣ Ajouter l’action

Cliquez sur action ➕ 

2️⃣ Sélectionner → Appeler une API

➡️ Fenêtre de Configuration "Appeler une API"

1️⃣ Insertion de l'URL

 

2️⃣ Authentification :

 

3️⃣  Le contenu du webhook

 

Méthode Sans authentification

ℹ️ N'utilisez pas de méthode d'authentification, dans ce cas votre appel n'est pas sécurisé.

➡️ Dans TimeTonic

Configurer l’appel HTTP

Remplissez les champs suivants :

Paramètre Valeur
Méthode POST
URL Champ d'insertion URL du Webhook provenant de l'outil extérieur
Paramètre Valeur

➡️ Dans l'outil extérieur

  1. Créer un Webhook

    Remplissez les champs suivants :

Paramètre Valeur
Méthode POST
URL de l'API URL
Authentification aucune

 

⬇️ Voir étape par étape → méthode sans authentification

Cette vidéo montre comment configurer un appel API vers n8n sans ajouter d'authentification.

 

 

Méthode Bearer token pour un jeton d'accès

ℹ️ Créer un jeton d'authentification pour protéger l'accès

Dans TimeTonic

  1. Configurer l’appel HTTP
    Remplissez les champs suivants 
Paramètre Valeur
Méthode POST
URL POST Champ d'insertion URL du Webhook provenant de l'outil extérieur
Authentification Sélectionnez Utiliser Bearer token
Entrer un jeton d'accès [définir un jeton d'accés]
Paramètre Valeur

 

Dans l'outil extérieur

  1. Créer un Webhook

  2. Configurer l’authentification

    Remplissez les champs suivants :

Paramètre Valeur
Méthode POST
URL de l'API Production URLtest URL
Authentification Sélectionnez Bearer Auth
Nom d'en-tête Authorization
Valeur de l'en-tête attendu Bearer 123456  (remplacez par le token utilisé dans TimeTonic)

 

 

⬇️ Voir étape par étape → méthode avec authentification Bearer

Utilisation du mode Bearer dans TimeTonic pour sécuriser l'appel HTTP.

 

 

 

Utiliser Basic authentification

ℹ️ Pour sécuriser l'appel, utiliser un couple nom utilisateur / mot de passe

Dans TimeTonic

  1. Configurer l’appel HTTP
    Remplissez les champs suivants :

Paramètre Valeur
Méthode POST
URL de l’API Collez l’URL du Webhook de l'outil extérieur
Authentification Authentification basic
Nom [définir le nom]
Mot de passe [définir le mot de passe]

 

Dans l'outil extérieur

  1. Créer un Webhook

Configurer l’authentification

Remplissez les champs suivants :

Paramètre Valeur
Méthode POST
URL de l’API URL
Authentification Sélectionnez Basic Auth
Nom [identique à celui dans timetonic]
Mot de passe [identique à celui dans timetonic]

 

⬇️ Voir étape par étape → méthode Basic Authentification

Connexion à l'API via identifiants login/mot de passe (Basic Auth).

 

 

Enfin, dans la dernière partie de configuration, vous allez

3️⃣ Définir les données (propriétés et valeurs) à envoyer à l'API

 

Insérer les données à envoyer à l'API via la requête

Chaque ligne ajoutée représente une paire clé/valeur à transmettre.

Comment configurer ?

 

Élément Description
Nom de la propriété Nom de la propriété JSON attendue par l’API. Par exemple : test call
Valeur

Valeur que vous souhaitez envoyer :

• Soit une valeur fixe :
Par exemple "Toto", "OK"

• Soit une variable dynamique, par exemple (ex. $ChampInput) Cela permet d’envoyer une valeur issue d’un champ de la ligne TimeTonic, comme une description, un nom, une date...

 

Exemple :

Vous voulez envoyer la valeur du champ Description d’une ligne TimeTonic dans une propriété JSON appelée test call.

Vous insérez ⬇️

Cela génère automatiquement le JSON suivant :

{ 

"test call": Contenu du champ "Description" de la ligne TimeTonic 

}

📌 Vous pouvez ajouter plusieurs lignes si l'API attend plusieurs champs à l'aide du bouton ➕

 

5️⃣ Valider et tester

Cliquez sur Valider, puis activez l’automatisation.

Testez : modifiez ou créez une ligne pour déclencher l’appel API, Vérifiez que l’outil externe a bien reçu l’appel API.

Aidez-nous à améliorer notre contenu : cet article vous a-t-il été utile ?
Utilisateurs qui ont trouvé cela utile : 3 sur 4
Retour en haut