Esportazione Lead
L'endpoint di esportazione lead permette ai dealer di recuperare tutte le lead e le chiamate ricevute in un determinato periodo.
Ogni richiesta restituisce un oggetto contenente due array: leads (contatti ricevuti tramite form) e calls (chiamate telefoniche tracciate).
Nota: Questo endpoint è disponibile su https://autosupermarket.it e non su https://api.autosupermarket.it.
L'oggetto lead
Attributi
id integer
Identificatore univoco della lead.
name string
Nome dell'utente interessato.
surname string
Cognome dell'utente interessato.
email string
Indirizzo email dell'utente.
telephone object
Dati del telefono dell'utente:
- prefix: prefisso internazionale
- telephone: numero di telefono
message string
Messaggio inviato dall'utente al concessionario.
action string
Tipo di azione effettuata dall'utente. Valori possibili:
- start-chat: invio di una richiesta di informazioni generica
- show-telephone: visualizzazione del numero di telefono
- show-whatsapp: click su WhatsApp
- add-price-alert: aggiunta di un alert di prezzo
- schedule-appointment: prenotazione di un appuntamento
url string
URL della pagina da cui proviene la richiesta.
createdAt datetime
Data e ora di creazione della lead (formato ISO 8601).
listing object | null
Informazioni sull'annuncio correlato (se presente):
- id: ID dell'annuncio
- externalId: ID esterno dell'annuncio
- slug: slug URL dell'annuncio
- address: oggetto indirizzo con proprietà "complete" (indirizzo completo formattato)
autoGenerated boolean
Indica se la lead è stata generata automaticamente dal sistema (true) o creata manualmente dall'utente (false).
{
"id": 304664,
"name": "Mario",
"surname": "Rossi",
"email": "[email protected]",
"telephone": {
"prefix": "39",
"telephone": "333 123 4567"
},
"message": "Buongiorno, sono interessato a questa Audi RS 3, vorrei chiedere se è possibile avere ulteriori informazioni.",
"url": "https://autosupermarket.it/annunci/audi-rs-3-rs-3-spb-benzina-2022-ab5fde28b8b539eb",
"action": "start-chat",
"listing": {
"id": 2648540,
"externalId": "22784950",
"slug": "audi-rs-3-rs-3-spb-benzina-2022-ab5fde28b8b539eb",
"address": {
"complete": "Via Valcamonica 19/h - 25132 Brescia (BS)"
}
},
"autoGenerated": false,
"createdAt": "2025-10-01T15:00:15+02:00"
}L'oggetto call
Attributi
id integer
Identificatore univoco della chiamata.
caller string
Numero di telefono del chiamante.
callee string
Numero di telefono chiamato (tracking number).
start datetime
Data e ora di inizio della chiamata (formato ISO 8601).
end datetime
Data e ora di fine della chiamata (formato ISO 8601).
duration integer
Durata della chiamata in secondi.
summary string | null
Riepilogo automatico della conversazione (quando disponibile).
{
"id": 789,
"caller": "+393331234567",
"callee": "+390303456789",
"start": "2025-10-15T09:30:15+00:00",
"end": "2025-10-15T09:35:42+00:00",
"duration": 327,
"summary": "Cliente interessato al veicolo Fiat 500, richiesta informazioni su finanziamento e disponibilità per test drive."
}Esporta lead e chiamate
Recupera tutte le lead e le chiamate ricevute dal dealer in un determinato periodo.
Parametri URL
token required string
Token di autenticazione del dealer. Questo token identifica univocamente il dealer richiedente e autorizza l'accesso alle sue lead.
Query Parameters
fromDate date
Data di inizio del periodo da cui recuperare le lead (formato: YYYY-MM-DD). Se non specificato, il default è la data di ieri.
Risposta
Restituisce un oggetto contenente due array:
- leads: array di oggetti lead per il periodo specificato (max 1000 elementi)
- calls: array di oggetti call per il periodo specificato (max 1000 elementi)
curl -X GET \
'https://autosupermarket.it/_lead_connector/custom/86da26e83cc579a00ae4b537a2c3297c?fromDate=2025-10-01'{
"leads": [
{
"id": 304664,
"name": "Mario",
"surname": "Rossi",
"email": "[email protected]",
"telephone": {
"prefix": "39",
"telephone": "333 123 4567"
},
"message": "Buongiorno, sono interessato a questo veicolo, vorrei avere maggiori informazioni.",
"url": "https://autosupermarket.it/annunci/audi-rs-3-rs-3-spb-benzina-2022-ab5fde28b8b539eb",
"action": "start-chat",
"listing": {
"id": 2648540,
"externalId": "22784950",
"slug": "audi-rs-3-rs-3-spb-benzina-2022-ab5fde28b8b539eb",
"address": {
"complete": "Via Valcamonica 19/h - 25132 Brescia (BS)"
}
},
"autoGenerated": false,
"createdAt": "2025-10-01T15:00:15+02:00"
},
{
"id": 304760,
"name": "Luca",
"surname": "Bianchi",
"email": "[email protected]",
"telephone": {
"prefix": "39",
"telephone": "334 987 6543"
},
"message": null,
"url": "https://autosupermarket.it/annunci/peugeot-5008-bluehdi-130-diesel-2023-4cdffe0c6b9f60b9",
"action": "add-price-alert",
"listing": {
"id": 1986101,
"externalId": "21700643",
"slug": "peugeot-5008-bluehdi-130-diesel-2023-4cdffe0c6b9f60b9",
"address": {
"complete": "Via Valcamonica 19/h - 25132 Brescia (BS)"
}
},
"autoGenerated": false,
"createdAt": "2025-10-01T16:58:38+02:00"
},
{
"id": 313188,
"name": "Gaia",
"surname": "Verdi",
"email": "[email protected]",
"telephone": {
"prefix": "39",
"telephone": "333 691 1333"
},
"message": null,
"url": "https://autosupermarket.it/annunci/dr-5-0-5-0-gpl-2023-89c1187ff8c1e848",
"action": "schedule-appointment",
"listing": {
"id": 2554548,
"externalId": "22603167",
"slug": "dr-5-0-5-0-gpl-2023-89c1187ff8c1e848",
"address": {
"complete": "Via Valcamonica 19/h - 25132 Brescia (BS)"
}
},
"autoGenerated": false,
"createdAt": "2025-10-14T22:12:58+02:00"
}
],
"calls": [
{
"id": 41401,
"caller": "+393348855150",
"callee": "+390306492649",
"start": "2025-10-02T10:46:24+02:00",
"end": "2025-10-02T10:49:39+02:00",
"duration": 195,
"summary": "Cliente interessato a una Fiat Tipo, ha richiesto informazioni su finanziamento e documentazione necessaria."
},
{
"id": 41928,
"caller": "+393452751300",
"callee": "+390306492649",
"start": "2025-10-04T09:25:09+02:00",
"end": "2025-10-04T09:26:20+02:00",
"duration": 71,
"summary": null
}
]
}