E-Mail- und Lead-Fehler

Dieses Dokument behandelt Probleme im Zusammenhang mit dem Fahrzeug-Anfrageformular, dem Probefahrt-Buchungsformular, dem E-Mail-Versand, dem Lead-Management und den Benachrichtigungseinstellungen im ADP Car Market Hub-Plugin.

Wann Sie dieses Dokument verwenden sollten

Lesen Sie dieses Dokument, wenn:

• Besucher das Kontaktformular absenden, aber keine Benachrichtigungs-E-Mail beim Autohaus oder dem konfigurierten Empfänger eingeht.
• Besucher nach dem Absenden einer Anfrage keine Bestätigungs-E-Mail erhalten.
• Das Absenden des Formulars erfolgreich zu sein scheint (der Besucher sieht eine Erfolgsmeldung), aber kein Lead im Admin-Bereich gespeichert wird.
• Das Formular eine Fehlermeldung zurückgibt oder auf eine Fehlerseite weiterleitet.
• Das Absenden des Formulars durch den Spam-Schutz blockiert wird.
• E-Mail-Benachrichtigungen an den falschen Empfänger gesendet werden.
• Benutzerdefinierte E-Mail-Betreffzeilen oder E-Mail-Vorlagen mit Platzhaltern nicht korrekt gerendert werden.
• Das Kontrollkästchen für die Einwilligung fehlt oder das Formular nicht abgesendet werden kann.

Übersicht

Das integrierte Kontaktformular des Plugins verarbeitet Fahrzeuganfragen und Probefahrt-Anfragen, die von Website-Besuchern übermittelt werden. Wenn ein gültiges Formular abgesendet wird:

1. Eine Benachrichtigungs-E-Mail wird an den Empfänger des Autohauses gesendet.
2. Eine Bestätigungs-E-Mail wird an den Besucher (den Lead) gesendet.
3. Die Lead-Details werden als benutzerdefinierter Beitrag vom Typ WordPress (as24ci_lead) gespeichert und können im Admin-Bereich des Plugins unter Leads eingesehen werden.
4. Ein Lead-Analytics-Ereignit wird erfasst (sofern Analytics aktiviert ist).

Beide E-Mails werden über die WordPress-Funktion wp_mail() gesendet. Die Zustellung hängt von der E-Mail-Konfiguration der Website ab, die entweder die integrierte PHP-Funktion mail() oder ein SMTP-Plugin eines Drittanbieters verwenden kann.

Spam-Schutz

Das Formular verwendet zwei Schutzebenen:

• Honeypot-Feld: Ein verstecktes Feld namens website ist im Formular enthalten. Wenn ein Bot dieses ausfüllt, wird die Übermittlung aus Sicht des Besuchers als erfolgreich behandelt, aber im Hintergrund verworfen, ohne dass eine E-Mail gesendet wird.
• Ratenbegrenzung: Über ein WordPress-Transient wird ein Limit von maximal 5 Übermittlungen pro IP-Adresse innerhalb eines 5-Minuten-Fensters erzwungen. Übermittlungen, die dieses Limit überschreiten, leiten den Besucher auf eine Fehlerseite weiter.

Empfänger-Ermittlung

Die Benachrichtigungs-E-Mail für das Autohaus wird an die erste gültige Adresse gesendet, die in dieser Prioritätskette gefunden wird:

1. Globale Überschreibung (Einstellung LEAD_RECIPIENT_EMAIL): Eine oder mehrere kommagetrennte E-Mail-Adressen, die in den Plugin-Einstellungen konfiguriert sind. Alle gültigen Adressen in dieser Liste erhalten die Benachrichtigung.
2. E-Mail des Verkäuferprofils: Eine benutzerdefinierte E-Mail-Adresse, die im User-Meta-Feld as24ci_seller_email für den mit dem Fahrzeug verknüpften Benutzer gespeichert ist.
3. E-Mail des Fahrzeug-Autors: Die E-Mail-Adresse des WordPress-Benutzers, der als Beitragsautor des Fahrzeugs zugewiesen ist.
4. Fallback auf Admin-E-Mail: Die E-Mail-Adresse des Website-Administrators (Option admin_email).

Systemvoraussetzungen

• Mindestens ein Fahrzeug-Beitrag ist veröffentlicht, damit das Formular damit verknüpft werden kann.
• Die Website kann E-Mails senden. Überprüfen Sie dies unter Werkzeuge → Website-Zustand oder mit einem Plugin zum Testen von Transaktions-E-Mails.
• Für die SMTP-Zustellung: Ein SMTP-Plugin (wie WP Mail SMTP) ist mit gültigen Zugangsdaten konfiguriert.

Diagnoseschritte

Schritt 1: Funktion des E-Mail-Versands bestätigen

