Flusso di lavoro per la gestione dei lead

Questo documento descrive come le richieste dei clienti (lead) vengono create, memorizzate, esaminate e processed nel plugin ADP Car Market Hub. Copre i dati dei lead, la gestione dello stato, l'esportazione in CSV, l'instradamento delle e-mail, la configurazione del consenso, la personalizzazione dei modelli di e-mail e l'integrazione dei webhook.

Quando utilizzare questo documento

Leggere questo documento se si desidera:

• Esaminare, elaborare o esportare le richieste dei clienti ricevute tramite le pagine di dettaglio dei veicoli.
• Configurare l'indirizzo e-mail del destinatario, la casella di controllo del consenso o i modelli di notifica e-mail.
• Instradare i lead a un CRM esterno o a un sistema di notifica tramite webhook.
• Comprendere quali dati vengono memorizzati e come i lead sono collegati ai record dei veicoli.

Per un rapido flusso di lavoro di revisione giornaliera, consultare i Flussi di lavoro per l'uso quotidiano.

---

Panoramica

Quando un visitatore invia una richiesta di contatto o una richiesta di prova su strada nella pagina di dettaglio di un veicolo, il plugin:

1. Valida l'invio (campi obbligatori, verifica del nonce, controllo spam honeypot, limitazione della frequenza).
2. Invia un'e-mail di notifica in formato HTML al destinatario configurato.
3. Invia un'e-mail di conferma in formato HTML al visitatore.
4. Salva il lead come custom post WordPress (as24ci_lead).
5. Attiva l'action hook as24ci_lead_saved (che avvia il webhook se configurato).
6. Traccia un evento analitico lead_sent (se Analytics è abilitato).

Tutti i lead sono accessibili nella scheda amministrativa ADP Car Market Hub → Leads.

---

Requisiti o prerequisiti

• Una pagina di dettaglio del veicolo deve essere accessibile ai visitatori e il modulo di contatto deve essere abilitato.
• Affinché le notifiche e-mail vengano recapitate, WordPress deve essere in grado di inviare e-mail tramite wp_mail(). Su molti ambienti di hosting condiviso questo funziona immediatamente. Su alcuni server, potrebbe essere richiesto un plugin SMTP.
• Il campo Recipient email nella scheda Leads deve essere configurato per garantire che le notifiche arrivino all'indirizzo corretto.
• Per utilizzare la funzionalità di prova su strada, questa deve essere abilitata in Features e i giorni disponibili, la finestra temporale e la durata dello slot devono essere configurati nella scheda Leads.

---

Campi dati del lead

Ogni lead memorizza le seguenti informazioni:

---

Istruzioni passo-passo

Esaminare i lead

1. Navigare su ADP Car Market Hub → Leads.
2. L'elenco dei lead è ordinato a partire dagli invii più recenti.
3. Ogni riga mostra: data, nome, e-mail, telefono, veicolo, messaggio (troncato) e stato corrente.
4. Utilizzare la casella di ricerca per trovare i lead per nome, e-mail, titolo del veicolo o AutoScout24 listing ID.
5. Utilizzare il filtro di stato per mostrare solo i lead con uno stato specifico (New, Contacted, Closed o Spam).
6. Fare clic sulla riga di un lead per visualizzare i dettagli completi, inclusi il link al veicolo e la data dell'appuntamento.

Modificare lo stato di un lead

Lo stato del lead traccia la fase in cui si trova ciascuna richiesta nel processo di vendita:

Per modificare lo stato di un lead:

1. Trovare il lead nella scheda Leads.
2. Selezionare il nuovo stato dal menu a discesa dello stato accanto al lead.
3. La modifica viene salvata immediatamente.

Esportare i lead in CSV

1. Navigare su ADP Car Market Hub → Leads.
2. Facoltativamente, applicare un filtro di ricerca o un filtro di stato per esportare solo un sottoinsieme di lead.
3. Fare clic sul pulsante Export CSV.
4. Viene scaricato un file CSV. Il nome del file include la data corrente (ad esempio, leads-2026-04-30.csv).
5. Il file CSV include un BOM UTF-8 in modo da aprirsi correttamente in Microsoft Excel senza problemi di codifica.
6. Le colonne del CSV sono: Date, Name, Email, Phone, Vehicle Title, Vehicle ID, Message, Test Drive (Yes/No), Appointment.

Eliminare un lead

1. Trovare il lead nella scheda Leads.
2. Fare clic sul pulsante Delete accanto al lead.
3. Confermare l'eliminazione quando richiesto. Questo rimuove permanentemente il lead e i suoi metadati.

---

Configurazione delle impostazioni dei lead

Le impostazioni dei lead si trovano nella scheda ADP Car Market Hub → Leads (sezione Settings).

Recipient email

Il plugin utilizza il seguente ordine di priorità per determinare dove inviare le e-mail di notifica dei lead:

