Documentation · Référence de l'administrateur

Référence des leads

Ce document est une référence pour l'écran Leads de l'extension ADP Car Market Hub (Car Market Hub → Leads). Il couvre la boîte de réception des leads, la configuration du formulaire de contact, les options de consentement et de confidentialité, les messages de notification, le module de réservation d'essais routiers (Test Drive Booking), les webhooks et les modèles d'e-mail.

Quand utiliser ce document

Utilisez cette référence lorsque vous souhaitez examiner les soumissions de formulaires de contact, modifier les champs qui apparaissent dans le formulaire, vous conformer aux exigences de consentement du RGPD, configurer les destinataires des e-mails de notification de leads, intégrer un CRM externe via des webhooks ou activer la fonctionnalité de réservation d'essais routiers sur les pages de véhicules individuels.

Aperçu

L'écran Leads est divisé en un tableau Lead Inquiries (Demandes de leads) et une série de cartes de réglages organisées comme suit :

  1. Lead Inquiries — liste paginée et interrogeable de toutes les soumissions avec actions groupées et export CSV.
  2. Recipient Email Override (Surcharge de l'e-mail du destinataire) + Form Fields (Champs du formulaire) (ligne côte à côte).
  3. Consent & Privacy (Consentement et confidentialité) + Notification Messages (Messages de notification) (ligne côte à côte).
  4. Test Drive Booking (Réservation d'essai routier) (carte pleine largeur).
  5. Webhooks.
  6. Email Templates (Modèles d'e-mail).

Toutes les cartes de réglages partagent le même formulaire, de sorte que la sauvegarde de l'une d'entre elles enregistre l'ensemble de la page.

Configuration requise ou prérequis

  • Autorisation de gérer l'extension.
  • Messagerie WordPress fonctionnelle. L'extension utilise la messagerie standard de WordPress ; si votre site ne peut pas envoyer d'e-mails, configurez le SMTP séparément.
  • Pour les webhooks : un point de terminaison externe capable d'accepter les requêtes HTTPS POST.
  • Pour le Test Drive Booking : activez le commutateur de fonctionnalité et définissez au moins la plage horaire.

Instructions étape par étape

Examiner et gérer les leads

  1. Ouvrez Car Market Hub → Leads.
  2. Utilisez le champ Search (Recherche) pour filtrer par nom, e-mail, texte du message ou véhicule.
  3. Le tableau répertorie chaque soumission avec les colonnes Date, Name (Nom), Email, Phone (Téléphone), Vehicle (Véhicule), Type, Appointment (Rendez-vous) et Actions. La valeur Vehicle renvoie vers l'annonce en ligne (s'ouvre dans un nouvel onglet) ; le badge Type indique si le lead est une demande d'information (Inquiry) ou un essai routier (Test Drive).
  4. Cliquez sur l'icône View (œil) sur une ligne pour ouvrir la fenêtre modale Lead Details (Détails du lead) (Date, Nom, E-mail, Téléphone, Véhicule, Type, Rendez-vous, Message).
  5. Cliquez sur l'icône Delete (corbeille) pour supprimer un seul lead, ou cochez plusieurs lignes et utilisez l'action groupée Delete selected (Supprimer la sélection) + Apply (Appliquer) pour en supprimer plusieurs à la fois.
  6. Utilisez Export CSV dans la barre d'outils pour télécharger tous les leads correspondant au filtre actuel.

Configurer le formulaire de contact

  1. Dans Recipient Email Override, laissez le champ vide pour utiliser la chaîne de repli (e-mail public du vendeur → e-mail du compte WordPress → e-mail de l'administrateur du site), ou saisissez une ou plusieurs adresses séparées par des virgules.
  2. Dans Form Fields, désactivez Phone et/ou Message si vous n'en avez pas besoin. Les champs Name et Email sont toujours obligatoires.
  3. Dans Consent & Privacy, activez la case à cocher de consentement, définissez le texte du libellé et indiquez éventuellement l'URL d'une page de politique de confidentialité — les mots « politique de confidentialité » (privacy policy) dans le libellé seront alors liés à cette URL.
  4. Dans Notification Messages, personnalisez les messages de succès et d'erreur affichés aux visiteurs après la soumission.
  5. Cliquez sur n'importe quel bouton Save Leads settings (Enregistrer les réglages des leads).

Activer la réservation d'essais routiers (Test Drive Booking)

  1. Ouvrez la carte Test Drive Booking.
  2. Activez l'option Enable Test Drive booking. La barre de résumé en direct en haut de la carte reflète la configuration active : un point d'état (Active / Inactive), le nombre de jours sélectionnés, la plage horaire, le libellé de la durée du créneau (par ex. « créneaux de 30 min ») et un badge « N dates bloquées » lorsque des dates sont bloquées.
  3. Dans Available Days (Jours disponibles), sélectionnez les jours de la semaine où les rendez-vous peuvent être réservés. Laissez tout décoché pour autoriser tous les jours.
  4. Ajoutez des Blocked Dates (Dates bloquées) au format YYYY-MM-DD, une par ligne.
  5. Définissez l'heure de début (Start Time), l'heure de fin (End Time) et la durée du créneau (Slot Duration (minutes)) (5 à 480, par pas de 5 ; minimum 5 minutes).
  6. Enregistrez.

Configurer les webhooks pour les systèmes externes

  1. Saisissez l'URL New lead webhook URL pour recevoir un POST HTTP lorsqu'un visiteur soumet le formulaire de contact.
  2. Saisissez l'URL New import webhook URL pour recevoir un POST HTTP lorsqu'un véhicule est importé ou mis à jour.
  3. Définissez éventuellement un secret de webhook (Webhook secret). L'extension signe chaque requête avec HMAC-SHA256 et envoie la signature dans l'en-tête X-AS24CI-Signature pour vérification. Une fois qu'un secret est enregistré, une note de confirmation apparaît et l'espace réservé du champ devient « Laisser vide pour conserver le secret actuel » — le secret enregistré n'est écrasé que si vous saisissez une nouvelle valeur, donc laisser le champ vide le conserve inchangé.
  4. Enregistrez. Laissez une URL vide pour désactiver ce webhook.

Personnaliser les modèles d'e-mail

  1. Ouvrez la carte Email Templates.
  2. Modifiez l'objet de la notification du concessionnaire, l'objet de la confirmation du client et les corps d'e-mail HTML correspondants.
  3. Utilisez des variables de substitution pour injecter les données du lead et du véhicule : {name}, {email}, {phone}, {message}, {vehicle_title}, {vehicle_url}.
  4. Laissez un champ vide pour utiliser la valeur par défaut intégrée.
  5. Enregistrez.

Référence de configuration

Tableau Lead Inquiries

ÉlémentComportement
ColonnesDate, Name, Email, Phone, Vehicle, Type, Appointment, Actions.
Colonne VehicleRenvoie vers l'annonce en ligne ; s'ouvre dans un nouvel onglet.
Colonne TypeBadge : Inquiry (Demande) ou Test Drive (Essai routier).
RechercheFiltre sur le nom, l'e-mail, le texte du message et le véhicule.
Par pageValeurs autorisées : 5, 10, 25, 50, 100. Par défaut 25.
Actions par ligneView (œil) ouvre la fenêtre modale Lead Details ; Delete (corbeille) supprime ce lead unique.
Action groupéeDelete selected (Supprimer la sélection).
PaginationPagination numérotée avec fenêtrage (page actuelle ± 2 pages).
Export CSVInclut tous les leads correspondant à la recherche actuelle.
Modale Lead DetailsDate, Name, Email, Phone, Vehicle, Type, Appointment, Message.

Recipient Email Override

ChampNotes
Recipient emailVide = chaîne de repli (e-mail public du vendeur → e-mail du compte WP → e-mail de l'administrateur). Les adresses multiples séparées par des virgules sont validées avant l'enregistrement.

Form Fields

ChampPar défautNotes
NameToujours activéRequis pour les visiteurs.
EmailToujours activéRequis pour les visiteurs.
PhoneActivéDésactiver pour masquer.
MessageActivéDésactiver pour masquer.
ChampNotes
Consent checkboxCommutateur principal. Lorsqu'il est activé, les visiteurs doivent cocher la case avant de soumettre le formulaire.
Consent labelAffiché à côté de la case à cocher. Vide = valeur par défaut intégrée.
Privacy page URLSi elle est définie, les mots « politique de confidentialité » (privacy policy) dans le libellé sont liés à cette URL.

Notification Messages

ChampNotes
Success messageAffiché au visiteur après une soumission réussie.
Error messageAffiché si la soumission échoue.

Test Drive Booking

ChampNotes
Enable Test Drive bookingCommutateur principal qui affiche le formulaire de réservation sur les pages de véhicules individuels.
Available DaysSélection multiple des jours de la semaine. Vide = tous les jours sont disponibles.
Start Time / End TimeFormat 24 heures HH:MM.
Slot Duration (minutes)5 à 480 par pas de 5.
Blocked DatesUn format YYYY-MM-DD par ligne pour les jours fériés / fermetures.

Webhooks

ChampNotes
New lead webhook URLAppelé lors de la soumission d'un nouveau formulaire de contact.
New import webhook URLAppelé lorsqu'un véhicule est importé ou mis à jour.
Webhook secretUtilisé pour calculer la signature HMAC-SHA256 envoyée dans l'en-tête X-AS24CI-Signature. À traiter comme un identifiant confidentiel. Lorsqu'un secret est déjà enregistré, une note de confirmation apparaît et l'espace réservé du champ indique « Laisser vide pour conserver le secret actuel » — la valeur enregistrée n'est remplacée que si vous en saisissez une nouvelle.

Email Templates

ChampNotes
Dealer notification subjectVariable de substitution par défaut : New inquiry for {vehicle_title}.
Customer confirmation subjectVariable de substitution par défaut : Your inquiry for {vehicle_title}.
Dealer notification templateCorps HTML. Prend en charge les variables de substitution.
Customer confirmation templateCorps HTML. Prend en charge les variables de substitution.

Variables de substitution prises en charge : {name}, {email}, {phone}, {message}, {vehicle_title}, {vehicle_url}.

Notes opérationnelles

  • Toutes les cartes de réglages appartiennent à un seul formulaire. N'importe quel bouton Save Leads settings soumet et enregistre chaque champ de la page.
  • L'envoi d'e-mails utilise la messagerie standard de WordPress. Les rebonds, la délivrabilité et le filtrage des spams échappent au contrôle de l'extension.
  • La signature du webhook est recalculée pour chaque charge utile. Pour la vérifier du côté de la réception, calculez HMAC-SHA256(payload, secret) et comparez-la avec l'en-tête X-AS24CI-Signature.
  • Le module Test Drive Booking n'affiche le formulaire de réservation que lorsque le commutateur principal est activé. Sans jours sélectionnés, tous les jours sont considérés comme disponibles.
  • Les leads sont stockés dans un type de publication personnalisé (CPT), de sorte que les sauvegardes et les exports les couvrent automatiquement. L'export CSV respecte le filtre de recherche actif.
  • La fenêtre modale Lead Details est en lecture seule ; pour ajouter des notes internes ou un statut de flux de travail, utilisez un CRM via l'intégration de webhook.

Dépannage

  • Aucun e-mail n'est reçu. Confirmez que le site WordPress peut envoyer des e-mails (testez avec une autre extension ou un test à l'échelle du site). Vérifiez que le champ de surcharge du destinataire ne contient pas de fautes de frappe.
  • Les visiteurs ne peuvent pas soumettre le formulaire. Vérifiez le commutateur de consentement et son libellé — si le consentement est requis, la case doit être cochée. Inspectez la console de la page pour détecter d'éventuelles erreurs JavaScript et confirmez que les cookies/le stockage local ne sont pas bloqués.
  • Le récepteur du webhook ne reçoit pas de requête. Vérifiez que l'URL est accessible depuis le serveur, qu'elle utilise HTTPS et qu'elle n'est pas bloquée par un pare-feu. Consultez l'écran Logs pour détecter d'éventuelles erreurs de distribution.
  • La signature du webhook ne se valide pas. Assurez-vous que les deux parties utilisent le même secret et que le récepteur calcule le HMAC-SHA256 du corps brut du POST, et non d'un JSON pré-analysé.
  • Les créneaux d'essai routier sont manquants. Assurez-vous que l'heure de fin (End Time) est postérieure à l'heure de début (Start Time) et que la date ne figure pas dans les dates bloquées (Blocked Dates). Si aucun jour n'est coché, tous les jours sont ouverts par défaut.
  • Les modèles d'e-mail affichent des variables de substitution littérales. Confirmez que le texte de la variable correspond exactement (y compris les accolades) et qu'il s'agit de l'un des jetons pris en charge.

Documents connexes