Leads en format JSONLead: especificació

Especificació JSONLead de leads: camps i mètodes d'entrega per email, webhook o SFTP.

Automatitzar el flux de vendes i connectar-lo amb el teu sistema de gestió o ERP mai no ha estat tan fàcil. Amb el nostre sistema, cada lead que es genera al portal s'envia de manera estructurada perquè el puguis processar automàticament sense complicacions. Aquí t'expliquem com funciona i com pots implementar aquesta integració.

Format d'enviament: JSONLead com a estàndard de mercat

Per garantir compatibilitat i facilitat d'integració, fem servir el format JSONLead. Aquest format és àmpliament reconegut al mercat i facilita el processament automàtic de les vendes en sistemes de tercers.

Mètodes d'enviament disponibles

Tens tres opcions per rebre els leads. En qualsevol cas el contingut del lead en format json serà el mateix.

Webhook: L'opció més ràpida i directa. Els leads s'envien immediatament a la URL del teu sistema configurada per rebre'ls (petició POST). Si per qüestions de seguretat necessites qualsevol tipus de capçalera personalitzada la podem afegir sense problema.
SFTP/FTP: Pots utilitzar el nostre servidor SFTP o un de propi (SFTP/FTP) per rebre les dades. Es crearà un arxiu json per cada lead.
Email: Si ho prefereixes, podem enviar-te els leads en format JSONLead com a cos en correus electrònics.

Exemple de JSONLead enviat

{
  "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"
}

Detalls dels camps del JSONLead

Nom	Tipus	Obligatori	Descripció
`client.foreign_id`	string	Sí	Identificador únic del client.
`client.first_name`	string	Sí	Nom del client. En funció del portal pot ser un nom d'usuari.
`client.postal_code`	string	No	Codi postal de l'adreça del client.
`client.phone`	string	No	Número de telèfon del client.
`client.email`	string	No	Email del client.
`sales_lead.origin.source`	string	Sí	Origen de la venda. Sempre serà "portal_hero".
`sales_lead.origin.medium`	string	No	Nom del portal d'on prové la venda.
`sales_lead.related_urls`	array	No	Url/s rellevants. Normalment la url de l'article al portal.
`sales_lead.custom.account`	string	No	Email o identificador del compte al portal. Útil quan es gestionen múltiples comptes al mateix portal per poder identificar el compte d'origen de la venda.
`sales_lead.custom.external_id`	string/arraystring*	Sí	Identificador únic de l'article. El mateix que ens envieu en la pujada d'articles.
`sales_lead.custom.title`	string/arraystring*	Sí	Títol del producte venut.
`sales_lead.custom.created_at`	datetime	Sí	Data i hora de la creació de la venda.
`sales_lead.foreign_id`	string	Sí	Identificador únic de la venda.
`sales_lead.inquiry`	array	No	Conversa mantinguda amb l'usuari al portal.
`version`	string	Sí	Versió del schema de jsonLead. Versió 1.0.0 de moment.

Beneficis d'aquesta integració

Automatització Completa: Processa automàticament els leads al teu sistema de gestió.
Estandardització: El format JSONLead assegura compatibilitat amb la majoria de sistemes del mercat.
Flexibilitat: Tria entre webhook, SFTP o email segons el que millor s'adapti a les teves necessitats.

Integra aquesta solució al teu flux de treball i optimitza la gestió dels teus leads amb rapidesa, precisió i facilitat. Si necessites més detalls o suport tècnic, contacta amb nosaltres! 🚀