Webhook instellen

Zo maak je een trigger met een webhook-actie. Bij elke voltooide reactie (eventueel onder bepaalde condities) wordt dan een JSON-bericht naar jouw URL gestuurd.

Wat je nodig hebt

  • Een vragenlijst waar je triggers mag beheren
  • Een eigen URL die HTTP POST-verzoeken kan ontvangen (HTTPS aanbevolen)
  • (Optioneel) Een service zoals webhook.site of ngrok voor het testen

Stap voor stap

1. Maak een trigger aan

  1. Open de vragenlijst en ga naar de tab Triggers.
  2. Klik op Trigger toevoegen .
  3. Geef de trigger een herkenbare Naam, bijvoorbeeld "Webhook naar CRM" of "Slack-notificatie bij voltooiing".
  4. Klik op Trigger toevoegen .

2. Zet de trigger op actief

  1. Op de subtab Trigger zet je de schakelaar Actief aan.
  2. Klik op Trigger opslaan .
Vergeet niet aan te zetten

Een trigger die niet op Actief staat, vuurt nooit af - ook niet als de condities en acties kloppen.

3. Stel de condities in (optioneel)

Wil je dat de webhook altijd afvuurt bij een voltooide vragenlijst? Sla deze stap over.

Wil je alleen bij specifieke antwoorden afvuren?

  1. Ga naar de subtab Condities.
  2. Klik op Groep toevoegen .
  3. Voeg condities toe (bijvoorbeeld: "Vraag X = 'Nee'" of "NPS-score is kleiner dan 7").
  4. Sla op.

Binnen één groep moeten alle condities waar zijn (EN). Met meerdere groepen kun je EN/OF-combinaties maken.

4. Voeg de webhook-actie toe

  1. Ga naar de subtab Acties.
  2. Klik op Actie toevoegen .
  3. Geef de actie een Naam, bijvoorbeeld "POST naar CRM-endpoint".
  4. Kies bij Type action de optie voor een webhook.
  5. Vul bij Webhook url de volledige URL in waar de webhook naartoe moet, bijvoorbeeld https://api.mijnbedrijf.nl/mach3forms/webhook.
  6. Sla de actie op.

5. Test de trigger

  1. Open de vragenlijst (via voorvertoning of een testdeelnemer).
  2. Vul de vragenlijst in tot het einde.
  3. Controleer of jouw webhook-endpoint het bericht heeft ontvangen.

Geen bericht ontvangen? Loop de checklist na:

  • Staat de trigger op Actief?
  • Klopt de URL?
  • Voldoet de testreactie aan de condities?
  • Geeft je endpoint een 2xx-status terug? Bij 4xx/5xx of timeouts wordt het bericht niet bewaard voor latere verzending.

Meerdere acties per trigger

Eén trigger kan meerdere acties bevatten. Bijvoorbeeld: een mail naar een interne medewerker én een webhook naar je CRM. Voeg beide acties toe - ze worden allebei uitgevoerd zodra de trigger afvuurt.

Tip: maak aparte triggers voor verschillende doelen

Een Slack-notificatie bij élke reactie en een CRM-webhook alleen bij negatieve scores? Maak twee aparte triggers met eigen condities. Dat is overzichtelijker dan één trigger met complexe logica.