Riferimento Leads

Questo documento rappresenta il riferimento per la schermata Leads del plugin ADP Car Market Hub (Car Market Hub → Leads). Copre la casella di posta dei lead, la configurazione del modulo di contatto, le opzioni di consenso e privacy, i messaggi di notifica, il modulo di prenotazione del test drive (Test Drive Booking), i webhook e i modelli di email.

Quando usare questo documento

Utilizza questo riferimento quando desideri esaminare gli invii dei moduli di contatto, modificare i campi che appaiono nel modulo, rispettare i requisiti di consenso GDPR, configurare chi riceve le email di notifica dei lead, integrarti con un CRM esterno tramite webhook o abilitare la funzionalità di prenotazione del test drive sulle pagine dei singoli veicoli.

Panoramica

La schermata Leads è suddivisa in una tabella Lead Inquiries e in una serie di schede di impostazioni organizzate come segue:

1. Lead Inquiries — elenco ricercabile e impaginato di tutti gli invii con azioni di massa ed esportazione in formato CSV.
2. Recipient Email Override + Form Fields (riga affiancata).
3. Consent & Privacy + Notification Messages (riga affiancata).
4. Test Drive Booking (scheda a larghezza intera).
5. Webhooks.
6. Email Templates.

Tutte le schede delle impostazioni condividono lo stesso modulo, pertanto il salvataggio di una qualsiasi di esse salva l'intera pagina.

Requisiti o prerequisiti

• Autorizzazione a gestire il plugin.
• Servizio di posta WordPress funzionante. Il plugin utilizza la posta standard di WordPress; se il tuo sito non può inviare email, configura l'SMTP separatamente.
• Per i webhook: un endpoint esterno in grado di accettare richieste HTTPS POST.
• Per il Test Drive Booking: abilitare l'opzione di attivazione e definire almeno la finestra temporale.

Istruzioni passo dopo passo

Esaminare e gestire i lead

1. Apri Car Market Hub → Leads.
2. Utilizza il campo Search per filtrare per nome, email, testo del messaggio o veicolo.
3. La tabella elenca ogni invio con le colonne Date, Name, Email, Phone, Vehicle, Type, Appointment e Actions. Il valore Vehicle rimanda all'annuncio live (si apre in una nuova scheda); il badge Type mostra se il lead è una richiesta di informazioni (Inquiry) o un test drive (Test Drive).
4. Fai clic sull'icona View (occhio) su una riga per aprire il modale Lead Details (Date, Name, Email, Phone, Vehicle, Type, Appointment, Message).
5. Fai clic sull'icona Delete (cestino) per rimuovere un singolo lead, oppure seleziona le righe e utilizza l'azione di massa Delete selected + Apply per rimuoverne diversi contemporaneamente.
6. Utilizza Export CSV nella barra degli strumenti per scaricare tutti i lead corrispondenti al filtro corrente.

Configurare il modulo di contatto

1. In Recipient Email Override, lascia il campo vuoto per utilizzare la catena di fallback (email pubblica del venditore → email dell'account WordPress → email dell'amministratore del sito), oppure inserisci uno o più indirizzi separati da virgole.
2. In Form Fields, disattiva Phone e/o Message se non ne hai bisogno. Name ed Email sono sempre richiesti.
3. In Consent & Privacy, abilita la casella di controllo del consenso, imposta il testo dell'etichetta e, facoltativamente, fornisci l'URL di una pagina sulla Privacy — le parole "privacy policy" nell'etichetta verranno quindi collegate a tale URL.
4. In Notification Messages, personalizza i messaggi di successo e di errore mostrati ai visitatori dopo l'invio.
5. Fai clic su qualsiasi pulsante Save Leads settings.

Abilitare il Test Drive Booking

1. Apri la scheda Test Drive Booking.
2. Attiva l'opzione Enable Test Drive booking. La barra di riepilogo in tempo reale nella parte superiore della scheda riflette la configurazione attiva: un punto di stato (Active / Inactive), il numero di giorni selezionati, l'intervallo orario, l'etichetta della durata dello slot (es. "30 min slots") e un badge "N blocked dates" quando ci sono date bloccate.
3. In Available Days, seleziona i giorni della settimana in cui è possibile prenotare gli appuntamenti. Lasciali tutti deselezionati per consentire tutti i giorni.
4. Aggiungi le Blocked Dates nel formato YYYY-MM-DD, una per riga.
5. Imposta Start Time, End Time e Slot Duration (minutes) (5–480, intervallo di 5; minimo 5 minuti).
6. Salva.

