Lead Flow - End-to-End Architectuur

Dit document beschrijft de volledige lead flow vanaf het moment dat een bezoeker een formulier invult op seanvermond.com tot het aanmaken van records in Twenty CRM.

Flow Overzicht

Contactformulier (/api/contact)

Volledige lead met naam, email, bedrijf en bericht.

• Route: /api/contact
• Methode: POST
• Velden: naam, email, telefoon, bedrijf, bericht
• CRM: Persoon + Bedrijf aangemaakt

Terugbelformulier (/api/callback)

Minimale lead met alleen telefoonnummer.

• Route: /api/callback
• Methode: POST
• Velden: telefoonnummer
• CRM: Alleen persoon aangemaakt

Technische Details

• Website bestanden: src/lib/webhook.ts
• Env vars op website: LEAD_WEBHOOK_URL, LEAD_WEBHOOK_SECRET
• Fire-and-forget patroon: website wacht niet op webhook response
• Twenty parseert +31 telefoonnummers automatisch naar countryCode NL

Verificatie

De volledige flow is end-to-end geverifieerd op 2026-02-28. Test door een formulier in te vullen op seanvermond.com en het resultaat te controleren in Twenty CRM.