Paso a paso para integrar recepción de leads

Antes de que un integrador pueda comenzar a recibir leads desde Chileautos a través de una integración, es necesario que revise cuidadosamente la documentación técnica y configure su entorno para asegurar una recepción correcta y segura de los datos. Este procedimiento garantiza que los endpoints cumplan con el estándar de seguridad y formato requerido por la plataforma.

A continuación, se detallan los 4 pasos que debe seguir el integrador para implementar, validar y activar correctamente la recepción de leads:

1. Crear un punto de conexión (endpoint)
Debes implementar un servicio en tu servidor que sea capaz de recibir solicitudes HTTPS POST.

Este servicio debe usar un certificado TLS/SSL válido (no se aceptan certificados autofirmados).

El endpoint debe estar siempre disponible y operativo para recibir notificaciones.

2. Procesar solicitudes POST con JSON
Tu endpoint debe aceptar solicitudes POST con una carga en formato JSON, la cual contiene los datos del lead.

Ejemplo de estructura de llamada:

POST /tu-endpoint
Content-Type: application/json

Ejemplo estructura de un lead:

{
  "Identifier": "83ff5b22-5767-4759-bb6b-aab13c28992b",
  "Seller": {
    "Identifier": "448b6a1c-cd6c-44aa-9ff1-f05f150831aa",
    "Type": "Seller",
    "Name": "Automotora Ejemplo",
    "Email": "autos@ejemplo.cl",
    "Addresses": [
      {
        "Line1": "Av. Vitacura 10001",
        "Line2": "",
        "Suburb": "Vitacura",
        "State": "Santiago",
        "Country": "Chile",
        "CountryCode": "CL"
      }
    ],
    "PhoneNumbers": [
      {
        "Type": "Work",
        "Number": "9984429490"
      },
      {
        "Type": "Home",
        "Number": "9984429490"
      }
    ]
  },
  "Source": "chileautos",
  "Type": "Usado",
  "Status": "New",
  "Environment": {
    "Source": "desktop.chileautos",
    "IpAddress": "181.42.18.41"
  },
  "Prospect": {
    "Identifier": "543e8e52-098c-401b-8214-5ad9c1e98505",
    "Type": "Prospect",
    "Name": "Manuel Galdamez",
    "Email": "mgaldamez@email.com",
    "Addresses": [],
    "PhoneNumbers": [
      {
        "Type": "Home",
        "Number": "+56912314874"
      },
      {
        "Type": "Mobile",
        "Number": "+56912314874"
      }
    ],
    "Identification": [
      {
        "Type": "Name",
        "Value": "Manuel"
      },
      {
        "Type": "LastName",
        "Value": "Galdamez"
      }
    ]
  },
  "CreatedUtc": "2024-10-01T00:30:43.0527329Z",
  "Labels": [
    {
      "Type": "Tag",
      "Value": "Used"
    },
    {
      "Type": "Tag",
      "Value": "PhotoTypeDealer"
    },
    {
      "Type": "Tag",
      "Value": "Billable"
    }
  ],
  "Item": {
    "Type": "Car",
    "Identifier": "1191238c-e705-4e61-80d6-05d9b96ccae6",
    "ListingType": "Usado",
    "SaleStatus": "In Stock",
    "Registration": {
      "Number": "LGWX99"
    },
    "Identification": [
      {
        "Type": "NetworkId",
        "Value": "CL-SELLER-9999"
      }
    ],
    "OdometerReadings": [
      {
        "Value": 89000.0
      }
    ],
    "Seller": {
      "Identifier": "7132bc5b-ef1a-46f8-a535-94dbea03caf4"
    },
    "Specification": {
      "Make": "Nissan",
      "Model": "NP300",
      "ReleaseDate": {
        "Year": 2018
      },
      "Title": "2018 Nissan Np300 NP 300 XE 2.3 MT 4X2 DSL DC E5 JYVJ37"
    },
    "Media": {
      "Photos": [
        {
          "Url": "/car/dealer/a177730hltt9rmj7704zsnqnp.jpg"
        },
        {
          "Url": "/car/dealer/dnvbjv3emhme3z09f5s5st44c.jpg"
        }
      ],
      "Videos": [],
      "Links": [
        {
          "Type": "Details",
          "Url": "https://www.chileautos.cl/details/1112318c-e705-4e61-80d6-05d9b55ccae6"
        }
      ]
    },
    "ComplianceDate": {},
    "BuildDate": {},
    "Warranty": {},
    "PriceList": [
      {
        "Currency": "CLP",
        "Amount": 15000000
      }
    ],
    "ExtendedProperties": [
      {
        "Name": "TRIGGERSECTION",
        "Value": "topright"
      },
      {
        "Name": "SellerId",
        "Value": "CL-SELLER-999"
      },
      {
        "Name": "NetworkId",
        "Value": "GI-AD-999999"
      }
    ]
  },
  "ExtendedProperties": []
}

3. Configurar autorización
Puedes proteger tu endpoint utilizando encabezados personalizados (headers) o parámetros fijos en la URL.

Ejemplos métodos utilizados:

access_token: 123
o
Authorization: Basic abc123 <token codificado en Base64>

4. Enviar la información a Soporte
Una vez tengas listo el punto de conexión, debes enviar un correo a soporte@chileautos.cl con la siguiente información:

✅ URL del endpoint (con HTTPS)

✅ Headers requeridos (si aplica)

Recibida esta información, el equipo de soporte realizará un envío de prueba de un lead desde el dealer con el siguiente Seller_identifier:

04b64ea3-5405-40ae-9457-895f05f8f089

Una vez que el desarrollador confirme que el lead fue recibido correctamente, soporte dará el visto bueno final para iniciar la integración en producción.