Documentación: API feedback integraciones Chilepropiedades.cl

Esta API permite conectar tu sistema externo para consultar la información de publicaciones e integraciones disponible para tu cuenta. Todas las cuentas activas pueden crear tokens. Los endpoints de estado de agentes y feedback requieren ser propietario de una integración.

Todas las APIs mencionadas a continuación necesitan un token de tu cuenta. Puedes crear, consultar, cambiar el nombre y revocar tus tokens desde Mi Cuenta → Tokens API. Envía el token directamente en el encabezado Authorization: <token>, sin el prefijo Bearer. Cada token permite acceder a la información disponible para su cuenta. Mantén los tokens en privado y revoca los que dejes de usar.

Obtener mensajes de contacto (leads)

Devuelve los correos de contacto que han llegado a las publicaciones bajo su integración.

URL: /api-integraciones/mensajes
Método: GET
Headers: Authorization: <TOKEN>

Parámetros:
  • fromID (Integer, opcional): Solo mensajes con "id" mayor a fromID serán entregados.
  • publicationId (String, opcional): código externo de la publicación. Si este parámetro está definido, solo se devuelven mensajes asociados a esta publicación.
  • fromDate (String, opcional): formato 2023-08-10T18:27:04.023Z.
  • toDate (String, opcional): formato 2023-08-10T18:27:04.023Z.

Ejemplo de respuesta:


  [
    {
      "id": 74924890,
      "body": "Hola NN Propiedades, estoy interesado en el aviso: La Reina, Santiago (Código 123). Por favor contáctate conmigo, gracias.",
      "emailFrom": "email-lead@gmail.com",
      "nameFrom": "Nombre con apellido",
      "phoneFrom": "+56 9 XXXX YYYY",
      "publicationId": 70384959,
      "creationDate": 1740297973396,
      "sentDate": 1740298505947,
      "type": 1,
      "archived": false,
      "ip": "190.161.237.123",
      "flagged": false,
      "realStateProject": false,
      "publication": true,
      "externalID": "65241"
    },
    ...
  ]

Estadisticas / visualizaciones

Devuelve las estadísticas de las publicaciones bajo su integración. Ojo que esto devuelve el acumulado desde que el aviso entró a Chilepropiedades.cl, no es solo del presente día.

URL: /api-integraciones/estadisticas
Método: GET
Headers: Authorization: <TOKEN>

Parámetros:
  • publicationId (String, opcional): código externo de la publicación. Si este parámetro está definido, solo se devuelven estadísticas asociados a esta publicación.

Ejemplo de respuesta:


  [
    {
      "id": 123,
      "pageViews": 24,
      "contactRevealed": 4,
      "contactEmails": 3,
      "whatsAppButtonClicked": 1,
      "externalID": "65419"
    },
    {
      "id": 124,
      "pageViews": 21,
      "contactRevealed": 1,
      "contactEmails": 0,
      "whatsAppButtonClicked": 0,
      "externalID": "65595"
    },
    ...
  ]

Estado de publicaciones

Devuelve el estado (Publicada, Borrada, Vencida, etc) de las publicaciones bajo su integración

URL: /api-integraciones/estado-publicacion
Método: GET
Headers: Authorization: <TOKEN>

Parámetros:
  • publicationId (String, opcional): código externo de la publicación. Si este parámetro está definido, solo se devuelve el estado asociados a esta publicación.

Ejemplo de respuesta:


  [
    {
      "publicationState": "Publicada",
      "externalID": "65419",
      "shortURLUsingExternalId": "http://local.chilepropiedades.cl/ver-publicacion/68096790/65419",
      "shortURL": "http://local.chilepropiedades.cl/ver-publicacion/68166245",
      "longURL": "http://local.chilepropiedades.cl/ver-publicacion/venta/valdivia/departamento/valdivia/68166245"
    },
    ...
  ]

Estado de agentes

Devuelve el listado de cuentas (agentes) bajo su integración

URL: /api-integraciones/estado-agentes
Método: GET
Headers: Authorization: <TOKEN>

Parámetros: No hay

Ejemplo de respuesta:


  [
    {
      "email": "yyy@gmail.com",
      "lastRun": "2025-03-19T01:20:12.697-07:00"
    },
    {
      "email": "xxx@gmail.com",
      "lastRun": "2025-03-19T01:12:13.443-07:00"
    },
    ...
  ]

Enviar consultas a integraciones@chilepropiedades.cl