Webhooks für Google Forms einrichten

Webhooks in Google Forms aktivieren ​

Installieren Sie zunächst das Google Forms Add-on aus dem Google Marketplace. Das Add-on heißt "E-Mail-Benachrichtigungen", unterstützt aber auch das Senden von Sofort-Benachrichtigungen an jede Webhook-URL.

Starten Sie dann das Add-on und wählen Sie Webhooks für Google Forms aus dem Menü.

Klicken Sie auf die Schaltfläche Webhook erstellen, um einen neuen Webhook mit Ihrem Google Formular zu integrieren. Sie können mehrere Webhooks mit demselben Google Formular verknüpfen, und es sendet die Formulardaten an alle Webhook-URLs, wenn eine neue Formularübermittlung empfangen wird.

Webhook-URL und Abfrageparameter hinzufügen ​

Geben Sie auf dem ersten Bildschirm einen eindeutigen Namen für Ihren Webhook an (intern verwendet) und wählen Sie eine HTTP-Anfragemethode. Sie werden wahrscheinlich eine POST-Anfrage verwenden, aber das Webhook-Modul unterstützt auch GET, PUT, PATCH und DELETE-Methoden.

Geben Sie als Nächstes die vollständige Webhook-URL des externen Webdienstes an, den Sie mit Google Forms integrieren möchten. Für Testzwecke empfehle ich die Verwendung des webhook.site oder requestbin.com Dienstes, um eine eindeutige URL zum Überprüfen und Testen Ihrer Webhooks zu erhalten.

Webhook-URL-Konfiguration

Im Abschnitt "Abfrageparameter" können Sie benutzerdefinierte Parameter an die Webhook-URL anhängen. Wenn Sie beispielsweise Webhooks von mehreren Formularen senden, können Sie den Parameter {{Form Id}} an Ihre URL anhängen, um die Quelle eines bestimmten Webhook-Aufrufs leicht zu unterscheiden.

Autorisierung und Authentifizierung​

Sie können Ihren Webhook so konfigurieren, dass er ein geheimes Bearer-Token oder Zugriffstoken enthält, um die Aufrufe zu autorisieren. Sie können eine einfache Authentifizierung mit Benutzername und Passwort durchführen oder API-Schlüssel mit den Authentifizierungs-Headern einbinden.

Benutzerdefinierte Header​

Sie können auch benutzerdefinierte Header in Ihren Webhook-Endpunkt(en) einbinden. Die Schlüssel des Headers können entweder Zeichenfolgen oder Zahlen sein und dürfen keine Leerzeichen oder andere ungültige Zeichen enthalten.

Anfrage-Body​

Der Anfrage-Body definiert die Nutzdaten (Formularantwort und benutzerdefinierte Daten), die an den Webdienst gesendet werden, wenn ein Formulareintrag empfangen wird. Sie können die Nutzdaten in verschiedenen Formaten senden, einschließlich JSON, Formulardaten, XML und mehr.

Die Nutzdaten können Formular-Metadaten (wie Formular-ID, Antwort-ID, Antwort-Bearbeitungs-URL) und Benutzerantworten enthalten. Jede Frage sollte als neues Schlüssel-Wert-Paar im Anfrage-Body hinzugefügt werden, wobei der Antworttitel in doppelte geschweifte Klammern eingeschlossen wird.

Nachdem Sie Ihren Webhook definiert haben, klicken Sie auf die Schaltfläche "Testen", und das Add-on sendet eine HTTP-Anfrage an die Callback-URL unter Verwendung der Formulardaten aus der zuletzt empfangenen Antwort Ihres Google Formulars.

Klicken Sie auf "Speichern", um den Webhook zu aktivieren.