Búsqueda

Paso a paso para integrar recepción de leads

  • Actualización

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
Para aumentar la seguridad de tu punto de conexión, puedes incluir un header de autenticación en las solicitudes que recibas. Este header permite validar que las notificaciones provienen de una fuente confiable.
Ejemplo de configuración:

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

Nota: En la documentación se muestran ejemplos con más de un header, pero nuestra herramienta solo permite configurar uno. Si decides usar esta opción, define el header que consideres más importante para tu integración (por ejemplo, Authorization).

Este paso no es obligatorio, pero es recomendado para proteger tu endpoint.

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.

5. Consideraciones en la Estructura de Recepción de Leads (WhatsApp / Callconnect)
Contexto:
A diferencia de los formularios web, los leads de WhatsApp y Callconnect tienen una estructura de datos diferente. El sistema debe ser capaz de procesarlos sin rechazar la petición por falta de campos tradicionales.

Reglas de Negocio para el Endpoint:

Dato mínimo obligatorio:

Number (Teléfono del interesado): Es el único dato constante y obligatorio. Debe ser la clave primaria para identificar o crear al prospecto de estos lead.

Ajuste de Mapping: Leads de WhatsApp y Callconnect

Objetivo: Evitar errores de validación (400 Bad Request) cuando el lead no cuenta con nombre o correo electrónico real.

Lógica de Reemplazo (Placeholders):

  • Para el objetos tipo "Prospect", si los datos no vienen del origen, se deben mapear de la siguiente forma:

Campo Name: 

* Si es WhatsApp > "WhatsApp Connect Prospect" 

* Si es Callconnect > "CARSALESCONNECT PROSPECT"

(Evita que el sistema rechace por no identificar el nombre).

Campo Email: 

 Valor fijo > "noemail@mail.com"

(Esto satisface la validación de formato de correo).

  • Para el objeto tipo "Identification", si los datos no vienen del origen, se deben mapear de la siguiente forma:

Campo "Type": "Name"

* Si es WhatsApp el valor > "Value": "WhatsApp"

* Si es Callconnect el valor > "Value": "CARSALESCONNECT"

Campo "Type":  "LastName"

* Si es WhatsApp el valor > "Value": "Connect Prospect"

* Si es Callconnect el valor > "Value": "PROSPECT"

Campo Number: 

*  Dato Mandatorio. Es el único campo real y constante que debe procesarse siempre.

Vinculación del Aviso (guid - Inventory Identifier):

Un lead puede no venir con el vehículo vinculado cuando el interesado no envía el vínculo desde WhatsApp o cuando no agrega el código de publicación al realizar la llamada desde CallConnect.

Con el Inventory Identifier: El lead se vincula al vehículo específico.

Sin ID: El lead debe procesarse como una "Consulta General" al Dealer (SellerIdentifier), sin estar amarrado a un aviso de auto en particular.

Extracto de objetos desde los diferentes tipos de lead

WhatsApp 

  "Prospect": { 
    "Identifier": "82d8ec2f-415d-45c7-92ad-7ed6f3ed9dc9", 
    "Type": "Prospect", 
    "Name": "WhatsApp Connect Prospect", 
    "Email": "noemail@mail.com", 
    "Addresses": [], 
    "PhoneNumbers": [ 
      { 
        "Type": "Mobile", 
        "Number": "+56967092168" 
      } 
    ], 
    "Identification": [ 
      { 
        "Type": "Name", 
        "Value": "WhatsApp" 
      }, 
      { 
        "Type": "LastName", 
        "Value": "Connect Prospect" 
      }

Callconnect  

"Prospect": {
    "Identifier": "19b053ff-70db-4761-b2f5-9f27e4813fb7",
    "Type": "Prospect",
    "Name": "CARSALESCONNECT PROSPECT",
    "Email": "noemail@mail.com",
    "Addresses": [],
    "PhoneNumbers": [
      {
        "Type": "Home",
        "Number": "+56984635504"
      }
    ],
    "Identification": [
      {
        "Type": "Name",
        "Value": "CARSALESCONNECT"
      },
      {
        "Type": "LastName",
        "Value": "PROSPECT"
      }

Formulario

"Prospect": {
    "Identifier": "2df4c38b-d57d-47ab-9989-b410cdd593c8",
    "Type": "Prospect",
    "Name": "Alvaro Arancibia",
    "Email": "aarancibia@chileautos.cl",
    "Addresses": [],
    "PhoneNumbers": [
      {
        "Type": "Home",
        "Number": "+56967092168"
      },
      {
        "Type": "Mobile",
        "Number": "+56967092168"
      }
    ],
    "Identification": [
      {
        "Type": "Name",
        "Value": "Alvaro"
      },
      {
        "Type": "LastName",
        "Value": "Arancibia"
      }

 

Relacionada con



La información contenida en esta página se proporciona únicamente como referencia. No constituye asesoría profesional ni experta y no sustituye dicho tipo de asesoría. El contenido puede no ser apropiado, exacto o suficiente para sus circunstancias particulares y no debe considerarse como el único fundamento para adoptar o abstenerse de adoptar decisiones.

¿Fue útil este artículo?

Usuarios a los que les pareció útil: 1 de 1

¿Tiene más preguntas? Enviar una solicitud