1. Global recipient email override (scheda Leads → campo Recipient Email). Supporta un elenco di indirizzi e-mail separati da virgole per la consegna a più destinatari.
2. Contatto CMH Team — l'e-mail del membro del team attivo associato al veicolo (assegnazione per singolo veicolo, impostazione predefinita della filiale o impostazione predefinita globale). Vedere CMH Team and Contact Routing.
3. Seller profile public email (memorizzata come user meta as24ci_seller_email sull'account utente dell'autore del veicolo).
4. E-mail dell'account WordPress dell'autore del veicolo.
5. E-mail dell'amministratore di WordPress (Impostazioni → Generale → Indirizzo e-mail di amministrazione) come fallback finale.

Per instradare tutte le notifiche dei lead a uno o più indirizzi fissi, inserirli nel campo Recipient Email nella scheda Leads. Quando la regola Send a copy to the general dealership email è abilitata in CMH Team, anche l'e-mail generale della concessionaria riceve una copia di ogni richiesta.

Visibilità dei campi del modulo

I campi Name ed Email sono sempre mostrati. I seguenti campi possono essere abilitati o disabilitati singolarmente:

• Phone number field — mostra o nasconde il campo del telefono nel modulo di contatto.
• Message field — mostra o nasconde il campo del messaggio a testo libero. Se disabilitato, il messaggio non è richiesto e i lead non conterranno alcun testo del messaggio.

Casella di controllo del consenso

• Enable consent checkbox — se abilitata, viene mostrata una casella di controllo del consenso sul modulo di contatto. Il visitatore deve selezionarla prima di poter inviare il modulo.
• Consent text — l'etichetta mostrata accanto alla casella di controllo. In genere include un riferimento alla privacy policy.
• Privacy policy URL — URL della pagina della privacy policy. Può essere collegato dal testo del consenso.

Queste impostazioni sono memorizzate in base alle opzioni del plugin e hanno effetto immediato sul modulo di contatto del frontend.

---

Modelli di e-mail

Il plugin supporta oggetti e modelli di corpo e-mail personalizzati sia per la notifica al concessionario sia per l'e-mail di conferma al cliente.

I modelli supportano i seguenti token {placeholder}:

E-mail del concessionario:

• Subject — personalizza l'oggetto dell'e-mail di notifica inviata al destinatario. Se lasciato vuoto, viene utilizzato l'oggetto predefinito ("Vehicle inquiry: {vehicletitle}" o "Test drive request: {vehicletitle}").
• Body — corpo dell'e-mail HTML completo. Se lasciato vuoto, viene utilizzato il modello predefinito.

E-mail di conferma del cliente:

• Subject — personalizza l'oggetto della conferma inviata al visitatore.
• Body — corpo della conferma HTML completo.

Quando vengono configurati modelli personalizzati, questi sostituiscono interamente il contenuto predefinito. L'intestazione Reply-To dell'e-mail di notifica del concessionario è impostata sul nome e sull'indirizzo e-mail del cliente.

---

Integrazione dei webhook

Il plugin può attivare webhook in uscita sugli eventi dei lead per l'integrazione con sistemi esterni (CRM, Slack, Zapier e così via).

La configurazione si trova nella sezione delle impostazioni Leads:

Il payload del webhook per un nuovo lead include: nome dell'evento (new_lead), timestamp, ID del lead e dati del lead (nome, e-mail, telefono, messaggio, ID del veicolo, titolo del veicolo, URL del veicolo).

I tentativi di consegna del webhook falliti vengono ripetuti fino a 3 volte tramite WP-Cron.

La firma HMAC-SHA256 è inclusa nell'intestazione della richiesta e può essere utilizzata dall'endpoint ricevente per verificarne l'autenticità. Non condividere pubblicamente il webhook secret.

---

Note operative

• Limitazione della frequenza: il modulo di contatto accetta un massimo di 5 invii per indirizzo IP ogni 5 minuti. Gli invii che superano questo limite ricevono una risposta di errore senza creare un lead o inviare un'e-mail.
• Protezione spam honeypot: il modulo di contatto include un campo nascosto che gli utenti umani lasciano vuoto ma che i bot automatizzati in genere compilano. Quando il campo honeypot viene compilato, l'invio viene rifiutato silenziosamente.
• Memorizzazione dei lead: i lead vengono memorizzati come custom post WordPress (as24ci_lead). Non sono visibili pubblicamente e non compaiono negli elenchi standard dei post a meno che non vi si acceda tramite la scheda amministrativa Leads.
• Conservazione dei dati: i lead rimangono in WordPress fino a quando non vengono eliminati manualmente o fino a quando il plugin non viene disinstallato con l'opzione "Delete data on uninstall" abilitata nelle Impostazioni.
• Lead di prova su strada: le prenotazioni delle prove su strada sono memorizzate anch'esse come lead con is_test_drive = 1 e un appointment_date. Appaiono nella stessa scheda Leads e nell'esportazione CSV insieme alle normali richieste di contatto.
• Tracciamento analitico: quando un lead viene salvato con successo e la funzionalità Analytics è abilitata, viene tracciato un evento lead_sent per il veicolo.
• Destinatari multipli: per inviare le notifiche dei lead a più indirizzi e-mail, inserirli come elenco separato da virgole nel campo Recipient Email.

---

Risoluzione dei problemi

---

Documenti correlati

• Flussi di lavoro per l'uso quotidiano
• Manuale utente
• Manuale dell'amministratore
• Vehicle Import Workflow
• Flusso di lavoro per l'uso del frontend

---