Webhooks van Google Forms versturen

Met webhooks voor Google Forms kunt u formulierreacties direct naar elke externe webservice sturen zodra iemand een nieuw Google Formulier indient. U kunt bijvoorbeeld webhooks gebruiken om Google Forms reacties automatisch naar uw CRM-tool te sturen. Of u kunt nieuwe items in uw mailinglijstsoftware aanmaken wanneer een nieuwe lead via Google Forms wordt vastgelegd.

De nieuwste versie van de E-mail Notificaties add-on ondersteunt webhooks en kan naast het maken van HTTP-verzoeken naar de webhook callback URL, ook de reactie van de gebruiker en de formuliergegevens in de payload body van het HTTP-verzoek opnemen.

Webhooks voor Google Forms
Webhook Integratie Overzicht

Webhooks in Google Forms Inschakelen

Om te beginnen, installeer de Google Forms add-on vanuit de Google marketplace. De add-on heet 'E-mail Notificaties' maar bevat ook ondersteuning voor het versturen van directe push notificaties naar elke webhook URL.

Start vervolgens de add-on en kies Webhooks voor Google Forms uit het menu.

Klik op de Webhook Aanmaken knop om een nieuwe webhook te integreren met uw Google Forms. U kunt meerdere webhooks koppelen aan hetzelfde Google Formulier en het zal de formuliergegevens naar alle webhook URL's sturen wanneer een nieuwe formulierreactie wordt ontvangen.

Webhook URL en Query Parameters Toevoegen

Op het eerste scherm geeft u een unieke naam voor uw webhook (intern gebruikt) en kiest u een HTTP Verzoek methode. U zult waarschijnlijk een POST verzoek doen, maar de webhook module ondersteunt ook GET, PUT, PATCH en DELETE methoden.

Geef vervolgens de volledige webhook URL op van de externe webservice waarmee u Google Forms wilt integreren. Voor testdoeleinden raad ik aan om de webhook.site of requestbin.com service te gebruiken om een unieke URL te krijgen voor het inspecteren en testen van uw webhooks.

Webhook Formulier URL
Webhook URL Configuratie

In het Query Parameter gedeelte kunt u aangepaste parameters toevoegen aan de webhook URL. Als u bijvoorbeeld webhooks van meerdere formulieren verstuurt, kunt u de {{Form Id}} parameter aan uw URL toevoegen om gemakkelijk de bron van een bepaalde webhook aanroep te onderscheiden.

Autorisatie en Authenticatie

U kunt uw webhook configureren om een geheime bearer token of toegangstoken op te nemen om de aanroepen te autoriseren. U kunt basisauthenticatie doen met gebruikersnaam en wachtwoord of API-sleutels opnemen in de authenticatieheaders.

Aangepaste Headers

U kunt ook aangepaste headers opnemen in uw webhook endpoint(s). De sleutels van de header kunnen strings of nummers zijn en mogen geen spaties of andere ongeldige tekens bevatten.

Verzoek Body

De verzoek body definieert de payload (formulierreactie en aangepaste gegevens) die naar de webservice wordt gestuurd wanneer een formulierreactie wordt ontvangen. U kunt de payload in verschillende formaten versturen, waaronder JSON, Form data, XML en meer.

webhook verzoek body

De payload kan formulier metadata bevatten (zoals het formulier ID, reactie ID, reactie Bewerk URL) en de antwoorden van de gebruiker. Elke vraag moet worden toegevoegd als een nieuwe sleutel-waarde paar in de verzoek body met de antwoordtitel tussen dubbele accolades.

Nadat u klaar bent met het definiëren van uw webhook, klikt u op de Test knop en de add-on zal een HTTP-verzoek maken naar de callback URL met behulp van formuliergegevens van de meest recent ontvangen reactie van uw Google Formulier.

Klik op Opslaan om de webhook in te schakelen.