Documentation · Manuel de l'utilisateur

Flux de travail de gestion des leads

Ce document décrit comment les demandes de renseignements des clients (leads) sont créées, stockées, examinées et traitées dans l'extension ADP Car Market Hub. Il couvre les données des leads, la gestion des statuts, l'exportation CSV, le routage des e-mails, la configuration du consentement, la personnalisation des modèles d'e-mail et l'intégration des webhooks.

Quand utiliser ce document

Lisez ce document si vous :

Devez examiner, traiter ou exporter les demandes de renseignements des clients reçues via les pages de détails des véhicules.
Configurez l'adresse e-mail du destinataire, la case à cocher de consentement ou les modèles de notification par e-mail.
Souhaitez acheminer les leads vers un CRM externe ou un système de notification via un webhook.
Devez comprendre quelles données sont stockées et comment les leads sont connectés aux fiches de véhicules.

Pour un flux de travail d'examen quotidien rapide, consultez les Flux de travail d'utilisation quotidienne.

Aperçu

Lorsqu'un visiteur soumet une demande de contact ou une demande d'essai routier sur une page de détails de véhicule, l'extension :

Valide la soumission (champs obligatoires, vérification du nonce, contrôle anti-spam honeypot, limitation du débit).
Envoie un e-mail de notification HTML au destinataire configuré.
Envoie un e-mail de confirmation HTML au visiteur.
Enregistre le lead en tant que type de contenu personnalisé WordPress (as24ci_lead).
Déclenche le crochet d'action as24ci_lead_saved (qui déclenche le webhook s'il est configuré).
Enregistre un événement d'analyse lead_sent (si l'analyse est activée).

Tous les leads sont accessibles dans l'onglet d'administration ADP Car Market Hub → Leads.

Configuration requise ou prérequis

Une page de détails de véhicule doit être accessible aux visiteurs et le formulaire de contact doit être activé.
Pour que les notifications par e-mail soient distribuées, WordPress doit pouvoir envoyer des e-mails via wp_mail(). Sur de nombreux environnements d'hébergement mutualisé, cela fonctionne immédiatement. Sur certains serveurs, une extension SMTP peut être requise.
Le champ E-mail du destinataire de l'onglet Leads doit être configuré pour garantir que les notifications parviennent à la bonne adresse.
Pour utiliser la fonctionnalité d'essai routier, elle doit être activée dans Fonctionnalités et les jours disponibles, la plage horaire et la durée des créneaux doivent être configurés dans l'onglet Leads.

Champs de données des leads

Chaque lead stocke les informations suivantes :

Champ	Description
Nom	Nom complet du client (toujours obligatoire)
E-mail	Adresse e-mail du client (toujours obligatoire)
Téléphone	Numéro de téléphone du client (facultatif ; contrôlé par le réglage de visibilité du champ)
Message	Message de demande en texte libre (facultatif ; contrôlé par le réglage de visibilité du champ)
Titre du véhicule	Titre du véhicule concerné par la demande
ID du véhicule	ID de publication WordPress du véhicule
ID d'annonce AutoScout24	L'identifiant d'annonce AutoScout24 (utilisé pour lier à l'annonce d'origine)
URL du véhicule	Permalien vers la publication du véhicule dans WordPress
URL source	Page sur laquelle se trouvait le visiteur lors de la soumission du formulaire
Date	Date et heure UTC de réception du lead
E-mail envoyé	Indique si l'e-mail de notification a été distribué avec succès
Statut	Statut de traitement actuel (Nouveau, Contacté, Clôturé ou Spam)
Est un essai routier	Indique si ce lead est une demande de réservation d'essai routier
Date de rendez-vous	Date et créneau horaire demandés pour un essai routier (le cas échéant)

Instructions étape par étape

Examiner les leads

Accédez à ADP Car Market Hub → Leads.
La liste des leads est triée avec les soumissions les plus récentes en premier.
Chaque ligne affiche : la date, le nom, l'e-mail, le téléphone, le véhicule, le message (tronqué) et le statut actuel.
Utilisez la zone de recherche pour trouver des leads par nom, e-mail, titre de véhicule ou ID d'annonce AutoScout24.
Utilisez le filtre de statut pour afficher uniquement les leads ayant un statut spécifique (Nouveau, Contacté, Clôturé ou Spam).
Cliquez sur une ligne de lead pour afficher tous les détails, y compris le lien du véhicule et la date du rendez-vous.

Modifier le statut d'un lead

Le statut du lead permet de suivre l'état d'avancement de chaque demande dans votre processus de vente :

Statut	Signification
Nouveau	Reçu mais pas encore traité
Contacté	Le client a été contacté
Clôturé	La demande a été entièrement résolue
Spam	Identifié comme indésirable ou frauduleux

Pour modifier le statut d'un lead :