Bevor Sie das Plugin speziell untersuchen, stellen Sie sicher, dass WordPress überhaupt E-Mails senden kann:

1. Verwenden Sie ein Plugin wie WP Mail SMTP (oder ein beliebiges WordPress-E-Mail-Test-Tool), um eine Test-E-Mail zu senden.
2. Wenn die Test-E-Mail nicht empfangen wird, liegt das Problem an der Konfiguration des E-Mail-Transports, nicht am Plugin. Konfigurieren Sie ein SMTP-Plugin oder kontaktieren Sie Ihren Hosting-Anbieter.

Schritt 2: Überprüfen, ob der Lead gespeichert wurde

Selbst wenn der E-Mail-Versand fehlschlägt, speichert das Plugin den Lead in der Datenbank (es sei denn, die Formularübermittlung wurde durch den Honeypot oder die Ratenbegrenzung blockiert):

1. Rufen Sie im Admin-Bereich des Plugins den Bereich Leads auf.
2. Suchen Sie nach dem neuesten Lead und prüfen Sie, ob die Details vorhanden sind (Name, E-Mail, Fahrzeug).
3. Überprüfen Sie das Feld email_sent. Wenn es 0 anzeigt, hat der Aufruf von wp_mail() für eine oder beide E-Mails „false“ zurückgegeben.
4. Wenn kein Lead-Eintrag existiert, wurde das Formular entweder überhaupt nicht abgesendet, es wurde vom Honeypot abgefangen oder das Speichern des CPT as24ci_lead ist fehlgeschlagen (prüfen Sie das PHP-Fehlerprotokoll).

Schritt 3: Empfänger-E-Mail-Adresse überprüfen

1. Gehen Sie in die Plugin-Einstellungen und suchen Sie nach E-Mail-Empfänger für Leads (die globale Überschreibung).
2. Wenn dieses Feld leer ist, greift das Plugin auf die E-Mail-Adresse des Verkäuferprofils oder die WordPress-E-Mail-Adresse des Beitragsautors zurück.
3. Stellen Sie sicher, dass die ermittelte Empfängeradresse eine gültige, zustellbare E-Mail-Adresse ist, indem Sie Folgendes überprüfen: - Den Wert in der Einstellung für den Lead-Empfänger im Plugin. - Die User-Meta as24ci_seller_email für den Verkäufer-Benutzer (falls zutreffend). - Die E-Mail-Adresse des WordPress-Benutzerkontos für den Beitragsautor. - Die WordPress-Admin-E-Mail-Adresse (Settings → General → Administration Email Address).

Schritt 4: E-Mail-Filter und Spam-Ordner prüfen

1. Bitten Sie den vorgesehenen Empfänger, seinen Spam- oder Junk-Ordner zu überprüfen.
2. E-Mails, die von WordPress über PHP mail() gesendet werden, fehlt oft eine ordnungsgemäße SPF/DKIM-Authentifizierung, weshalb sie häufig als Spam markiert werden. Die Installation und Konfiguration eines SMTP-Plugins verbessert die Zustellbarkeit erheblich.
3. Wenn Sie SMTP verwenden, vergewissern Sie sich, dass die Zugangsdaten korrekt sind und der SMTP-Anbieter die Domain oder IP-Adresse des Servers nicht blockiert.

Schritt 5: Fehlerstatus des Formulars untersuchen

Wenn das Formular auf eine Fehlermeldung weiterleitet (die URL enthält as24ci_contact_ok=0), sind die wahrscheinlichen Ursachen:

• Ungültige oder fehlende Pflichtfelder: Das Formular erfordert eine gültige Fahrzeug-ID, einen nicht leeren Namen und eine gültige E-Mail-Adresse. Wenn das Nachrichtenfeld aktiviert ist (Standard), ist auch eine nicht leere Nachricht erforderlich.
• Ratenbegrenzung überschritten: Mehr als 5 Übermittlungen von derselben IP-Adresse innerhalb eines 5-Minuten-Fensters. Der Besucher muss warten, bevor er es erneut versuchen kann.
• wp_mail() fehlgeschlagen: Beide E-Mails gaben „false“ zurück. Der Lead wird zwar gespeichert, dem Besucher wird jedoch der Fehlerstatus angezeigt.

Um festzustellen, welche Ursache zutrifft, überprüfen Sie die Leads-Liste im Admin-Bereich, um zu sehen, ob ein Eintrag erstellt wurde, und kontrollieren Sie das Feld email_sent.

Schritt 6: Das Kontrollkästchen für die Einwilligung prüfen

Wenn das Formular nicht abgesendet werden kann, weil das Kontrollkästchen für die Einwilligung erforderlich ist:

