Leadbeheer-werkstroom

Dit document beschrijft hoe klantenaanvragen (leads) worden aangemaakt, opgeslagen, beoordeeld en verwerkt in de ADP Car Market Hub plugin. Het behandelt leadgegevens, statusbeheer, CSV-export, e-mailroutering, toestemmingsconfiguratie, het aanpassen van e-mailsjablonen en webhook-integratie.

Wanneer u dit document moet gebruiken

Lees dit document als u:

• Klantenaanvragen die via voertuigdetailpagina's zijn binnengekomen wilt bekijken, verwerken of exporteren.
• Het e-mailadres van de ontvanger, het toestemmingsselectievakje of de e-mailnotificatiesjablonen configureert.
• Leads wilt doorsturen naar een extern CRM- of notificatiesysteem via een webhook.
• Wilt begrijpen welke gegevens worden opgeslagen en hoe leads zijn gekoppeld aan voertuiggegevens.

Zie Dagelijkse werkstromen voor een snelle dagelijkse controleworkflow.

---

Overzicht

Wanneer een bezoeker een contactaanvraag of proefritaanvraag indient op een voertuigdetailpagina, doet de plugin het volgende:

1. Valideert de inzending (verplichte velden, nonce-verificatie, honeypot-spambeveiliging, snelheidslimiet).
2. Verstuurt een HTML-notificatiemail naar de geconfigureerde ontvanger.
3. Verstuurt een HTML-bevestigingsmail naar de bezoeker.
4. Slaat de lead op als een WordPress custom post (as24ci_lead).
5. Activeert de as24ci_lead_saved action hook (die de webhook activeert indien geconfigureerd).
6. Registreert een lead_sent analytics-gebeurtenis (als Analytics is ingeschakeld).

Alle leads zijn toegankelijk in het beheerderspaneel via het tabblad ADP Car Market Hub → Leads.

---

Vereisten of randvoorwaarden

• Een voertuigdetailpagina moet toegankelijk zijn voor bezoekers en het contactformulier moet ingeschakeld zijn.
• Om e-mailnotificaties te kunnen afleveren, moet WordPress e-mail kunnen verzenden via wp_mail(). Op veel gedeelde hostingomgevingen werkt dit direct uit de doos. Op sommige servers kan een SMTP-plugin vereist zijn.
• Het veld E-mailadres ontvanger op het tabblad Leads moet geconfigureerd zijn om ervoor te zorgen dat notificaties naar het juiste adres gaan.
• Om de proefritfunctie te gebruiken, moet deze zijn ingeschakeld in Features en moeten de beschikbare dagen, het tijdvenster en de duur van de tijdsloten zijn geconfigureerd op het tabblad Leads.

---

Leadgegevensvelden

Elke lead slaat de volgende informatie op:

---

Stapsgewijze instructies

Leads beoordelen

1. Navigeer naar ADP Car Market Hub → Leads.
2. De lijst met leads is gesorteerd met de meest recente inzendingen bovenaan.
3. Elke rij toont: datum, naam, e-mailadres, telefoonnummer, voertuig, bericht (ingekort) en de huidige status.
4. Gebruik het zoekveld om leads te zoeken op naam, e-mailadres, voertuigtitel of AutoScout24 listing-ID.
5. Gebruik het statusfilter om alleen leads met een specifieke status te tonen (Nieuw, Gecontacteerd, Gesloten of Spam).
6. Klik op een leadrij om de volledige details te bekijken, inclusief de link naar het voertuig en de afspraakdatum.

Leadstatus wijzigen

De leadstatus houdt bij waar elke aanvraag zich bevindt in uw verkoopproces:

Om de status van een lead te wijzigen:

1. Zoek de lead op het tabblad Leads.
2. Selecteer de nieuwe status in de status-dropdown naast de lead.
3. De wijziging wordt direct opgeslagen.

Leads exporteren naar CSV

1. Navigeer naar ADP Car Market Hub → Leads.
2. Pas eventueel een zoekfilter of statusfilter toe om slechts een selectie van de leads te exporteren.
3. Klik op de knop Exporteer CSV.
4. Er wordt een CSV-bestand gedownload. De bestandsnaam bevat de huidige datum (bijvoorbeeld leads-2026-04-30.csv).
5. Het CSV-bestand bevat een UTF-8 BOM, zodat het correct wordt geopend in Microsoft Excel zonder coderingsproblemen.
6. De CSV-kolommen zijn: Datum, Naam, E-mailadres, Telefoonnummer, Voertuigtitel, Voertuig-ID, Bericht, Proefrit (Ja/Nee), Afspraak.

Een lead verwijderen

1. Zoek de lead op het tabblad Leads.
2. Klik op de knop Verwijderen naast de lead.
3. Bevestig de verwijdering wanneer hierom wordt gevraagd. Dit verwijdert de lead en de bijbehorende metadata permanent.

---

Leadinstellingen configureren

Leadinstellingen zijn te vinden op het tabblad ADP Car Market Hub → Leads (sectie Instellingen).

E-mailadres ontvanger

De plugin gebruikt de volgende prioriteitsvolgorde om te bepalen waar leadnotificatiemails naartoe worden gestuurd:

1. Globale overschrijving e-mailadres ontvanger (tabblad Leads → veld E-mailadres ontvanger). Ondersteunt een door komma's gescheiden lijst van e-mailadressen om naar meerdere ontvangers te verzenden.
2. CMH Team contactpersoon — het e-mailadres van het actieve teamlid dat aan het voertuig is gekoppeld (toewijzing per voertuig, vestigingsstandaard of globale standaard). Zie CMH Team and Contact Routing.
3. Openbaar e-mailadres van verkopersprofiel (opgeslagen als as24ci_seller_email user meta op het gebruikersaccount van de auteur van het voertuig).
4. WordPress-account e-mailadres van de auteur van het voertuig.
5. WordPress beheerders-e-mailadres (Instellingen → Algemeen → Beheerders-e-mailadres) als definitieve terugvaloptie.

