Documentatie · Beheerdersreferentie

Beheerdersreferentie voor Leads

Dit document is een referentie voor het scherm Leads van de ADP Car Market Hub plugin (Car Market Hub → Leads). Het behandelt de lead-inbox, de configuratie van het contactformulier, toestemmings- en privacyopties, meldingsberichten, de Test Drive Booking-module, webhooks en e-mailsjablonen.

Wanneer u dit document moet gebruiken

Gebruik deze referentie wanneer u inzendingen van contactformulieren wilt bekijken, wilt wijzigen welke velden in het formulier verschijnen, wilt voldoen aan de AVG-toestemmingsvereisten, wilt configureren wie e-mailmeldingen voor leads ontvangt, wilt integreren met een extern CRM via webhooks, of de Test Drive Booking-functie wilt inschakelen op pagina's van individuele voertuigen.

Overzicht

Het scherm Leads is onderverdeeld in een tabel Lead Inquiries en een reeks instellingenkaarten die als volgt zijn georganiseerd:

  1. Lead Inquiries — doorzoekbare, gepagineerde lijst van alle inzendingen met bulkacties en CSV-export.
  2. Recipient Email Override + Form Fields (rij naast elkaar).
  3. Consent & Privacy + Notification Messages (rij naast elkaar).
  4. Test Drive Booking (kaart over de volledige breedte).
  5. Webhooks.
  6. Email Templates.

Alle instellingenkaarten delen hetzelfde formulier, dus het opslaan van een van de kaarten slaat de hele pagina op.

Vereisten of randvoorwaarden

  • Toestemming om de plugin te beheren.
  • Werkende WordPress-mail. De plugin maakt gebruik van standaard WordPress-e-mail; als uw site geen e-mail kan verzenden, configureer dan SMTP apart.
  • Voor webhooks: een extern eindpunt dat HTTPS POST-verzoeken kan accepteren.
  • Voor Test Drive Booking: schakel de functieschakelaar in en definieer ten minste het tijdvenster.

Stapsgewijze instructies

Leads bekijken en beheren

  1. Open Car Market Hub → Leads.
  2. Gebruik het veld Search om te filteren op naam, e-mailadres, berichttekst of voertuig.
  3. De tabel toont elke inzending met de kolommen Date, Name, Email, Phone, Vehicle, Type, Appointment en Actions. De waarde Vehicle linkt naar de live advertentie (opent in een nieuw tabblad); de badge Type geeft aan of de lead een Inquiry (aanvraag) of een Test Drive (proefrit) is.
  4. Klik op het pictogram View (oog) in een rij om de modal Lead Details te openen (Date, Name, Email, Phone, Vehicle, Type, Appointment, Message).
  5. Klik op het pictogram Delete (prullenbak) om een enkele lead te verwijderen, of vink rijen aan en gebruik de bulkactie Delete selected + Apply om er meerdere tegelijk te verwijderen.
  6. Gebruik Export CSV in de werkbalk om alle leads te downloaden die aan het huidige filter voldoen.

Het contactformulier configureren

  1. Laat in Recipient Email Override het veld leeg om de terugvalketen te gebruiken (openbaar e-mailadres van de verkoper → e-mailadres van het WordPress-account → e-mailadres van de sitebeheerder), of voer een of meer door komma's gescheiden adressen in.
  2. Schakel in Form Fields de opties Phone en/of Message uit als u deze niet nodig heeft. Name en Email zijn altijd verplicht.
  3. Schakel in Consent & Privacy het selectievakje voor toestemming in, stel de labeltekst in en geef optioneel een URL op voor de privacypagina — de woorden "privacy policy" in het label worden dan gelinkt naar die URL.
  4. Pas in Notification Messages de succes- en foutmeldingen aan die na verzending aan bezoekers worden getoond.
  5. Klik op een willekeurige knop Save Leads settings.

