Comment Envoyer des Webhooks depuis Google Forms

Activer les Webhooks dans Google Forms ​

Pour commencer, installez le module complémentaire Google Forms depuis le Google marketplace. Le module complémentaire s'intitule 'Email Notifications' mais il inclut également la prise en charge de l'envoi de notifications push instantanées vers n'importe quelle URL de webhook.

Ensuite, lancez le module complémentaire et choisissez Webhooks pour Google Forms dans le menu.

Cliquez sur le bouton Créer un Webhook pour intégrer un nouveau webhook à votre Google Forms. Vous pouvez avoir plusieurs webhooks associés au même formulaire Google et il enverra les données des formulaires à toutes les URLs de webhook lorsqu'une nouvelle soumission de formulaire est reçue.

Ajouter l'URL du Webhook et les Paramètres de Requête ​

Sur le premier écran, fournissez un nom unique pour votre webhook (utilisé en interne) et choisissez une méthode de requête HTTP. Vous êtes plus susceptible de faire une requête POST, mais le module webhook prend également en charge les méthodes GET, PUT, PATCH et DELETE.

Ensuite, fournissez l'URL complète du webhook du service web externe que vous souhaitez intégrer avec Google Forms. À des fins de test, je recommande d'utiliser soit le service webhook.site ou requestbin.com pour obtenir une URL unique pour inspecter et tester vos webhooks.

Configuration de l'URL du Webhook

La section Paramètres de Requête vous permet d'ajouter des paramètres personnalisés à l'URL du webhook. Par exemple, si vous envoyez des webhooks depuis plusieurs formulaires, vous pouvez ajouter le paramètre {{Form Id}} à votre URL pour distinguer facilement la source d'un appel webhook particulier.

Autorisation et Authentification​

Vous pouvez configurer votre webhook pour inclure un jeton porteur secret ou un jeton d'accès pour autoriser les appels. Vous pouvez faire une authentification de base avec un identifiant et un mot de passe ou inclure les clés API avec les en-têtes d'authentification.

En-têtes Personnalisés​

Vous pouvez également inclure des en-têtes personnalisés dans votre(s) point(s) de terminaison de webhook. Les clés de l'en-tête peuvent être soit des chaînes de caractères soit des nombres et ne doivent pas inclure d'espaces ou d'autres caractères invalides.

Corps de la Requête​

Le corps de la requête définit la charge utile (réponse du formulaire et données personnalisées) qui est envoyée au service web lorsqu'une entrée de formulaire est reçue. Vous pouvez envoyer la charge utile dans différents formats, notamment JSON, données de formulaire, XML et plus encore.

La charge utile peut contenir des métadonnées de formulaire (comme l'ID du formulaire, l'ID de réponse, l'URL de modification de la réponse) et les réponses de l'utilisateur. Chaque question doit être ajoutée comme une nouvelle paire clé-valeur dans le corps de la requête avec le titre de la réponse entre doubles accolades.

Après avoir terminé la définition de votre webhook, cliquez sur le bouton Test et le module complémentaire enverra une requête HTTP à l'URL de rappel en utilisant les données du formulaire de la réponse la plus récemment reçue de votre Google Form.

Cliquez sur Enregistrer pour activer le webhook.