Om alle leadnotificaties naar een of meer vaste adressen te sturen, voert u deze in het veld E-mailadres ontvanger op het tabblad Leads in. Wanneer de regel Stuur een kopie naar het algemene e-mailadres van het autobedrijf is ingeschakeld in CMH Team, ontvangt het algemene e-mailadres van het autobedrijf ook een kopie van elke aanvraag.

Zichtbaarheid van formuliervelden

De velden Naam en E-mailadres worden altijd getoond. De volgende velden kunnen afzonderlijk worden in- of uitgeschakeld:

• Telefoonnummerveld — toon of verberg het telefoonveld op het contactformulier.
• Berichtveld — toon of verberg het vrije tekstveld voor berichten. Indien uitgeschakeld, is een bericht niet verplicht en bevatten leads geen berichttekst.

Toestemmingsselectievakje

• Toestemmingsselectievakje inschakelen — indien ingeschakeld, wordt er een toestemmingsselectievakje getoond op het contactformulier. De bezoeker moet dit aanvinken voordat het formulier kan worden verzonden.
• Toestemmingstekst — het label dat naast het selectievakje wordt getoond. Bevat meestal een verwijzing naar uw privacybeleid.
• Privacybeleid-URL — URL van uw privacybeleidspagina. Kan worden gelinkt vanuit de toestemmingstekst.

Deze instellingen worden opgeslagen volgens de opties van de plugin en worden direct toegepast op het contactformulier aan de frontend.

---

E-mailsjablonen

De plugin ondersteunt aangepaste e-mailonderwerpen en berichtsjablonen voor zowel de notificatie aan de dealer als de bevestiging aan de klant.

Sjablonen ondersteunen de volgende {placeholder} tokens:

E-mail voor dealer:

• Onderwerp — pas het onderwerp van de notificatiemail aan die naar de ontvanger wordt verzonden. Indien leeg gelaten, wordt het standaardonderwerp gebruikt ("Voertuigaanvraag: {vehicletitle}" of "Proefritaanvraag: {vehicletitle}").
• Inhoud — volledige HTML-e-mailinhoud. Indien leeg gelaten, wordt het standaardsjabloon gebruikt.

Bevestigingsmail voor klant:

• Onderwerp — pas het onderwerp van de bevestiging aan die naar de bezoeker wordt verzonden.
• Inhoud — volledige HTML-bevestigingsinhoud.

Wanneer aangepaste sjablonen zijn geconfigureerd, vervangen deze de standaardinhoud volledig. De Reply-To header van de notificatiemail voor de dealer wordt ingesteld op de naam en het e-mailadres van de klant.

---

Webhook-integratie

De plugin kan uitgaande webhooks activeren bij leadgebeurtenissen voor integratie met externe systemen (CRM, Slack, Zapier, enzovoort).

Configuratie vindt plaats in de instellingen voor Leads:

De webhook-payload voor een nieuwe lead bevat: gebeurtenisnaam (new_lead), tijdstempel, lead-ID en leadgegevens (naam, e-mailadres, telefoonnummer, bericht, voertuig-ID, voertuigtitel, voertuig-URL).

Mislukte webhook-leveringen worden tot 3 keer opnieuw geprobeerd via WP-Cron.

De HMAC-SHA256-handtekening is opgenomen in de verzoekheader en kan door het ontvangende eindpunt worden gebruikt om de authenticiteit te verifiëren. Deel het webhook-geheim niet openbaar.

---

Operationele opmerkingen

• Snelheidslimiet (rate limiting): het contactformulier accepteert maximaal 5 inzendingen per IP-adres per 5 minuten. Inzendingen die deze limiet overschrijden, ontvangen een foutmelding zonder dat er een lead wordt aangemaakt of een e-mail wordt verzonden.
• Honeypot-spambeveiliging: het contactformulier bevat een verborgen veld dat mensen leeg laten, maar dat geautomatiseerde bots meestal invullen. Wanneer het honeypot-veld is ingevuld, wordt de inzending geruisloos geweigerd.
• Leadopslag: leads worden opgeslagen als WordPress custom posts (as24ci_lead). Ze zijn niet openbaar zichtbaar en verschijnen niet in standaard berichtenlijsten, tenzij ze worden geopend via het tabblad Leads in het beheerpaneel.
• Gegevensbewaring: leads blijven in WordPress totdat ze handmatig worden verwijderd of totdat de plugin wordt gedeïnstalleerd met de optie "Gegevens verwijderen bij deïnstallatie" ingeschakeld in de Instellingen.
• Proefritleads: proefritboekingen worden ook opgeslagen als leads met is_test_drive = 1 en een appointment_date. Ze verschijnen op hetzelfde tabblad Leads en in de CSV-export naast reguliere contactaanvragen.
• Analytics-tracking: wanneer een lead succesvol is opgeslagen en de Analytics-functie is ingeschakeld, wordt er een lead_sent gebeurtenis geregistreerd voor het voertuig.
• Meerdere ontvangers: om leadnotificaties naar meerdere e-mailadressen te sturen, voert u deze in als een door komma's gescheiden lijst in het veld E-mailadres ontvanger.

---

Probleemoplossing

---

Gerelateerde documenten

• Dagelijkse werkstromen
• Gebruikershandleiding
• Beheerdershandleiding
• Voertuigimport-workflow
• Gebruikersworkflow voor de frontend

---