Configurare i webhook per sistemi esterni

1. Inserisci l'URL in New lead webhook URL per ricevere un HTTP POST quando un visitatore invia il modulo di contatto.
2. Inserisci l'URL in New import webhook URL per ricevere un HTTP POST quando un veicolo viene importato o aggiornato.
3. Facoltativamente, imposta un Webhook secret. Il plugin firma ogni richiesta con HMAC-SHA256 e invia la firma nell'intestazione X-AS24CI-Signature per la verifica. Una volta memorizzato un segreto, viene visualizzata una nota di conferma e il segnaposto del campo cambia in "Leave empty to keep the current secret" — il segreto memorizzato viene sovrascritto solo se digiti un nuovo valore, quindi lasciando il campo vuoto rimarrà invariato.
4. Salva. Lascia un URL vuoto per disabilitare quel webhook.

Personalizzare i modelli di email

1. Apri la scheda Email Templates.
2. Modifica l'oggetto della notifica per il concessionario, l'oggetto della conferma per il cliente e i corrispondenti corpi delle email in formato HTML.
3. Utilizza i segnaposto per inserire i dati del lead e del veicolo: {name}, {email}, {phone}, {message}, {vehicle_title}, {vehicle_url}.
4. Lascia qualsiasi campo vuoto per utilizzare il valore predefinito integrato.
5. Salva.

Riferimento di configurazione

Tabella Lead Inquiries

Recipient Email Override

Form Fields

Consent & Privacy

Notification Messages

Test Drive Booking

Webhooks

Email Templates

Segnaposto supportati: {name}, {email}, {phone}, {message}, {vehicle_title}, {vehicle_url}.

Note operative

• Tutte le schede delle impostazioni appartengono a un unico modulo. Qualsiasi pulsante Save Leads settings invia e salva ogni campo della pagina.
• L'invio delle email utilizza la posta standard di WordPress. I rimbalzi, la recapitabilità e i filtri antispam sono al di fuori del controllo del plugin.
• La firma del webhook viene ricalcolata per ogni payload. Per verificarla sul lato ricevente, calcola HMAC-SHA256(payload, secret) e confrontala con l'intestazione X-AS24CI-Signature.
• Test Drive Booking mostra il modulo di prenotazione solo quando l'interruttore principale è attivo. Senza giorni selezionati, tutti i giorni sono considerati disponibili.
• I lead sono memorizzati in un custom post type, quindi i backup e le esportazioni li coprono automaticamente. L'esportazione CSV rispetta il filtro di ricerca attivo.
• Il modale Lead Details è di sola lettura; per aggiungere note interne o lo stato del flusso di lavoro, utilizza un CRM tramite l'integrazione webhook.

Risoluzione dei problemi

• Non si ricevono email. Verifica che il sito WordPress possa inviare posta (fai un test con un altro plugin o un test a livello di sito). Controlla che non ci siano errori di battitura nel campo di override del destinatario.
• I visitatori non possono inviare il modulo. Controlla l'interruttore del consenso e l'etichetta — se il consenso è richiesto, la casella di controllo deve essere spuntata. Ispeziona la console della pagina per verificare la presenza di errori JavaScript e conferma che i cookie/local storage non siano bloccati.
• Il ricevitore del webhook non riceve alcuna richiesta. Verifica che l'URL sia raggiungibile dal server, utilizzi HTTPS e non sia bloccato da un firewall. Controlla la schermata Logs per verificare la presenza di errori di consegna.
• La firma del webhook non viene convalidata. Assicurati che entrambe le parti utilizzino lo stesso segreto e che il ricevitore calcoli l'HMAC-SHA256 del corpo POST non elaborato, non di un JSON pre-analizzato.
• Mancano gli slot per il Test Drive. Assicurati che End Time sia successivo a Start Time e che la data non sia presente in Blocked Dates. Se non viene selezionato alcun giorno, per impostazione predefinita tutti i giorni sono aperti.
• I modelli di email mostrano i segnaposto letterali. Verifica che il testo del segnaposto corrisponda esattamente (comprese le parentesi graffe) e che sia uno dei token supportati.

Documenti correlati

• Riferimento impostazioni
• Riferimento registri
• Riferimento Analytics
• Riferimento avvisi di ricerca