Lead in formato JSONLead: specifica

Specifica JSONLead dei lead: campi e metodi di consegna via email, webhook o SFTP.

Automatizzare il flusso di vendite e collegarlo con il tuo sistema di gestione o ERP non è mai stato così facile. Con il nostro sistema, ogni lead che si genera sul portale viene inviato in modo strutturato affinché tu possa elaborarlo automaticamente senza complicazioni. Qui ti spieghiamo come funziona e come puoi implementare questa integrazione.

Formato di invio: JSONLead come standard di mercato

Per garantire compatibilità e facilità di integrazione, utilizziamo il formato JSONLead. Questo formato è ampiamente riconosciuto sul mercato e facilita l'elaborazione automatica delle vendite nei sistemi di terze parti.

Metodi di invio disponibili

Hai tre opzioni per ricevere i lead. In ogni caso il contenuto del lead in formato json sarà lo stesso.

Webhook: L'opzione più rapida e diretta. I lead vengono inviati immediatamente all'URL del tuo sistema configurato per riceverli (richiesta POST). Se per motivi di sicurezza hai bisogno di qualsiasi tipo di header personalizzato, possiamo aggiungerlo senza problemi.
SFTP/FTP: Puoi utilizzare il nostro server SFTP o uno tuo (SFTP/FTP) per ricevere i dati. Verrà creato un file json per ogni lead.
Email: Se preferisci, possiamo inviarti i lead in formato JSONLead come corpo delle email.

Esempio di JSONLead inviato

{
  "client": {
      "foreign_id": "1df807f0ba96f8be5529308f6667a144",
      "first_name": "John",
      "postal_code": "76119",
      "phone": "600000000",
      "email": "user@mail.com"
  },
  "sales_lead": {
      "origin": {
          "source": "portal_hero",
          "medium": "Ebay"
      },
      "related_urls": [
          "https://portal.com/item/1234"
      ],
      "custom": {
          "account": "some_email@mail.com",
          "external_id": "1243948",
          "title": "Some pretty product",
          "created_at": "2025-01-17 10:25:22.145432"
      },
      "foreign_id": "17-12583-30383",
      "inquiry": "[{\"created_at\": \"2022-10-31T20:03:21.360000\",\"text\": \"Te dejo mi numero de telefono 6XXXXXXXXX\"}, {\"created_at\":\"2022-10-31T19:50:55.194000\", \"text\": \"Hola!\"}]"
  },
  "version": "1.0.0"
}

Dettagli dei campi del JSONLead

Nome	Tipo	Obbligatorio	Descrizione
`client.foreign_id`	string	Sì	Identificatore univoco del cliente.
`client.first_name`	string	Sì	Nome del cliente. A seconda del portale può essere un nome utente.
`client.postal_code`	string	No	Codice postale dell'indirizzo del cliente.
`client.phone`	string	No	Numero di telefono del cliente.
`client.email`	string	No	Email del cliente.
`sales_lead.origin.source`	string	Sì	Origine della vendita. Sarà sempre "portal_hero".
`sales_lead.origin.medium`	string	No	Nome del portale da cui proviene la vendita.
`sales_lead.related_urls`	array	No	Url rilevante/i. Normalmente l'url dell'articolo sul portale.
`sales_lead.custom.account`	string	No	Email o identificatore dell'account sul portale. Utile quando si gestiscono più account sullo stesso portale per poter identificare l'account di origine della vendita.
`sales_lead.custom.external_id`	string/arraystring*	Sì	Identificatore univoco dell'articolo. Lo stesso che ci inviate nel caricamento degli articoli.
`sales_lead.custom.title`	string/arraystring*	Sì	Titolo del prodotto venduto.
`sales_lead.custom.created_at`	datetime	Sì	Data e ora della creazione della vendita.
`sales_lead.foreign_id`	string	Sì	Identificatore univoco della vendita.
`sales_lead.inquiry`	array	No	Conversazione avuta con l'utente sul portale.
`version`	string	Sì	Versione dello schema di jsonLead. Versione 1.0.0 per il momento.

Vantaggi di questa integrazione

Automazione completa: Elabora automaticamente i lead nel tuo sistema di gestione.
Standardizzazione: Il formato JSONLead assicura compatibilità con la maggior parte dei sistemi del mercato.
Flessibilità: Scegli tra webhook, SFTP o email a seconda di ciò che meglio si adatta alle tue esigenze.

Integra questa soluzione nel tuo flusso di lavoro e ottimizza la gestione dei tuoi lead con rapidità, precisione e facilità. Se hai bisogno di maggiori dettagli o supporto tecnico, contattaci! 🚀