Trouvez le lead dans l'onglet Leads.
Sélectionnez le nouveau statut dans le menu déroulant de statut situé à côté du lead.
La modification est enregistrée immédiatement.

Exporter les leads au format CSV

Accédez à ADP Car Market Hub → Leads.
Appliquez éventuellement un filtre de recherche ou de statut pour n'exporter qu'un sous-ensemble de leads.
Cliquez sur le bouton Exporter en CSV.
Un fichier CSV est téléchargé. Le nom du fichier inclut la date du jour (par exemple, leads-2026-04-30.csv).
Le fichier CSV comprend un BOM UTF-8 afin de s'ouvrir correctement dans Microsoft Excel sans problème d'encodage.
Les colonnes du CSV sont : Date, Nom, E-mail, Téléphone, Titre du véhicule, ID du véhicule, Message, Essai routier (Oui/Non), Rendez-vous.

Supprimer un lead

Trouvez le lead dans l'onglet Leads.
Cliquez sur le bouton Supprimer à côté du lead.
Confirmez la suppression lorsque vous y êtes invité. Cela supprime définitivement le lead et ses métadonnées.

Configuration des réglages des leads

Les réglages des leads se trouvent dans l'onglet ADP Car Market Hub → Leads (section Réglages).

E-mail du destinataire

L'extension utilise l'ordre de priorité suivant pour déterminer où envoyer les e-mails de notification de lead :

Surcharge globale de l'e-mail du destinataire (onglet Leads → champ E-mail du destinataire). Prend en charge une liste d'adresses e-mail séparées par des virgules pour une distribution à plusieurs destinataires.
Contact CMH Team — l'e-mail du membre de l'équipe actif attribué au véhicule (attribution par véhicule, valeur par défaut de la succursale ou valeur par défaut globale). Voir CMH Team et routage des contacts.
E-mail public du profil du vendeur (stocké en tant que métadonnée utilisateur as24ci_seller_email sur le compte de l'auteur du véhicule).
E-mail du compte WordPress de l'auteur du véhicule.
E-mail d'administration WordPress (Réglages → Général → Adresse e-mail d'administration) comme dernier recours.

Pour acheminer toutes les notifications de leads vers une ou plusieurs adresses fixes, saisissez-les dans le champ E-mail du destinataire de l'onglet Leads. Lorsque la règle Envoyer une copie à l'e-mail général de la concession est activée dans CMH Team, l'e-mail général de la concession reçoit également une copie de chaque demande.

Visibilité des champs du formulaire

Les champs Nom et E-mail sont toujours affichés. Les champs suivants peuvent être activés ou désactivés individuellement :

Champ du numéro de téléphone — affiche ou masque le champ de téléphone sur le formulaire de contact.
Champ du message — affiche ou masque le champ de message en texte libre. S'il est désactivé, aucun message n'est requis et les leads ne contiendront aucun texte de message.

Case à cocher de consentement

Activer la case à cocher de consentement — lorsqu'elle est activée, une case à cocher de consentement s'affiche sur le formulaire de contact. Le visiteur doit la cocher avant de pouvoir soumettre le formulaire.
Texte de consentement — le libellé affiché à côté de la case à cocher. Comprend généralement une référence à votre politique de confidentialité.
URL de la politique de confidentialité — URL de votre page de politique de confidentialité. Peut être liée à partir du texte de consentement.

Ces réglages sont stockés conformément aux options de l'extension et prennent effet immédiatement sur le formulaire de contact du site public.

Modèles d'e-mails

L'extension prend en charge la personnalisation des objets d'e-mails et des modèles de corps de message pour l'e-mail de notification du concessionnaire et l'e-mail de confirmation du client.

Les modèles prennent en charge les jetons {placeholder} suivants :

Variable de remplacement	Remplacée par
`{customer_name}`	Nom du client
`{customer_email}`	E-mail du client
`{customer_phone}`	Numéro de téléphone du client
`{customer_message}`	Texte du message du client
`{vehicle_title}`	Titre du véhicule
`{vehicle_url}`	URL de la page de détails du véhicule
`{vehicle_price}`	Prix du véhicule
`{listing_id}`	ID d'annonce AutoScout24
`{appointment_date}`	Date et heure du rendez-vous d'essai routier (le cas échéant)

E-mail du concessionnaire :