Test Drive Booking inschakelen

  1. Open de kaart Test Drive Booking.
  2. Schakel Enable Test Drive booking in. De live samenvattingsbalk bovenaan de kaart weerspiegelt de actieve configuratie: een statusstip (Active / Inactive), het aantal geselecteerde dagen, het tijdsbereik, het label voor de duur van het tijdslot (bijv. "30 min slots") en een "N blocked dates"-chip wanneer er datums zijn geblokkeerd.
  3. Selecteer bij Available Days de dagen van de week waarop afspraken kunnen worden geboekt. Laat alle vakjes onangevinkt om elke dag toe te staan.
  4. Voeg Blocked Dates toe in het formaat YYYY-MM-DD, één per regel.
  5. Stel Start Time, End Time en Slot Duration (minutes) in (5–480, stappen van 5; minimaal 5 minuten).
  6. Sla de wijzigingen op.

Webhooks configureren voor externe systemen

  1. Voer de New lead webhook URL in om een HTTP POST te ontvangen wanneer een bezoeker het contactformulier verzendt.
  2. Voer de New import webhook URL in om een HTTP POST te ontvangen wanneer een voertuig wordt geïmporteerd of bijgewerkt.
  3. Stel optioneel een Webhook secret in. De plugin ondertekent elk verzoek met HMAC-SHA256 en verzendt de handtekening in de X-AS24CI-Signature-header ter verificatie. Zodra een geheim is opgeslagen, verschijnt er een bevestigingsmelding en verandert de tijdelijke aanduiding van het veld in "Leave empty to keep the current secret" — het opgeslagen geheim wordt alleen overschreven als u een nieuwe waarde typt, dus als u het veld leeg laat, blijft het ongewijzigd.
  4. Sla de wijzigingen op. Laat een URL leeg om die webhook uit te schakelen.

E-mailsjablonen aanpassen

  1. Open de kaart Email Templates.
  2. Bewerk het onderwerp van de dealermelding, het onderwerp van de klantbevestiging en de bijbehorende HTML-e-mailteksten.
  3. Gebruik tijdelijke aanduidingen (placeholders) om lead- en voertuiggegevens in te voegen: {name}, {email}, {phone}, {message}, {vehicle_title}, {vehicle_url}.
  4. Laat een veld leeg om de ingebouwde standaardwaarde te gebruiken.
  5. Sla de wijzigingen op.

Configuratiereferentie

Tabel Lead Inquiries

