Leads-Referenz

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

Wann Sie dieses Dokument verwenden sollten

Verwenden Sie diese Referenz, wenn Sie die Einsendungen von Kontaktformularen überprüfen, die im Formular angezeigten Felder ändern, die DSGVO-Einwilligungsanforderungen erfüllen, die Empfänger für Lead-Benachrichtigungs-E-Mails konfigurieren, eine Integration mit einem externen CRM über Webhooks einrichten oder die Probefahrten-Buchung auf den einzelnen Fahrzeugseiten aktivieren möchten.

Übersicht

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

1. Lead-Anfragen — eine durchsuchbare, paginierte Liste aller Einsendungen mit Massenaktionen und CSV-Export.
2. Empfänger-E-Mail-Überschreibung (Recipient Email Override) + Formularfelder (Form Fields) (nebeneinander liegende Zeile).
3. Einwilligung & Datenschutz (Consent & Privacy) + Benachrichtigungsmeldungen (Notification Messages) (nebeneinander liegende Zeile).
4. Probefahrten-Buchung (Test Drive Booking) (Karte in voller Breite).
5. Webhooks.
6. E-Mail-Vorlagen (Email Templates).

Alle Einstellungskarten gehören zum selben Formular. Das Speichern einer beliebigen Karte speichert somit die gesamte Seite.

Anforderungen oder Voraussetzungen

• Berechtigung zur Verwaltung des Plugins.
• Funktionierende WordPress-Mail-Zustellung. Das Plugin verwendet standardmässige WordPress-E-Mails. 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 die Probefahrten-Buchung: Aktivieren Sie die Funktion und legen Sie mindestens das Zeitfenster fest.

Schritt-für-Schritt-Anleitung

Leads überprüfen und verwalten

1. Öffnen Sie Car Market Hub → Leads.
2. Verwenden Sie das Feld Suche, um nach Name, E-Mail, Nachrichtentext oder Fahrzeug zu filtern.
3. Die Tabelle listet jede Einsendung mit den Spalten Datum, Name, E-Mail, Telefon, Fahrzeug, Typ, Termin und Aktionen auf. Der Wert in der Spalte Fahrzeug verlinkt auf das Live-Inserat (öffnet in einem neuen Tab); das Badge Typ zeigt an, ob es sich bei dem Lead um eine Anfrage (Inquiry) oder eine Probefahrt (Test Drive) handelt.
4. Klicken Sie auf das Symbol Anzeigen (Auge) in einer Zeile, um das Modal Lead-Details zu öffnen (Datum, Name, E-Mail, Telefon, Fahrzeug, Typ, Termin, Nachricht).
5. Klicken Sie auf das Symbol Löschen (Papierkorb), um einen einzelnen Lead zu entfernen, oder markieren Sie Zeilen und verwenden Sie die Massenaktion Ausgewählte löschen + Anwenden, um mehrere Leads gleichzeitig zu entfernen.
6. Verwenden Sie CSV exportieren in der Symbolleiste, um alle Leads herunterzuladen, die dem aktuellen Filter entsprechen.

Kontaktformular konfigurieren

1. Lassen Sie das Feld in Empfänger-E-Mail-Überschreibung leer, um die Fallback-Kette zu verwenden (öffentliche E-Mail-Adresse des Verkäufers → WordPress-Konto-E-Mail → Website-Admin-E-Mail), oder geben Sie eine oder mehrere durch Kommas getrennte Adressen ein.
2. Schalten Sie in Formularfelder die Optionen Telefon und/oder Nachricht aus, wenn Sie diese nicht benötigen. Name und E-Mail sind immer erforderlich.
3. Aktivieren Sie in Einwilligung & Datenschutz 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 "Datenschutzerklärung" in der Beschriftung werden dann mit dieser URL verlinkt.
4. Passen Sie in Benachrichtigungsmeldungen die Erfolgs- und Fehlermeldungen an, die den Besuchern nach dem Absenden angezeigt werden.
5. Klicken Sie auf eine beliebige Schaltfläche Leads-Einstellungen speichern.

