Lead

L'oggetto Lead rappresenta una richiesta di contatto da parte di un utente interessato ad un annuncio.

Questo oggetto viene incluso negli script LD+JSON all'interno delle email inviate ai concessionari quando un utente manifesta interesse per un veicolo.

Informazione

L'oggetto Lead non è accessibile tramite chiamate API dirette, ma viene fornito come parte del contenuto LD+JSON nelle email di notifica delle lead.

L'oggetto lead

Attributi

id integer

Identificatore univoco della lead.

name string

Nome dell'utente interessato. Se non impostato, il valore sarà "Non condiviso".

surname string

Cognome dell'utente interessato. Se non impostato o se viene fornito solo il nome, il valore sarà "Non condiviso".

email string

Indirizzo email dell'utente.

telephone object

Dati del telefono dell'utente:

  • prefix: prefisso internazionale (default: "39")
  • telephone: numero di telefono (default: "Non condiviso" se non impostato)

message string

Messaggio inviato dall'utente al concessionario.

url string

URL della pagina da cui proviene la richiesta, con eventuali parametri di ricerca.

listing object

Informazioni essenziali sull'annuncio di interesse:

  • vehicle: dati del veicolo (targa e telaio)
  • externalId: ID esterno dell'annuncio
  • price: prezzo del veicolo
  • headquarter: dati della sede
  • title: titolo dell'annuncio
  • brand: marca del veicolo
  • model: modello del veicolo
  • url: URL dell'annuncio
  • address: indirizzo completo della sede

headquarter object

Dati della sede a cui è indirizzata la lead:

  • id: ID della sede
  • name: nome della sede
  • address: indirizzo della sede (città)

metadata object | array

Oggetto generico contenente metadati aggiuntivi a uso interno. In alcune circostanze può essere un array.

L'oggetto Lead 
{
  "id": 57,
  "name": "Mario",
  "surname": "Rossi",
  "email": "[email protected]",
  "telephone": {
    "prefix": "39",
    "telephone": "333 123 4567"
  },
  "message": "Buongiorno,\n\nti propongo la mia offerta per la tua Fiat 500: 13800 €",
  "url": "https://autosupermarket.wip/annunci/fiat-500-1-2-benzina-2020-4f48ac59a24048e8?search=https://autosupermarket.wip/auto-usate?t%3De689h",
  "listing": {
    "vehicle": {
      "plate": "AB123CD",
      "vin": "ZFA3120000XXXXXXX"
    },
    "externalId": "22471969",
    "price": 13900,
    "headquarter": {
      "id": 1,
      "name": "Concessionaria Auto Example",
      "address": {
        "city": "Milano"
      }
    },
    "title": "1.2 LOUNGE NEOPATENTATI CABRIO",
    "brand": {
      "name": "Fiat"
    },
    "model": {
      "name": "1.2"
    },
    "url": "https://autosupermarket.wip/annunci/fiat-500-1-2-benzina-2020-4f48ac59a24048e8",
    "address": {
      "complete": "Via Roma, 123 - 20100 Milano (MI)"
    }
  },
  "headquarter": {
    "id": 1,
    "name": "Concessionaria Auto Example",
    "address": {
      "city": "Milano"
    }
  },
  "metadata": {
    "foo": "bar",
    "baz": 123
  }
}