Leads-Referenz

Dieses Dokument ist eine Referenz für den Leads-Bildschirm des ADP Car Market Hub-Plugins (CMH Center → Leads). Es behandelt den Lead-Posteingang, die Konfiguration des Kontaktformulars, die Einwilligungs- und Datenschutzoptionen, Benachrichtigungsmeldungen, das Test Drive Booking-Modul, Webhooks und E-Mail-Vorlagen.

Wann Sie dieses Dokument verwenden sollten

Verwenden Sie diese Referenz, wenn Sie eingegangene Kontaktformulare überprüfen, die im Formular angezeigten Felder ändern, die DSGVO-Einwilligungsanforderungen erfüllen, die Empfänger von Lead-Benachrichtigungs-E-Mails konfigurieren, eine Integration mit einem externen CRM über Webhooks einrichten oder die Test Drive Booking-Funktion auf einzelnen Fahrzeugseiten aktivieren möchten.

Übersicht

Der Leads-Bildschirm ist in eine Tabelle für Lead Inquiries und eine Reihe von Einstellungskarten unterteilt, die wie folgt organisiert sind:

1. Lead Inquiries – durchsuchbare, paginierte Liste aller Einsendungen mit Massenaktionen und CSV-Export.
2. Recipient Email Override + Form Fields (Nebeneinander-Zeile).
3. Consent & Privacy + Notification Messages (Nebeneinander-Zeile).
4. Test Drive Booking (Karte in voller Breite).
5. Webhooks.
6. Email Templates.

Alle Einstellungskarten teilen sich dasselbe Formular, sodass das Speichern einer Karte die gesamte Seite sichert.

Anforderungen oder Voraussetzungen

• Berechtigung zur Verwaltung des Plugins.
• Funktionierender WordPress-Mailversand. Das Plugin verwendet den standardmässigen WordPress-E-Mail-Versand; wenn Ihre Website keine E-Mails senden kann, konfigurieren Sie SMTP separat.
• Für Webhooks: ein externer Endpunkt, der HTTPS-POST-Anfragen akzeptieren kann.
• Für Test Drive Booking: Aktivieren Sie die Funktion und definieren Sie mindestens das Zeitfenster.

Schritt-für-Schritt-Anleitung

Leads überprüfen und verwalten

1. Öffnen Sie CMH Center → Leads.
2. Verwenden Sie das Feld Search, um nach Name, E-Mail, Nachrichtentext oder Fahrzeug zu filtern.
3. Die Tabelle listet jede Einsendung mit den Spalten Date, Name, Email, Phone, Vehicle, Type, Appointment und Actions auf. Der Wert unter Vehicle verlinkt auf das Live-Inserat (öffnet in einem neuen Tab); das Type-Badge zeigt an, ob es sich bei dem Lead um eine Inquiry oder eine Test Drive handelt.
4. Klicken Sie auf das View-Symbol (Auge) in einer Zeile, um das Modal Lead Details zu öffnen (Date, Name, Email, Phone, Vehicle, Type, Appointment, Message).
5. Klicken Sie auf das Delete-Symbol (Papierkorb), um einen einzelnen Lead zu löschen, oder markieren Sie Zeilen und verwenden Sie die Massenaktion Delete selected + Apply, um mehrere Leads gleichzeitig zu entfernen.
6. Verwenden Sie Export CSV in der Symbolleiste, um alle Leads herunterzuladen, die dem aktuellen Filter entsprechen.

Kontaktformular konfigurieren

1. Lassen Sie das Feld in Recipient Email Override leer, um die Fallback-Kette zu verwenden (öffentliche E-Mail-Adresse der Garage → WordPress-Konto-E-Mail → Website-Admin-E-Mail), oder geben Sie eine oder mehrere durch Komma getrennte Adressen ein.
2. Schalten Sie in Form Fields die Optionen Phone und/oder Message aus, wenn Sie diese nicht benötigen. Name und Email sind immer erforderlich.
3. Aktivieren Sie in Consent & Privacy das Kontrollkästchen für die Einwilligung, legen Sie den Beschriftungstext fest und geben Sie optional eine URL für die Datenschutzseite an – die Wörter "privacy policy" in der Beschriftung werden dann mit dieser URL verlinkt.
4. Passen Sie in Notification Messages die Erfolgs- und Fehlermeldungen an, die den Besuchern nach dem Absenden angezeigt werden.
5. Klicken Sie auf eine beliebige Schaltfläche Save Leads settings.

Test Drive Booking aktivieren

1. Öffnen Sie die Karte Test Drive Booking.
2. Schalten Sie Enable Test Drive booking ein. Die Live-Zusammenfassungsleiste oben auf der Karte spiegelt die aktive Konfiguration wider: ein Statuspunkt (Active / Inactive), die Anzahl der ausgewählten Tage, der Zeitbereich, das Label für die Slot-Dauer (z. B. "30 min slots") und ein "N blocked dates"-Chip, wenn Termine blockiert sind.
3. Wählen Sie unter Available Days die Wochentage aus, an denen Termine gebucht werden können. Lassen Sie alle deaktiviert, um jeden Tag zuzulassen.
4. Fügen Sie Blocked Dates im Format YYYY-MM-DD hinzu, ein Datum pro Zeile.
5. Legen Sie Start Time, End Time und Slot Duration (minutes) fest (5–480, Schrittweite 5; mindestens 5 Minuten).
6. Speichern Sie.

