n8n-workflow: webhook naar CRM

Flowstate n8n-productiegate v1.0 · webhook naar CRM

Deze template ontvangt een formulier- of systeemevent, normaliseert de invoer, voorkomt een tweede verwerking van hetzelfde event en kiest tussen een nieuw contact, bestaand contact of menselijke beoordeling.

Versie 1.0 · gepubliceerd en inhoudelijk gecontroleerd op 28 juli 2026 · Nederlands · gratis te gebruiken en aan te passen

Download de n8n-workflow (JSON)

Wat doet de workflow?

  1. Webhook: ontvangt een POST-event op het ingestelde pad.
  2. Edit Fields: bewaart omgevingswaarden zoals dry_run, API-basis-URL en CRM-paden.
  3. Code — Normalize Intake: maakt e-mail lowercase, bouwt een eenduidig datamodel en verzamelt validatiefouten.
  4. If: stuurt ongeldige invoer naar een 422-response en geldige invoer naar deduplicatie.
  5. Data Table: controleert of event_id eerder is verwerkt.
  6. HTTP Request / dry-run: zoekt een CRM-match of simuleert die veilig.
  7. Code — Classify CRM Match: kiest nieuw, bestaand of review.
  8. HTTP Request / reviewtaak: schrijft alleen via de gekozen route.
  9. Respond to Webhook: geeft accepted, duplicate, invalid_input of een begrensde foutstatus terug.

Velden die je moet invullen

dry_run
Laat op true tot alle routes met testdata zijn gecontroleerd.
crm_api_base
De basis-URL van jouw CRM-API, zonder credential in de tekstwaarde.
crm_contact_search_path
Pad waarmee je op een stabiele sleutel zoekt, bij voorkeur extern ID of genormaliseerde e-mail.
crm_contact_upsert_path
Pad voor gecontroleerd aanmaken of wijzigen. Controleer method, bodyvorm en verwachte response.
crm_task_path
Pad voor de opvolg- of controletaak.
review_queue_id
Bestaande wachtrij of eigenaar voor onzekere matches; vervang de placeholder.
HTTP Header Auth
Koppel in n8n een credential aan iedere CRM-node. Plaats tokens nooit in JSON, expressions of notities.

De Webhook verwacht minimaal event_id en email. Optionele velden zijn service, first_name, company en source_url. Pas propertynamen alleen aan wanneer je ook de normalisatie, zoekquery en tests wijzigt.

Minimale testmatrix

  • Geldig nieuw event → accepted in dry-run.
  • Hetzelfde event_id opnieuw → duplicate en geen tweede bedrijfsactie.
  • Ontbrekende of ongeldige e-mail → 422 invalid_input.
  • Exact één CRM-match → bestaande-contactroute.
  • Geen match → gecontroleerde upsert.
  • Meerdere of onzekere matches → reviewtaak, geen automatische merge.
  • Tijdelijke CRM-fout → geen vals succes; begrensde retry of error workflow.

Beperkingen en productievoorwaarden

De export kent de responsevorm en propertynamen van jouw CRM niet. Controleer daarom ieder HTTP Request-veld, de authenticatiemethode, paginering, rate limits en foutcodes. Een bedrijfsnaam alleen is geen veilige unieke sleutel. Leg logging, bewaartermijn en terugvalroute vast voordat dry_run uitgaat.

De volledige uitleg staat in n8n-workflow maken. De template is gemaakt voor n8n 2.x; controleer bij import of nodes door jouw actuele n8n-versie zijn gemigreerd.

Integriteitscontrole: SHA-256 van versie 1.0: 16c20f3a539cd8fdbda1dd67c87acd303e5446dd6180dc10184d441331b0cab3. Een andere hash betekent dat het bestand is gewijzigd.