Objet — personnalisez l'objet de l'e-mail de notification envoyé au destinataire. S'il est laissé vide, l'objet par défaut est utilisé (« Demande de renseignements sur le véhicule : {vehicletitle} » ou « Demande d'essai routier : {vehicletitle} »).
Corps — corps complet de l'e-mail au format HTML. S'il est laissé vide, le modèle par défaut est utilisé.

E-mail de confirmation du client :

Objet — personnalisez l'objet de la confirmation envoyée au visiteur.
Corps — corps complet de la confirmation au format HTML.

Lorsque des modèles personnalisés sont configurés, ils remplacent entièrement le contenu par défaut. L'en-tête Reply-To de l'e-mail de notification du concessionnaire est défini avec le nom et l'adresse e-mail du client.

Intégration des webhooks

L'extension peut déclencher des webhooks sortants lors d'événements liés aux leads pour une intégration avec des systèmes externes (CRM, Slack, Zapier, etc.).

La configuration s'effectue dans la section des réglages des Leads :

Champ	Description
URL du webhook (nouveau lead)	Point de terminaison HTTP appelé lorsqu'un nouveau lead est enregistré
URL du webhook (nouvel import)	Point de terminaison HTTP appelé lorsqu'un véhicule est importé ou mis à jour
Clé secrète du webhook	Utilisée pour signer la requête avec HMAC-SHA256 pour vérification par le destinataire

La charge utile (payload) du webhook pour un nouveau lead comprend : le nom de l'événement (new_lead), l'horodatage, l'ID du lead et les données du lead (nom, e-mail, téléphone, message, ID du véhicule, titre du véhicule, URL du véhicule).

Les envois de webhooks ayant échoué sont retentés jusqu'à 3 fois via WP-Cron.

La signature HMAC-SHA256 est incluse dans l'en-tête de la requête et peut être utilisée par le point de terminaison de réception pour vérifier l'authenticité. Ne partagez pas publiquement la clé secrète du webhook.

Notes opérationnelles

Limitation du débit : le formulaire de contact accepte un maximum de 5 soumissions par adresse IP toutes les 5 minutes. Les soumissions dépassant cette limite reçoivent une réponse d'erreur sans créer de lead ni envoyer d'e-mail.
Protection anti-spam honeypot : le formulaire de contact comprend un champ masqué que les humains laissent vide mais que les robots automatisés remplissent généralement. Lorsque le champ honeypot est rempli, la soumission est rejetée silencieusement.
Stockage des leads : les leads sont stockés en tant que types de contenu personnalisés WordPress (as24ci_lead). Ils ne sont pas visibles publiquement et n'apparaissent pas dans les listes d'articles standard, sauf si vous y accédez via l'onglet d'administration Leads.
Conservation des données : les leads restent dans WordPress jusqu'à ce qu'ils soient supprimés manuellement ou jusqu'à ce que l'extension soit désinstallée avec l'option « Supprimer les données lors de la désinstallation » activée dans les Réglages.
Leads d'essai routier : les réservations d'essais routiers sont également stockées en tant que leads avec is_test_drive = 1 et un appointment_date. Ils apparaissent dans le même onglet Leads et dans l'exportation CSV aux côtés des demandes de contact ordinaires.
Suivi analytique : lorsqu'un lead est enregistré avec succès et que la fonctionnalité d'analyse est activée, un événement lead_sent est enregistré pour le véhicule.
Destinataires multiples : pour envoyer des notifications de leads à plusieurs adresses e-mail, saisissez-les sous forme de liste séparée par des virgules dans le champ E-mail du destinataire.

Dépannage

Symptôme	Cause probable	À vérifier
E-mail de notification non reçu	La distribution d'e-mails WordPress ne fonctionne pas, ou aucun destinataire valide n'est configuré	Configurez l'e-mail du destinataire dans les réglages des Leads ; testez la distribution `wp_mail()` ; vérifiez le dossier des courriers indésirables ; envisagez d'installer une extension SMTP
E-mail de confirmation du visiteur non reçu	L'adresse e-mail du client est incorrecte, ou il y a un problème de distribution d'e-mails	Vérifiez l'adresse e-mail dans la fiche du lead ; vérifiez le dossier des courriers indésirables
Le formulaire rejette les soumissions valides	La case à cocher de consentement est obligatoire et n'est pas cochée, ou un champ obligatoire est vide	Vérifiez les réglages des Leads → visibilité des champs et réglages de consentement
Lead enregistré mais e-mail non envoyé	`wp_mail()` a renvoyé false	Vérifiez le champ méta `_as24ci_lead_email_sent` sur le lead ; examinez les journaux de messagerie du serveur
Le webhook ne reçoit pas de données	L'URL du webhook n'est pas enregistrée, est inaccessible ou renvoie une erreur	Vérifiez l'URL dans les réglages des Leads ; examinez les journaux du serveur pour détecter les échecs de distribution
L'onglet Leads n'affiche aucun résultat	Aucune soumission n'a encore été reçue, ou tous les leads ont été supprimés	Vérifiez que le formulaire de contact est visible sur les pages des véhicules ; soumettez une demande de test
L'exportation CSV présente des problèmes d'encodage	L'application n'interprète pas correctement le BOM UTF-8	Ouvrez le fichier CSV dans un éditeur de texte ou réimportez-le en spécifiant l'encodage UTF-8