## É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 lancera la transmission des données.
Le Nœud Webhook fonctionne comme un mécanisme d'envoi sans attente. Cela signifie qu'il envoie immédiatement la requête HTTP lorsqu'il est déclenché, mais n'attend pas la réponse du serveur et ne la stocke pas.
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 de calcul 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\_matinal\_de\_Carburant",*
*"device\_id": "{{device\_label}}",*
*"horodatage": "{{comb\_current\_time}}"*
*}*
Vous pouvez inclure des attributs supplémentaires de IoT Logic ou des paramètres 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 de calcul Google
Ouvrez votre feuille de calcul Google, cliquez sur Extensions, puis sélectionnez Apps Script.
Cela ouvrira le fichier Code.gs, où 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 par le nœud Webhook et les ajouter comme une nouvelle ligne dans votre feuille de calcul 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("Access Denied").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);*
*}*
**Remarque**: Remplacez le code d'exemple 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 depuis le Nœud Webhook d’IoT Logic.
Lorsqu’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 puissent é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 invalide (Accès refusé).
Important : les noms de champ utilisés dans le script doivent correspondre exactement aux noms de 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 d'Apps Script
Si vous devez modifier Apps Script ultérieurement, 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 offre un moyen simple et efficace d'enregistrer des données de télémétrie, des paramètres externes ou des attributs personnalisés IoT Logic à des fins de création de rapports, d'analyse, d'audit ou d'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 dynamically by asking a question. Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter: ``` 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=