Webhooks für externe Systeme konfigurieren

1. Geben Sie die New lead webhook URL ein, um einen HTTP-POST zu erhalten, wenn ein Besucher das Kontaktformular absendet.
2. Geben Sie die New import webhook URL ein, um einen HTTP-POST zu erhalten, wenn ein Fahrzeug importiert oder aktualisiert wird.
3. Legen Sie optional ein Webhook secret fest. Das Plugin signiert jede Anfrage mit HMAC-SHA256 und sendet die Signatur im Header X-AS24CI-Signature zur Überprüfung. Sobald ein Secret gespeichert ist, erscheint ein Bestätigungshinweis und der Platzhalter des Feldes ändert sich zu "Leave empty to keep the current secret" – das gespeicherte Secret wird nur überschrieben, wenn Sie einen neuen Wert eingeben. Wenn Sie das Feld leer lassen, bleibt es unverändert.
4. Speichern Sie. Lassen Sie eine URL leer, um den entsprechenden Webhook zu deaktivieren.

E-Mail-Vorlagen anpassen

1. Öffnen Sie die Karte Email Templates.
2. Bearbeiten Sie den Betreff für die Benachrichtigung der Garage, den Betreff für die Bestätigung des Kunden und die entsprechenden HTML-E-Mail-Texte.
3. Verwenden Sie Platzhalter, um Lead- und Fahrzeugdaten einzufügen: {name}, {email}, {phone}, {message}, {vehicle_title}, {vehicle_url}.
4. Lassen Sie ein Feld leer, um den integrierten Standardwert zu verwenden.
5. Speichern Sie.

---

Konfigurationsreferenz

Tabelle «Lead-Anfragen»

Empfänger-E-Mail-Überschreibung

Formularfelder

Einwilligung & Datenschutz

Benachrichtigungsmeldungen

Probefahrt-Buchung

Webhooks

E-Mail-Vorlagen

Unterstützte Platzhalter: {name}, {email}, {phone}, {message}, {vehicle_title}, {vehicle_url}.

Betriebliche Hinweise

• Alle Einstellungskarten gehören zu einem einzigen Formular. Jeder Button Leads-Einstellungen speichern sendet alle Felder auf der Seite ab und speichert sie dauerhaft.
• Der E-Mail-Versand nutzt standardmässige WordPress-Mails. Rückläufer (Bounces), Zustellbarkeit und Spam-Filterung liegen ausserhalb der Kontrolle des Plugins.
• Die Webhook-Signatur wird für jeden Payload neu berechnet. Zur Überprüfung auf der Empfängerseite berechnen Sie HMAC-SHA256(payload, secret) und vergleichen Sie dies mit dem Header X-AS24CI-Signature.
• Die Probefahrt-Buchung zeigt das Buchungsformular nur an, wenn der Hauptschalter aktiviert ist. Ohne ausgewählte Tage gelten alle Tage als verfügbar.
• Leads werden in einem Custom Post Type gespeichert, sodass Backups und Exporte diese automatisch abdecken. Der CSV-Export berücksichtigt den aktiven Suchfilter.
• Das Modal «Lead-Details» ist schreibgeschützt; um interne Notizen oder einen Workflow-Status hinzuzufügen, nutzen Sie ein CRM über die Webhook-Integration.

Fehlerbehebung

• Es werden keine E-Mails empfangen. Stellen Sie sicher, dass die WordPress-Website E-Mails senden kann (testen Sie dies mit einem anderen Plugin oder einem website-weiten Test). Überprüfen Sie das Feld für die Empfängerüberschreibung auf Tippfehler.
• Besucher können das Formular nicht absenden. Überprüfen Sie den Einwilligungsschalter und den Text – wenn eine Einwilligung erforderlich ist, muss das Kontrollkästchen aktiviert sein. Untersuchen Sie die Konsole der Seite auf JavaScript-Fehler und stellen Sie sicher, dass Cookies/Local Storage nicht blockiert sind.
• Der Webhook-Empfänger erhält keine Anfrage. Überprüfen Sie, ob die URL vom Server aus erreichbar ist, HTTPS verwendet und nicht durch eine Firewall blockiert wird. Überprüfen Sie den Bildschirm Logs auf Zustellungsfehler.
• Die Webhook-Signatur lässt sich nicht validieren. Stellen Sie sicher, dass beide Seiten dasselbe Geheimnis verwenden und dass der Empfänger den HMAC-SHA256 des rohen POST-Bodys berechnet, nicht von einem bereits geparsten JSON.
• Probefahrt-Slots fehlen. Stellen Sie sicher, dass die Endzeit nach der Startzeit liegt und dass das Datum nicht in den Blockierten Daten enthalten ist. Wenn keine Tage ausgewählt sind, sind standardmässig alle Tage geöffnet.
• E-Mail-Vorlagen zeigen Platzhalter im Klartext. Stellen Sie sicher, dass der Platzhaltertext exakt übereinstimmt (einschliesslich geschweifter Klammern) und zu den unterstützten Tokens gehört.

Verwandte Dokumente

• Einstellungen-Referenz
• Logs-Referenz
• Referenz zu Analytics
• Suchabo-Referenz