Lead

Rappresenta un lead: contatto o richiesta in ingresso ancora da qualificare o in fase di nurturing. Include identificativo, canale, stato della pipeline (status), provenienza (source), punteggio (score), dati anagrafici e azienda, referente commerciale (ownerId), note, tag e un oggetto opzionale customFields per estensioni. È il modello tipico per flussi che acquisiscono contatti da web, eventi o import e li allineano verso un CRM.

Esempio JSON completo

{
  "id": "lead_7aBc2DeF9Gh0",
  "channel": "demoipaas",
  "createdAt": "2026-01-10T09:00:00+00:00",
  "updatedAt": "2026-01-28T14:22:00+00:00",
  "status": "qualified",
  "source": "web_form",
  "score": 72,
  "companyName": "Acme SpA",
  "email": "l.bianchi@acme.test",
  "firstName": "Laura",
  "lastName": "Bianchi",
  "phone": "+39 02 12345678",
  "jobTitle": "Responsabile acquisti",
  "ownerId": "usr_4Km9NpQr2St5",
  "notes": "Interessata a demo Q1",
  "tags": ["b2b", "manufacturing"],
  "customFields": {
    "campaignId": "camp_winter2026"
  }
}

Note

• Gli identificativi (id, ownerId, valori in customFields) sono illustrativi; in produzione seguono il formato del CRM o connettore collegato.
• I valori di status e source dipendono dalla configurazione del flusso e dalla mappatura verso la destinazione.
• score può essere calcolato da regole interne o ricevuto dal sistema sorgente; non è obbligatorio in tutti i connettori.