Leads en formato JSONLead: especificación

Especificación JSONLead de leads: campos y métodos de entrega por email, webhook o SFTP.

Automatizar el flujo de ventas y conectarlo con tu sistema de gestión o ERP nunca ha sido tan fácil. Con nuestro sistema, cada lead que se genera en el portal se envía de manera estructurada para que puedas procesarlo automáticamente sin complicaciones. Aquí te explicamos cómo funciona y cómo puedes implementar esta integración.

Formato de envío: JSONLead como estándar de mercado

Para garantizar compatibilidad y facilidad de integración, utilizamos el formato JSONLead. Este formato es ampliamente reconocido en el mercado y facilita el procesamiento automático de las ventas en sistemas de terceros.

Métodos de envío disponibles

Tienes tres opciones para recibir los leads. En cualquier caso el contenido del lead en formato json será el mismo.

Webhook: La opción más rápida y directa. Los leads se envían inmediatamente a la URL de tu sistema configurada para recibirlas (petición POST). Si por cuestiones de seguridad necesitas cualquier tipo de cabecera personalizada la podemos añadir sin problema.
SFTP/FTP: Puedes utilizar nuestro servidor SFTP o uno propio (SFTP/FTP) para recibir los datos. Se creará un archivo json por cada lead.
Email: Si lo prefieres, podemos enviarte los leads en formato JSONLead como cuerpo en correos electrónicos.

Ejemplo de JSONLead enviado

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

Detalles de los campos del JSONLead

Nombre	Tipo	Obligatorio	Descripción
`client.foreign_id`	string	Si	Identificador único del cliente.
`client.first_name`	string	Si	Nombre del cliente. En funcion del portal puede ser un nombre de usuario.
`client.postal_code`	string	No	Código postal de la dirección del cliente.
`client.phone`	string	No	Número de teléfono del cliente.
`client.email`	string	No	Email del cliente.
`sales_lead.origin.source`	string	Si	Origen de la venta. Siempre será "portal_hero".
`sales_lead.origin.medium`	string	No	Nombre del portal de donde proviene la venta.
`sales_lead.related_urls`	array	No	Url/s relevantes. Normalmente la url del artículo en el portal.
`sales_lead.custom.account`	string	No	Email o identificador de la cuenta en el portal. Util cuando se gestionan multiples cuentas en el mismo portal para poder identificar la cuenta de origen de la venta.
`sales_lead.custom.external_id`	string/arraystring*	Si	Identificador único del artículo. El mismo que nos enviais en la subida de artículos.
`sales_lead.custom.title`	string/arraystring*	Si	Título del producto vendido.
`sales_lead.custom.created_at`	datetime	Si	Fecha y hora de la creación de la venta.
`sales_lead.foreign_id`	string	Si	Identificador único de la venta.
`sales_lead.inquiry`	array	No	Conversación mantenida con el usuario en el portal.
`version`	string	Si	Versión del schema de jsonLead. Versión 1.0.0 por el momento.

Beneficios de esta integración

Automatización Completa: Procesa automáticamente los leads en tu sistema de gestión.
Estandarización: El formato JSONLead asegura compatibilidad con la mayoría de sistemas del mercado.
Flexibilidad: Elige entre webhook, SFTP o email según lo que mejor se adapte a tus necesidades.

Integra esta solución en tu flujo de trabajo y optimiza la gestión de tus leads con rapidez, precisión y facilidad. Si necesitas más detalles o soporte técnico, ¡contáctanos! 🚀