## Étape 1. Ajouter le nœud Webhook
Une fois votre flux IoT Logic créé, ajoutez un nœud Webhook et connectez-le au déclencheur qui initiera la transmission des données.
Le nœud Webhook fonctionne comme un mécanisme d'envoi sans attente de réponse. Cela signifie qu'il envoie la requête HTTP immédiatement lorsqu'il est déclenché, mais n'attend pas et ne stocke pas la réponse du serveur.
Après avoir ajouté le nœud Webhook, configurez-le comme suit.
#### URL
Saisissez l'URL de l'application Web Google Apps Script associée à la feuille Google Sheets vers laquelle vous souhaitez envoyer les informations.
#### En-têtes
Ajoutez l'en-tête HTTP suivant :
| Clé | Valeur |
| --------------- | ---------------- |
| Type de contenu | application/json |
#### Corps
Le corps de la requête doit être au format JSON. Il doit inclure la clé d’authentification et toutes les données que vous souhaitez envoyer à Google Sheets.
Exemple :
*{*
*"key": "MY\_SUPER\_SECRET\_123",*
*"événement": "rapport\_du\_matin\_sur\_le\_Carburant",*
*"device\_id": "{{device\_label}}",*
*"timestamp": "{{comb\_current\_time}}"*
*}*
Vous pouvez inclure tout attribut IoT Logic supplémentaire ou paramètre de télémétrie en utilisant leurs espaces réservés correspondants.
Remarque : le champ « key » est requis si votre Google Apps Script utilise un secret partagé pour authentifier les requêtes Webhook entrantes. Remplacez « MY\_SUPER\_SECRET\_123 » par le secret configuré dans votre Google Apps Script.
## Étape 2. Configurer la feuille Google
Ouvrez votre feuille Google, cliquez sur Extensions, puis sélectionnez Apps Script.
Cela ouvrira le fichier Code.gs, dans lequel vous ajouterez le script chargé de recevoir les requêtes Webhook et d'écrire les données dans la feuille de calcul.
Le code d'exemple suivant peut être utilisé pour recevoir les valeurs envoyées depuis le nœud Webhook et les ajouter en tant que nouvelle ligne dans votre feuille Google.
*function doPost(e) {*
*var SECRET\_KEY = "MY\_SUPER\_SECRET\_123";*
*var data = JSON.parse(e.postData.contents);*
*if (data.key !== SECRET\_KEY) {*
*return ContentService.createTextOutput("Accès refusé").setMimeType(ContentService.MimeType.TEXT);*
*}*
*var sheet = SpreadsheetApp.getActiveSpreadsheet().getActiveSheet();*
*sheet.appendRow(\[*
*new Date(),*
*data.name || "",*
*data.device\_id || "",*
*data.longitud || "",*
*data.latitud || ""*
*]);*
*return ContentService.createTextOutput("Success").setMimeType(ContentService.MimeType.TEXT);*
*}*
**Note**: Remplacez l'exemple de code ci-dessus par le script fourni ci-dessous. Vous pouvez également personnaliser les champs pour qu'ils correspondent aux données envoyées depuis votre Webhook IoT Logic.
Le script ci-dessus agit comme un point de terminaison HTTP POST qui reçoit les requêtes envoyées par le nœud Webhook IoT Logic.
Chaque fois qu’une requête est reçue, le script valide d’abord un secret partagé (SECRET\_KEY) afin de garantir que seules les requêtes Webhook autorisées peuvent écrire des données dans la feuille Google. Si l’authentification réussit, la charge utile JSON est analysée et les paramètres spécifiés — tels que l’horodatage de réception, le nom de l’appareil, l’ID de l’appareil, la longitude, la latitude ou toute autre valeur de télémétrie — sont automatiquement ajoutés comme une nouvelle ligne dans la feuille de calcul.
Enfin, le script renvoie une réponse indiquant si l’opération a été menée à bien avec succès (Succès) ou rejetée en raison d’une clé d’authentification non valide (Accès refusé).
Important : Les noms de champ utilisés dans le script doivent correspondre exactement aux noms des paramètres envoyés par le Webhook IoT Logic. Chaque valeur est accessible à l’aide de la syntaxe data.\
Sélectionnez Nouveau déploiement, puis choisissez Application web dans le menu du type de déploiement. Le processus de déploiement peut prendre quelques instants. Une fois terminé, une URL de l'application web sera générée. Copiez cette URL et collez-la dans le champ URL du nœud Webhook dans votre flux IoT Logic. L'URL de l'application web est le point de terminaison qui recevra les requêtes HTTP POST envoyées par le nœud Webhook.
#### Mise à jour du script Apps Script
Si vous devez modifier le script Apps Script par la suite, vous n'avez pas besoin de créer un nouveau déploiement.
Au lieu de cela, cliquez sur Déployer → Gérer les déploiements, sélectionnez le déploiement existant, puis cliquez sur Modifier (icône crayon). Après avoir enregistré et redéployé la version mise à jour, les modifications apportées au script prendront effet immédiatement tout en conservant la même URL de l'application web.
Cela vous permet de mettre à jour le script sans avoir à modifier la configuration du Webhook dans IoT Logic.
Après avoir terminé toutes les étapes décrites dans ce guide, la connexion entre IoT Logic et Google Sheets devrait être établie avec succès.
Cette intégration fournit un moyen simple et efficace d'enregistrer des données de télémétrie, des paramètres externes ou des attributs personnalisés d'IoT Logic pour la création de rapports, l'analyse, l'audit ou l'intégration avec d'autres outils Google Workspace.
--- # Agent Instructions This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com. ## Querying This Documentation If you need additional information that is not directly available in this page, you can query the documentation by asking a question. Perform an HTTP GET request on the following URL with the `ask` and `goal` query parameters: ``` GET https://navixy.com/docs/expert-center/fr/faq-and-troubleshooting/iot-logic/how-to-connect-an-iot-logic-webhook-node-to-google-sheets.md?ask=