📘

Los endpoints disponibles se encuentran 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 una solicitud de contacto haz un POST al endpoint /contact_requests. El campo source siempre es obligatorio.

• property_id: El ID de EasyBroker de la propiedad relacionada. Si lo incluyes, también debes enviar name, email o phone.
• source: El origen de la solicitud. Por ejemplo, "lainmobiliaria.com".

Si no envías property_id, debes incluir name y message. También debes incluir email o phone.

• name: El nombre del usuario que solicitó información sobre tu propiedad.
• phone: El teléfono de la persona interesada. Puedes enviarlo en el formato que recibiste. Por ejemplo: +5215512345678 o 55-1122-4455.
• email: El correo electrónico del usuario que solicitó información sobre tu propiedad.

Y por último

• message: El mensaje de la persona interesada. Es obligatorio cuando no envías property_id.

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.

Consulta las reglas completas en Create a contact request.

Consultar tus solicitudes de contacto

Puedes obtener la lista de tus solicitudes haciendo un GET al endpoint /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"
    }
  ]
}

Consulta todos los filtros en List all contact requests.