Solicitud de visita

Además de detallar el proceso, esta guía busca proporcionar herramientas y recursos para facilitar la gestión de las solicitudes y optimizar la experiencia tanto de los clientes como de los colaboradores.

Trabajando con Solicitudes de Visita

Para trabajar eficazmente con las solicitudes de visita, además de activar las publicaciones, se requiere configurar horarios, métodos de contacto e integración con calendario, así como recibir notificaciones en tiempo real sobre nuevas solicitudes, cambios de disponibilidad y actualizaciones de contacto. Esto permite responder ágilmente, evitar malentendidos y programar visitas eficientes para maximizar las posibilidades de éxito de tus publicaciones.

Actualizaciones en Tiempo Real

Es fundamental que los vendedores utilicen herramientas de gestión de calendario y reciban notificaciones instantáneas sobre solicitudes de visita, cambios de disponibilidad y actualizaciones de contacto. Esto facilita respuestas rápidas, evita problemas y optimiza la programación de visitas, aumentando las oportunidades de negocio.

Las actualizaciones en tiempo real sobre la intención de visita benefician tanto al vendedor como a la plataforma, permitiendo proporcionar información precisa. Es crucial que el vendedor configure completamente su aplicación con la URL donde recibirá las notificaciones y además haga uso correcto de los recursos de la API.

Pasos para iniciar la integración

Las solicitudes de visita son parte importante de la experiencia de inmuebles. Para poder habilitar esta experiencia es necesario que asegures los siguientes pasos:

1. La cuenta del vendedor profesional o inmobiliaria debe estar registrada

• Registra una cuenta de vendedor profesional en el siguiente link
• Si es para tu usuario de test, sigue la guía de configuración de tu usuario

2. Registrar la aplicación para la obtención del token

• Sigue los pasos para lograr autorizaciones y tokens tal como se detalla en la guía

3. Publicar ítems en la plataforma.

• Si ya has publicado o estás listo para publicar, genera tus primeras publicaciones para luego habilitar la solicitud de visita en ellas.

Una vez realices los pasos anteriores, en esta guía se explica cómo:

• 1. Marcar tus publicaciones para que tengan disponible la solicitud de visita.
• 2. Obtener detalles de este lead para gestionar tu agenda de solicitudes de la mejor manera posible.

Activar Solicitud de Visita en Publicaciones

Si tu usuario está habilitado como inmobiliaria o corredora en uno de los países indicados al inicio de esta guía, tus publicaciones tendrán automáticamente la opción de visita habilitada. Asegúrate de enviar el atributo CONTACT_SCHEDULE junto con los demás atributos obligatorios al momento de publicar tu artículo.

No obstante, si tu publicación no tiene la solicitud de visita marcada, o si necesitas deshabilitarla, puedes hacerlo siguiendo estos pasos:

1. 1. Inicia sesión en MercadoLibre con tu usuario de prueba o vendedor.
2. 2.Haz clic en tu nombre de usuario, despliega el menú y selecciona “Publicaciones”.


3. 3. En el listado de publicaciones, busca la publicación que deseas habilitar y haz clic en los tres puntos del lado derecho. Luego, selecciona “Modificar”.


4. 4. En la ventana de modificación, dirígete a la sección “Solicitud de visita”, y haz clic sobre ella para desplegar las opciones.
5. 5. Para habilitar la funcionalidad de solicitud de visita en línea, selecciona “Ofrecer solicitud online de visita”. Si prefieres el método tradicional, selecciona “Coordinar visitas tradicionalmente”.
6. 6. Para finalizar, haz clic en “Confirmar”.

Notificaciones de Leads de Visita

Se generará una notificación automática a través del canal público de VIS Leads con el filtro “Visit Request” cuando un cliente potencial (comprador) en el marketplace de MercadoLibre muestre interés en visitar una propiedad, o cuando se realice una modificación en la agenda (independientemente del cambio de estado).

Para activar esta notificación, dirígete al gestor de aplicaciones donde creaste tu aplicación (Argentina, Brasil, Chile, México, Colombia, Uruguay, Perú, Ecuador y Venezuela). Deberás loguearte con el usuario que creó la aplicación y ejecutar los siguientes pasos:

1. 1. Desde el menú de tres puntos de la aplicación, selecciona la opción “Editar”.


2. 2. En la sección “Información básica”, haz clic en “Continuar”.


3. 3. Dentro de “Configuración y permisos”, busca “VIS Leads” en la sección “Tópicos” y selecciona “Visit request”.


4. 4. Finalmente, configura la URL para recibir las notificaciones y haz clic en “Editar” para guardar los cambios.

Cuando recibas una notificación de solicitud de visita, será similar a la presentada en el siguiente ejemplo:

{
  "_id": "abcd-qwer-1234",
  "topic": "vis_leads",
  "resource": "/vis/leads/{lead_id}",
  "user_id": 123456789,
  "application_id": 123456789123456789,
  "sent": "2025-01-27T18:21:06.159Z",
  "attempts": 1,
  "received": "2025-01-27T18:21:06.057Z",
  "actions": [
    "visit_request"
  ]
}

Puedes obtener más información de este tipo de notificaciones utilizando los recursos que se describen en la sección de Leads.

Gestión de Agenda

Generar Agenda

Actualmente, no hay un endpoint de API disponible para crear agendas directamente en el modelo de datos. Sin embargo, es posible simular la generación de agendas en publicaciones de prueba ingresando a la URL del ítem publicado y dando clic en Solicitar visita. Posteriormente se podrá generar la agenda.

Posteriormente se podrá generar la agenda. Es importante destacar que es necesario estar autenticado con un usuario de pruebas en el navegador.

Una vez selecciones la disponibilidad y envíes la solicitud, se confirma la acción con un mensaje similar al siguiente:

Ingresa con tu usuario de test que tiene la publicación marcada con solicitud de visita, e ingresa a tu perfil:

En el menú del lado izquierdo ingresa al panel de personas interesadas. En la parte superior del panel, aparecerá una pestaña con las solicitudes de visita pendientes, al dar clic sobre esta pestaña, se listaran dichas solicitudes, posteriormente da clic en el botón Agendar visita para gestionarla.

Obtención detalle de agenda

Para obtener el detalle de una agenda, a través de su identificador (scheduleId), podemos ejecutar el endpoint siguiente, teniendo en cuenta incluir como parámetro el identificador del lead.

Llamada:

curl -X GET -H 'Authorization: Bearer $ACCESS_TOKEN' https://api.mercadolibre.com/vis/leads/$LEAD_ID

Parámetros

La respuesta obtenida será similar a la siguiente:

{
  "id": "44115522",
  "item_id": "MLA4037459422",
  "created_at": "2024-06-14T00:00:00Z",
  "contact_type": "schedule",
  "external_id": "13864821",
  "status": "active",
  "buyer_id": 123654987,
  "name": "Test Test",
  "email": "john@example.com",
  "phone": "+55 01 1111-1111"
}

Lecturas recomendadas

• Gestiona Paquetes de inmuebles
• Publica Inmuebles

Actualizaciones de versión

Esta sección proporciona información sobre las actualizaciones de la API, incluyendo:

Historial de cambios