1. Stellen Sie sicher, dass die Option Einwilligung erforderlich in den Plugin-Einstellungen aktiviert ist (Standard: aktiviert).
2. Vergewissern Sie sich, dass der Text für das Einwilligungs-Label korrekt hinterlegt ist.
3. Wenn eine URL für die Datenschutzseite konfiguriert ist, prüfen Sie, ob der Link im Einwilligungs-Label auf die richtige Seite verweist.
4. Das Formular validiert das Einwilligungsfeld serverseitig. Wenn ein Besucher es nicht aktiviert, wird die Übermittlung abgelehnt und er wird auf die Fehlerseite weitergeleitet.

Schritt 7: Benutzerdefinierte E-Mail-Vorlagen überprüfen

Wenn benutzerdefinierte Betreffzeilen oder HTML-Vorlagen (in den E-Mail-Einstellungen des Plugins) konfiguriert sind, stellen Sie sicher, dass:

1. Die Vorlage gültiges HTML ist.
2. Platzhalter-Token das richtige Format verwenden: {placeholder_name} mit geschweiften Klammern. Unterstützte Platzhalter sind: - {customer_name} - {customer_email} - {customer_phone} - {customer_message} - {vehicle_title} - {vehicle_url} - {vehicle_price} - {dealer_name} - {listing_id} - {appointment_date}
3. Wenn eine benutzerdefinierte Vorlage konfiguriert ist, aber ein Platzhalter falsch geschrieben wurde, wird dieser in der gesendeten E-Mail als reiner Text {placeholder_name} angezeigt.
4. Wenn das Feld für die benutzerdefinierte Vorlage leer ist, verwendet das Plugin seine integrierte HTML-Vorlage als Fallback.

Schritt 8: Probefahrt-Anfragen

Übermittlungen von Probefahrt-Formularen folgen demselben Codepfad wie Standardanfragen, verfügen jedoch über eine zusätzliche Validierung:

1. Es müssen sowohl ein Datum als auch ein Zeitfenster ausgewählt werden. Wenn eines davon fehlt oder das Datum in der Vergangenheit liegt, fällt die Übermittlung auf eine Standard-Kontaktanfrage zurück.
2. Das Zeitfenster muss eines der verfügbaren Zeitfenster sein, die von der API für die Probefahrt-Verfügbarkeit zurückgegeben werden. Wenn für das ausgewählte Datum keine Zeitfenster verfügbar sind, schlägt die Validierung des Zeitfensters fehl.
3. Die Betreffzeile und der E-Mail-Text für Probefahrt-Anfragen verwenden andere Standardtexte als Standardanfragen („Probefahrt-Anfrage“ statt „Fahrzeuganfrage“).

Konfigurations-Referenz

Betriebshinweise

• Sowohl die Händler-Benachrichtigung als auch die Besucher-Bestätigung werden über wp_mail() gesendet. Wenn einer der Aufrufe „false“ zurückgibt, leitet das Formular auf die Fehlerseite weiter. Der Lead wird dennoch in jedem Fall gespeichert.
• Der Header Reply-To der Händler-Benachrichtigungs-E-Mail wird auf den Namen und die E-Mail-Adresse des Besuchers gesetzt, sodass das Autohaus direkt aus seinem E-Mail-Client auf die Anfrage des Besuchers antworten kann.
• Die Ratenbegrenzung verwendet ein WordPress-Transient, das auf einem SHA-256-Hash der IP-Adresse des Besuchers und dem WordPress-Authentifizierungsschlüssel basiert. Der Hash verhindert, dass die IP-Adresse im Klartext gespeichert wird. Das Limit liegt bei 5 Übermittlungen pro IP innerhalb von 5 Minuten.
• Das Honeypot-Feld wird in den Vorlagen des Plugins per CSS ausgeblendet. Wenn ein Performance- oder Sicherheits-Plugin Inline-Styles entfernt oder bestimmte CSS-Klassen blockiert, kann das Honeypot-Feld für echte Besucher sichtbar werden. Testen Sie das Formular nach der Aktivierung von Sicherheits-Plugins.
• Leads werden in einem nicht-öffentlichen benutzerdefinierten Beitragstyp (as24ci_lead) mit dem Status new, contacted, closed oder spam gespeichert. Sie sind nur im Admin-Bereich unter Leads sichtbar, nicht in der öffentlichen Beitragsliste der Website.
• Das Plugin speichert keine E-Mail-Inhalte oder vollständigen IP-Adressen in der Datenbank. Der Lead-Datensatz speichert den Namen, die E-Mail-Adresse, die Telefonnummer, die Nachricht, die Fahrzeugreferenz, das Übermittlungsdatum und den Status der E-Mail-Zustellung des Kontakts.

---

Fehlerbehebung

Zugehörige Dokumente

• Übersicht zur Fehlerbehebung
• Shortcode-Probleme
• Berechtigungsfehler