Probefahrten-Buchung aktivieren

1. Öffnen Sie die Karte Probefahrten-Buchung (Test Drive Booking).
2. Aktivieren Sie die Option Probefahrten-Buchung aktivieren. Die Live-Zusammenfassungsleiste oben auf der Karte zeigt die aktive Konfiguration an: einen Statuspunkt (Aktiv / Inaktiv), die Anzahl der ausgewählten Tage, den Zeitbereich, die Beschriftung der Slot-Dauer (z. B. "30-Minuten-Slots") und ein Label "N blockierte Daten", wenn Termine blockiert sind.
3. Wählen Sie unter Verfügbare Tage die Wochentage aus, an denen Termine gebucht werden können. Lassen Sie alle unangekreuzt, um jeden Tag zuzulassen.
4. Fügen Sie Blockierte Daten im Format YYYY-MM-DD hinzu, eines pro Zeile.
5. Legen Sie Startzeit, Endzeit und Slot-Dauer (Minuten) fest (5–480, Schrittweite 5; mindestens 5 Minuten).
6. Speichern Sie.

Webhooks für externe Systeme konfigurieren

1. Geben Sie die Webhook-URL für neue Leads ein, um einen HTTP-POST zu erhalten, wenn ein Besucher das Kontaktformular absendet.
2. Geben Sie die Webhook-URL für neue Importe ein, um einen HTTP-POST zu erhalten, wenn ein Fahrzeug importiert oder aktualisiert wird.
3. Richten Sie optional ein Webhook-Geheimnis (Webhook secret) ein. Das Plugin signiert jede Anfrage mit HMAC-SHA256 und sendet die Signatur im Header X-AS24CI-Signature zur Überprüfung. Sobald ein Geheimnis gespeichert ist, erscheint ein Bestätigungshinweis und der Platzhalter des Feldes ändert sich zu "Leer lassen, um das aktuelle Geheimnis zu behalten" — das gespeicherte Geheimnis 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 E-Mail-Vorlagen (Email Templates).
2. Bearbeiten Sie den Betreff der Garagen-Benachrichtigung, den Betreff der Kundenbestätigung 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 beliebiges Feld leer, um den integrierten Standardwert zu verwenden.
5. Speichern Sie.

Konfigurationsreferenz

Tabelle für Lead-Anfragen

Empfänger-E-Mail-Überschreibung

Formularfelder

Einwilligung & Datenschutz

Benachrichtigungsmeldungen

Probefahrten-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. Jede Schaltfläche Leads-Einstellungen speichern sendet jedes Feld auf der Seite ab und speichert es.
• Der E-Mail-Versand nutzt standardmässige WordPress-Mails. Unzustellbare E-Mails (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 Probefahrten-Buchung zeigt das Buchungsformular nur an, wenn der Hauptschalter aktiviert ist. Wenn keine Tage ausgewählt sind, 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 für die 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 die Beschriftung — wenn eine Einwilligung erforderlich ist, muss das Kontrollkästchen aktiviert sein. Suchen Sie in der Browser-Konsole nach JavaScript-Fehlern und stellen Sie sicher, dass Cookies/lokaler Speicher nicht blockiert sind.
• Der Webhook-Empfänger erhält keine Anfrage. Stellen Sie sicher, dass die URL vom Server aus erreichbar ist, HTTPS verwendet und nicht durch eine Firewall blockiert wird. Überprüfen Sie den Bildschirm Protokolle (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 eines vor-analysierten JSONs.
• Probefahrten-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 der geschweiften Klammern) und zu den unterstützten Tokens gehört.

Zugehörige Dokumente

• Einstellungs-Referenz
• Protokoll-Referenz
• Analytics-Referenz
• Suchauftrags-Referenz