📘
Los endpoints disponibles los encuentras en el apartado Contact Requests de nuestra Referencia API.

Crear solicitudes de contacto

Esto te ayudará para llevar el registro de los clientes potenciales que solicitan información a través de tu sitio web o aplicación.

Para crear solicitudes de contacto tienes que hacer un POST al endpoint /contact_requests y deberás enviar la información del usuario bajo los siguientes campos.

property_id: El valor que envíes en este campo debe ser el ID de EasyBroker y es obligatorio.
source: En este campo debes indicar de donde proviene el contacto. Por ejemplo, si la solicitud viene desde tu sitio web el valor debería ser "lainmobilaria.com", también es un campo obligatorio.

Los siguientes 3 son opcionales pero al menos debes de incluir 1 de ellos.

name: El nombre del usuario que solicitó información sobre tu propiedad.
phone: El número teléfonico del usuario que solicitó información sobre tu propiedad, ya que puede variar puedes enviarlo en el formato que deseés. Ejemplo: +5215512345678, 55-1122-4455 o +521-5511-1232
email: El correo electrónico del usuario que solicitó información sobre tu propiedad.

Y por último

message: Este es completamente opcional, sin embargo recomendamos que si el usuario no escribe un mensaje personalizado incluyas un texto predeterminado desde el inicio.

Tu request deberá verse así:

{
  "name": "Jorge Alberto",
  "phone": "5559090909",
  "email": "[email protected]",
  "property_id": "EB-B0579",
  "message": "Estoy interesado en esta propiedad, aún está disponible?",
  "source": "inmobiliaria-nerv.com"
}

Esto también se agrega al historial el mensaje del cliente potencial, relacionado a la propiedad del ID de la propiedad enviado. Si el correo que enviaste corresponde al de un contacto ya existente, no se genera un contacto nuevo si no que se actualiza con la información que enviaste y se agrega al historial un mensaje nuevo.

Ahora, puedes confirmar que este request, guardó un contacto nuevo en tu cuenta de EasyBroker, puedes ver que los datos corresponden a los que se enviaron a través de la API.

Puedes probar este endpoint en nuestra referencia dando clic aquí.

Consultar tus solicitudes de contacto

Puedes obtener la lista de todas tus solicitudes haciendo un GET al endpoint /get_contact-requests.

Para realizar tu búsqueda puedes usar los filtros disponibles:

page: Te ayudará con la paginación de los resultados.
limit: Por defecto la cantidad de resultados que entregamos es de 20 y el límite es de 50 por página.
happened_after: Devolverá las solicitudes creadas después de la fecha que indiques.
happened_before: Devolverá las solicitudes creadas antes de la fecha que indiques.
property_id: Filtro que te ayudará a devolver solo las consultas de una propiedad en especial.

Si no incluyes alguno de estos filtros en tu request devolveremos todas las solicitudes dentro de la cuenta.

Y el resultado que verás es el siguiente:

{
  "pagination": {
    "limit": 20,
    "page": 1,
    "total": 1,
    "next_page": null
  },
  "content": [
    {
      "name": "Jorge Alberto",
      "phone": "5559090909",
      "email": "[email protected]",
      "property_id": "EB-B0579",
      "message": "Estoy interesado en esta propiedad, aún está disponible?",
      "source": "inmobiliaria-nerv.com",
      "happened_at": "2022-11-05T23:26:53.402Z"
    }
  ]
}

Puedes probar este endpoint en nuestra referencia dando clic aquí.