Envoyer des données à un autre système

L'étape Envoyer une requête HTTP appelle une URL lorsqu'une automatisation l'atteint. Utilisez-la pour transmettre les détails d'une réservation à vos propres outils, à un service de tableur ou à tout système qui accepte des requêtes web. Cette étape nécessite le forfait Ultimate.

1. 1

   Étape 1 sur 5

   Ajoutez l'étape

   Dans l'éditeur, cliquez sur Ajouter l'étape suivante et choisissez Envoyer une requête HTTP. Cliquez sur la nouvelle étape pour ouvrir ses paramètres.

2. 2

   Étape 2 sur 5

   Définissez la méthode et l'URL

   Choisissez une Méthode : GET, POST, PUT, PATCH ou DELETE. Saisissez l'URL, qui commence par https:// ou http://. L'URL peut contenir des variables, par exemple https://example.com/clients/{{ $event.data.object.client.id }}.

3. 3

   Étape 3 sur 5

   Ajoutez un corps

   Pour POST, PUT, PATCH et DELETE, réglez Type de contenu sur application/json et rédigez le Corps en JSON. Cliquez sur Insérer une variable pour ajouter des valeurs.

   Lorsqu'une variable constitue la valeur entière d'un champ JSON, elle conserve son type. Par exemple, dans {"appointment": "{{ $event.data.object }}"}, le rendez-vous est envoyé sous forme d'objet, et non de texte. La mise en forme et les espaces n'ont pas d'importance.

4. 4

   Étape 4 sur 5

   Ajoutez des en-têtes si nécessaire

   Cliquez sur Afficher les options avancées, puis sur Ajouter un en-tête pour chaque en-tête, comme une clé d'autorisation. Saisissez un Nom de l'en-tête et une Valeur de l'en-tête.

5. 5

   Étape 5 sur 5

   Enregistrez

   Cliquez sur Enregistrer dans la fenêtre, puis sur Enregistrer en haut de l'éditeur.

   Vous verrez:

   L'étape affiche la méthode et l'URL, par exemple Envoyer une requête HTTP POST vers votre URL.

Utiliser la réponse

Les étapes suivantes peuvent lire la réponse via $previousNode :

• {{ $previousNode.response.status }} : le code de statut, comme 200
• {{ $previousNode.response.statusText }} : le texte du statut, comme OK
• {{ $previousNode.response.body }} : le corps de la réponse
• {{ $previousNode.response.headers }} : les en-têtes de la réponse

Par exemple, ajoutez un Branchement conditionnel qui vérifie {{ $previousNode.response.status === 200 }}.

Limites

Les requêtes qui dépassent une limite ne sont pas envoyées. L'étape est ignorée et l'exécution continue.

Les requêtes vers des adresses de réseau privé ou interne, comme localhost, sont bloquées.

Lorsqu'une exécution échoue

Un statut d'erreur renvoyé par l'autre système, comme 404 ou 500, ne fait pas échouer l'exécution. La réponse est enregistrée et l'étape suivante s'exécute. Vérifiez le statut avec un Branchement conditionnel si c'est important.

L'exécution échoue, et s'arrête, lorsque la requête ne peut pas du tout être effectuée : le système ne répond pas dans les 5 secondes, l'adresse est injoignable, l'URL n'est pas valide ou elle pointe vers une adresse bloquée. L'exécution s'affiche comme Échoué dans Historique.