ElementGedrag
KolommenDate, Name, Email, Phone, Vehicle, Type, Appointment, Actions.
Kolom VehicleLinkt naar de live advertentie; opent in een nieuw tabblad.
Kolom TypeBadge: Inquiry of Test Drive.
SearchFiltert op naam, e-mailadres, berichttekst en voertuig.
Per pageToegestane waarden: 5, 10, 25, 50, 100. Standaard 25.
Acties per rijView (oog) opent de modal Lead Details; Delete (prullenbak) verwijdert die specifieke lead.
BulkactieDelete selected.
PagineringGenummerde paginering met vensterweergave (huidige ± 2 pagina's).
Export CSVBevat alle leads die overeenkomen met de huidige zoekopdracht.
Modal Lead DetailsDate, Name, Email, Phone, Vehicle, Type, Appointment, Message.

Recipient Email Override

VeldOpmerkingen
Recipient emailLeeg = terugvalketen (openbaar e-mailadres van de verkoper → WP-account-e-mail → e-mailadres van de beheerder). Meerdere door komma's gescheiden adressen worden gevalideerd voor het opslaan.

Form Fields

VeldStandaardOpmerkingen
NameAltijd aanVerplicht voor bezoekers.
EmailAltijd aanVerplicht voor bezoekers.
PhoneAanSchakel uit om te verbergen.
MessageAanSchakel uit om te verbergen.
VeldOpmerkingen
Consent checkboxHoofdschakelaar. Indien ingeschakeld, moeten bezoekers het vakje aanvinken voordat ze het formulier verzenden.
Consent labelWordt getoond naast het selectievakje. Leeg = ingebouwde standaardwaarde.
Privacy page URLIndien ingesteld, worden de woorden "privacy policy" in het label gelinkt naar deze URL.

Notification Messages

VeldOpmerkingen
Success messageWordt getoond aan de bezoeker na een succesvolle verzending.
Error messageWordt getoond als de verzending mislukt.

Test Drive Booking

VeldOpmerkingen
Enable Test Drive bookingHoofdschakelaar die het boekingsformulier weergeeft op pagina's van individuele voertuigen.
Available DaysSelectie van meerdere weekdagen. Leeg = alle dagen beschikbaar.
Start Time / End Time24-uurs HH:MM-formaat.
Slot Duration (minutes)5–480 in stappen van 5.
Blocked DatesEén YYYY-MM-DD per regel voor feestdagen / sluitingen.

Webhooks

VeldOpmerkingen
New lead webhook URLWordt aangeroepen bij een nieuwe verzending van het contactformulier.
New import webhook URLWordt aangeroepen wanneer een voertuig wordt geïmporteerd of bijgewerkt.
Webhook secretWordt gebruikt om de HMAC-SHA256-handtekening te berekenen die in de X-AS24CI-Signature-header wordt verzonden. Behandel dit als een inloggegeven. Wanneer er al een geheim is opgeslagen, verschijnt er een bevestigingsmelding en luidt de tijdelijke aanduiding van het veld "Leave empty to keep the current secret" — de opgeslagen waarde wordt alleen vervangen als u een nieuwe invoert.

Email Templates

VeldOpmerkingen
Dealer notification subjectStandaard tijdelijke aanduiding: New inquiry for {vehicle_title}.
Customer confirmation subjectStandaard tijdelijke aanduiding: Your inquiry for {vehicle_title}.
Dealer notification templateHTML-tekst. Ondersteunt tijdelijke aanduidingen.
Customer confirmation templateHTML-tekst. Ondersteunt tijdelijke aanduidingen.

Ondersteunde tijdelijke aanduidingen: {name}, {email}, {phone}, {message}, {vehicle_title}, {vehicle_url}.

Operationele opmerkingen

  • Alle instellingenkaarten behoren tot één formulier. Elke knop Save Leads settings verzendt en bewaart elk veld op de pagina.
  • E-mailverzending maakt gebruik van standaard WordPress-mail. Bounces, afleverbaarheid en spamfiltering vallen buiten de controle van de plugin.
  • De webhook-handtekening wordt voor elke payload opnieuw berekend. Om aan de ontvangende kant te verifiëren, berekent u HMAC-SHA256(payload, secret) en vergelijkt u dit met de X-AS24CI-Signature-header.
  • Test Drive Booking toont het boekingsformulier alleen wanneer de hoofdschakelaar aan staat. Zonder geselecteerde dagen worden alle dagen als beschikbaar beschouwd.
  • Leads worden opgeslagen in een custom post type, zodat back-ups en exports deze automatisch meenemen. CSV-export respecteert het actieve zoekfilter.
  • De modal Lead Details is alleen-lezen; om interne notities of een werkstroomstatus toe te voegen, gebruikt u een CRM via de webhook-integratie.

Problemen oplossen

  • Er worden geen e-mails ontvangen. Controleer of de WordPress-site e-mail kan verzenden (test met een andere plugin of een sitebrede test). Controleer het veld voor de e-mailontvanger op typefouten.
  • Bezoekers kunnen het formulier niet verzenden. Controleer de toestemmingsschakelaar en het label — als toestemming vereist is, moet het selectievakje worden aangevinkt. Inspecteer de paginaconsole op JavaScript-fouten en controleer of cookies/lokale opslag niet worden geblokkeerd.
  • Webhook-ontvanger krijgt geen verzoek. Controleer of de URL bereikbaar is vanaf de server, HTTPS gebruikt en niet wordt geblokkeerd door een firewall. Controleer het scherm Logs op afleverfouten.
  • Webhook-handtekening valideert niet. Zorg ervoor dat beide kanten hetzelfde geheim gebruiken en dat de ontvanger de HMAC-SHA256 van de ruwe POST-body berekent, en niet van een vooraf geparste JSON.
  • Tijdsloten voor proefritten ontbreken. Zorg ervoor dat de End Time later is dan de Start Time en dat de datum niet in Blocked Dates staat. Als er geen dagen zijn aangevinkt, zijn standaard alle dagen geopend.
  • E-mailsjablonen tonen letterlijke tijdelijke aanduidingen. Controleer of de tekst van de tijdelijke aanduiding exact overeenkomt (inclusief accolades) en een van de ondersteunde tokens is.

Gerelateerde documenten