Integración Mapaprop ↔ MercadoLibre — Guía para clientes

¿Qué podés hacer con esta integración?

Conectar tu cuenta de MercadoLibre con Mapaprop te permite:

1. Publicar tus avisos inmobiliarios en MercadoLibre directamente desde Mapaprop, sin cargar los datos de nuevo.
2. Recibir las preguntas y consultas de interesados desde MercadoLibre en tu inbox de Mapaprop, junto con los mensajes de tus otros canales (sitio web, red, etc.).
3. Responder las preguntas públicas de ML desde Mapaprop — la respuesta se publica automáticamente en tu aviso de MercadoLibre.
4. Contactar directamente a los interesados que usan los botones de WhatsApp, llamada o visita de MercadoLibre.
5. Ver las visitas que reciben tus avisos en el Reporte de Visitas de Mapaprop, junto con las visitas de tus otros canales (sitio web, portales, red MLS). Las visitas se sincronizan una vez por día. Categoría visual: MercadoLibre (naranja).

1. Conectar tu cuenta de MercadoLibre

Requisitos previos

• Suscripción Mapaprop Plus o superior (Pro / Business). La integración con MercadoLibre es una funcionalidad premium.
• Cuenta de MercadoLibre de tipo "Inmobiliaria". Las cuentas personales comunes no pueden publicar avisos de inmuebles. Si tu cuenta es común, deberás convertirla primero. Ver guía oficial de conversión.

Pasos para conectar

1. Dentro de Mapaprop, andá a Configuración → Cuentas Conectadas → MercadoLibre.
2. Clickeá Conectar.
3. Se abrirá el sitio de MercadoLibre en tu navegador. Iniciá sesión con tu cuenta de inmobiliaria.
4. Autorizá los permisos que Mapaprop necesita (publicar, recibir mensajes, consultar propiedades).
5. Serás redirigido a Mapaprop, donde verás el estado Conectado junto con tus planes de publicación disponibles.

Mantenimiento de la conexión

• El token de conexión con MercadoLibre se renueva automáticamente cada pocas horas sin que tengas que hacer nada.
• Si por algún motivo el token expira y no puede renovarse, verás un aviso "Reconectar cuenta" en la página de MercadoLibre. Un solo click y listo.
• Solo los usuarios con rol admin o manager pueden conectar o desconectar la cuenta.

📖 Guía completa de configuración

2. Publicar una propiedad en MercadoLibre

Requisitos previos para publicar

Una propiedad puede publicarse en ML solamente si:

• Tu cuenta MercadoLibre está conectada y activa (sin token expirado).
• Tenés un plan de publicación disponible (Gratuito, Plata, Oro, Oro Premium, etc.). Los planes se compran en MercadoLibre.
• La propiedad está publicada en Mapaprop (no en borrador).
• La propiedad tiene los datos mínimos requeridos por MercadoLibre para su categoría (precio válido, ubicación, título, descripción, imágenes, atributos obligatorios).

Pasos para publicar

1. Andá a Propiedades → tu propiedad → Publicación.
2. En la sección Publicar en Redes → MercadoLibre, clickeá Publicar.
3. Se abrirá el editor de publicación en ML con un asistente que te guiará:
   • Paso 1 — Título y Plan: elegí el título (máx. 60 caracteres, sin datos de contacto), y el plan que querés usar (los planes con cuota disponible aparecen destacados).
   • Paso 2 — Categoría y Ubicación: Mapaprop mapea automáticamente tu operación (venta/alquiler) y tipo de propiedad a la categoría de ML correspondiente. La ubicación también se mapea desde los datos de Mapaprop. Si la zona de tu propiedad nunca fue publicada en MercadoLibre antes, vas a ver el mensaje "Zona no mapeada" con un botón Mapear Zona — al clickearlo se abre un diálogo donde elegís la Provincia, Ciudad y Barrio de MercadoLibre que corresponden a tu zona. Solo se hace una vez por zona y queda configurada para todas las propiedades de esa misma ubicación.
   • Paso 3 — Atributos: completá los atributos obligatorios y opcionales (dormitorios, ambientes, orientación, amenidades, etc.). Mapaprop pre-completa lo que ya tenés en tu propiedad.
   • Paso 4 — Revisión y Publicar: revisá todo y clickeá Publicar.
4. MercadoLibre puede tardar desde unos segundos hasta varios minutos en activar el aviso. Durante ese tiempo verás el estado "En proceso".

Estados posibles de tu aviso

Subestados de "En proceso"

Cuando el aviso está En proceso, MercadoLibre nos informa por qué todavía no se activó:

⚠️ Si tu aviso queda mucho tiempo en este estado sin pasar a Activo, ML eventualmente lo cierra solo y aparece como Finalizado. Eso suele indicar que el plan está saturado y necesitás más cupo o cambiar de plan.

Acciones disponibles según el estado

Detalle de cada acción:

• Ver aviso: abre el aviso público de ML en una pestaña nueva.
• Editar: modificá descripción, precio, atributos, etc. Algunos campos están bloqueados según el estado (ver matriz más abajo).
• Pausar / Activar: ocultar o reactivar el aviso sin perder el registro ni las visitas acumuladas.
• Finalizar: cerrar el aviso en ML. Podés también Finalizar y borrar para eliminarlo completamente.
• Republicar (botón ↻ verde, solo en Finalizado): crea un aviso nuevo en MercadoLibre vinculado al cerrado, transfiriendo visitas y ventas si fue cerrado hace menos de 60 días. Ver sección 2.5.
• Eliminar de MercadoLibre (botón papelera): borra el aviso de ML pero conserva tus datos en Mapaprop para volver a publicar más adelante.
• Actualizar Estado: pregunta a MercadoLibre por el estado actual del aviso y actualiza la información en Mapaprop. Útil cuando el aviso está "En proceso" para ver si ya se activó.
• Completar pago: solo aparece en estado "Requiere pago". Abre la página de pago en MercadoLibre para contratar el pack del plan elegido.

¿Qué se puede modificar en cada estado?

Los campos marcados como Sync se actualizan automáticamente cuando editás la propiedad en Mapaprop (precio, descripción, fotos, dormitorios, ambientes, etc.). El resto requiere abrir el editor de MercadoLibre y guardar.

2.5 Republicar un aviso finalizado

Cuando un aviso está en estado Finalizado, podés volver a publicarlo sin perder el historial usando el botón Republicar (icono ↻ verde) que aparece en el card de MercadoLibre del panel de publicación.

¿Qué hace exactamente?

Mapaprop usa el endpoint oficial de MercadoLibre /items/{id}/relist que crea un aviso nuevo vinculado al cerrado mediante un identificador parent_item_id. No es una copia ni un duplicado: ML reconoce el vínculo y, bajo ciertas condiciones, transfiere los stats.

Beneficios de republicar (vs publicar uno nuevo desde cero)

• ✅ Transferencia de visitas y ventas si el aviso original fue cerrado hace menos de 60 días. Esto no aplica al plan Gratuito.
• ✅ Vínculo formal entre el aviso nuevo y el anterior (mejor para la reputación de tu cuenta ML).
• ✅ Permite cambiar el plan al republicar (por ejemplo, pasar de Gratuito a Plata si ahora tenés pack contratado, o de Plata a Gratuito si querés ahorrar).
• ✅ Reutiliza todos los datos del aviso original (atributos, ubicación, categoría, descripción, fotos).

Limitaciones

• ❌ Pasaron más de 60 días: el botón Republicar igual funciona, pero ML ya no transfiere visitas ni ventas (arranca con stats en cero).
• ❌ Querés cambiar el título o la categoría: no se puede via Republicar. Tenés que hacer Borrar y luego Publicar desde cero como un aviso nuevo.

Cómo cambiar el plan al republicar

1. Entrá al card de MercadoLibre y clickeá el botón Editar (lápiz).
2. Bajá hasta la sección Título y Plan del editor.
3. En el dropdown Plan de publicación, elegí el plan deseado.
4. Clickeá Guardar (esto persiste el cambio de plan en Mapaprop).
5. Clickeá el botón Republicar (↻ verde) del card.
6. Mapaprop envía a MercadoLibre la petición de relist con el nuevo plan. Tu aviso queda creado con el plan elegido.

💡 Si elegís un plan pago (Plata, Oro) y no tenés un pack contratado en MercadoLibre, el aviso quedará en estado Requiere pago. Completá el pago en ML para activarlo, o cambiá a plan Gratuito.

Reglas importantes de MercadoLibre

• No incluyas datos de contacto (teléfono, email, WhatsApp) en el título o descripción. MercadoLibre puede bloquear el aviso.
• El precio debe estar dentro de los rangos permitidos por cada categoría. Si te excede o queda por debajo, Mapaprop te muestra el mensaje de error con el límite exacto.
• Las fotos deben ser reales de la propiedad, sin marcas de agua ni datos de contacto superpuestos.
• La categoría la elige MercadoLibre en base a los datos de tu propiedad — si la categoría no es la correcta, revisá que el tipo de propiedad y la operación estén bien seteados en Mapaprop.

Si la publicación falla

Mapaprop te mostrará:

• Una sugerencia amigable en la parte superior cuando el error es auto-solucionable (ej: "Según MercadoLibre, el precio es inválido para esta categoría. El máximo permitido es X").
• El mensaje técnico de MercadoLibre debajo, por si necesitás reportarlo al soporte.
• Un botón "Copiar Reporte" para que puedas pegarlo en un ticket de soporte si el problema persiste.

Errores comunes y cómo resolverlos

2.7 Editar una propiedad publicada en MercadoLibre

Cuando entrás a editar una propiedad que ya está publicada en MercadoLibre (desde Editar propiedad, Precios, Imágenes, Videos o Planos), Mapaprop te muestra un banner informativo arriba del formulario que te avisa:

• En qué estado está el aviso en MercadoLibre (Activo / Pausado / Finalizado / Requiere pago / En proceso / etc.) con el color del estado.
• Qué campos NO se van a sincronizar al guardar — chips con ícono 🔒 indicando los campos bloqueados por las reglas de MercadoLibre.

Ejemplo

Si tu aviso está Activo, el banner verde dice:

✓ Publicado en MercadoLibre — Activo Los cambios se van a sincronizar automáticamente con el aviso publicado. MercadoLibre NO permite modificar título, zona, categoría ni plan en avisos activos: esos campos no se reflejarán en ML.

⚠ ATENCION! No se sincronizan: 🔒 Título · 🔒 Zona · 🔒 Categoría · 🔒 Plan

Por qué este banner es importante

Antes de que existiera, los clientes editaban el título de la propiedad esperando que se actualizara en ML — pero ML rechaza ese cambio silenciosamente en avisos activos. El banner te avisa antes de editar qué campos no van a viajar al portal, así sabés qué esperar.

Estados y comportamiento

3. Recibir mensajes de MercadoLibre

Cuando un interesado consulta por uno de tus avisos en MercadoLibre, su mensaje aparece automáticamente en tu inbox de Mapaprop (pestaña principal Inbox).

Tipos de consulta que podés recibir

MercadoLibre ofrece distintas vías de contacto al interesado. En tu inbox cada consulta aparece con un badge que indica el tipo:

Cómo identificar los mensajes de MercadoLibre

En la lista del inbox, los mensajes de ML tienen un tag amarillo "MercadoLibre", junto con el badge del tipo de consulta. Así los distinguís rápido de los mensajes de tu sitio web, red de portales, etc.

Datos del interesado

Cada mensaje incluye los datos que MercadoLibre comparte con vos:

• Nombre
• Email
• Teléfono
• Documento (si el interesado lo proporcionó)

Estos datos se guardan automáticamente como un contacto en Mapaprop. Podés usarlos para hacer seguimiento o agregarlos a campañas.

4. Responder una pregunta pública de MercadoLibre

Las preguntas de MercadoLibre son públicas en tu aviso y tienen reglas especiales que conviene conocer antes de responder.

Reglas de MercadoLibre para las respuestas

1. Solo podés enviar UNA respuesta por pregunta. No se puede editar ni agregar una segunda respuesta.
2. La respuesta es pública y queda visible en el aviso para todos los compradores.
3. No incluyas datos de contacto (teléfono, email, WhatsApp) en la respuesta. MercadoLibre puede bloquearla.
4. Respondé rápido. MercadoLibre mide tu tiempo promedio de respuesta y lo usa como parte de tu reputación como vendedor. Respuestas tardías o preguntas sin responder te bajan el ranking.
5. Máximo 2000 caracteres por respuesta.

Cómo responder desde Mapaprop

1. Entrá al inbox y clickeá la pregunta que querés responder.
2. Vas a ver el texto de la pregunta junto con:
   • Un panel informativo con las reglas de MercadoLibre (recordatorio de lo que no se puede hacer).
   • Un cuadro de texto para escribir tu respuesta con contador de caracteres 2000.
3. Escribí tu respuesta y clickeá el botón amarillo de enviar.
4. Mapaprop te pedirá confirmación (es la única respuesta pública — queremos asegurarnos).
5. Al confirmar, la respuesta se publica inmediatamente en MercadoLibre y se muestra en la conversación con el badge "Publicada en ML".

Si ya respondiste desde el panel de MercadoLibre

Si preferís responder desde la app o panel web de MercadoLibre directamente:

• Mapaprop lo detecta automáticamente y sincroniza la respuesta en tu inbox (tarda entre segundos y 1-2 minutos).
• La conversación muestra la respuesta con el badge "Respondida en ML" (se distingue del caso anterior).
• No hay conflicto ni duplicación — siempre hay una única respuesta pública en ML.

¿Y si intento responder desde Mapaprop algo ya respondido en ML?

Mapaprop detecta el caso y sincroniza automáticamente la respuesta existente. Te muestra un aviso: "Ya respondida desde MercadoLibre. La respuesta existente fue sincronizada." No se publica nada nuevo, no se duplica.

Después de la respuesta

Una vez que la pregunta está respondida (desde donde sea):

• El botón de respuesta pública desaparece.
• Aparece un nuevo cuadro de texto (color verde) que te permite seguir la conversación con el interesado por email privado desde Mapaprop.
• Los mensajes posteriores NO se publican en MercadoLibre — son comunicación privada vendedor ↔ interesado vía email.

5. Contactar directamente por WhatsApp, llamada o email

Para las consultas que no son preguntas (WhatsApp, llamada, visita, cotización), Mapaprop muestra botones de acción directa dentro del mensaje del interesado:

• Abrir WhatsApp → abre WhatsApp Web/App con un mensaje pre-armado listo para enviar.
• Llamar → usa el marcador de tu teléfono o computadora para llamar directamente.
• Enviar email → abre tu cliente de email con el asunto prellenado (ej: "Coordinación de visita", "Cotización solicitada").

Estos contactos no requieren respuesta pública en ML — el interesado explícitamente pidió ser contactado por ese medio.

6. Reputación en MercadoLibre — por qué importa responder rápido

MercadoLibre evalúa tu perfil de vendedor en base a:

• Tiempo promedio de respuesta a preguntas.
• Porcentaje de preguntas respondidas (si dejás preguntas sin responder, cuenta como negativo).
• Calidad de las respuestas (respuestas detalladas > respuestas genéricas).

Una buena reputación te posiciona mejor en los resultados de búsqueda y genera más consultas.

Mapaprop te ayuda a mantener una buena reputación:

• Los mensajes llegan al inbox en tiempo casi real (segundos a pocos minutos).
• Podés responder desde tu celular, tablet o computadora sin abrir MercadoLibre.
• Si respondés por el panel de ML directo, Mapaprop igual lo sincroniza — no hay fricción.

7. Preguntas frecuentes

¿Puedo tener más de una cuenta de MercadoLibre conectada? No. Por cada cliente Mapaprop solo podés conectar UNA cuenta de MercadoLibre. Si cambiás de cuenta, primero desconectá la actual y después conectá la nueva.

¿Qué pasa si un vendor / usuario de mi equipo quiere publicar pero no es admin? Puede publicar propiedades en ML normalmente, pero la conexión/desconexión de la cuenta de MercadoLibre solo la puede hacer el admin ¿Qué pasa si cambio el precio o los datos de la propiedad en Mapaprop? Mapaprop sincroniza automáticamente los cambios con MercadoLibre cuando editás la propiedad desde Editar propiedad, Precios, Imágenes, Mapa o Planos. No tenés que hacer nada manual. Los campos que se sincronizan automáticamente son: precio, descripción, fotos (hasta 30), coordenadas, video, y atributos numéricos/booleanos mapeados (dormitorios, ambientes, área, amenidades). Cuando guardás, vas a ver un toast con el resultado real:

• 🟢 "MercadoLibre — Aviso sincronizado" (verde) si el aviso está activo y ML aceptó los cambios.
• 🟡 "MercadoLibre — Cambios pendientes" (amarillo) si los cambios se guardaron en Mapaprop pero no se enviaron al portal (por ejemplo: aviso pausado, finalizado, esperando pago, en proceso, en revisión). El detalle del toast te dice por qué.
• 🔴 "MercadoLibre — Error al sincronizar" (rojo) si ML rechazó la actualización por algún motivo técnico.

¿Qué cambios NO se sincronizan automáticamente con MercadoLibre? MercadoLibre impone restricciones para avisos activos o pausados: NO permite modificar título, zona/ubicación, categoría ni plan. Si cambiás el título de la propiedad desde Mapaprop mientras el aviso ML está activo, Mapaprop te muestra un toast informativo: el banner preventivo arriba del formulario (que aparece apenas entrás a editar) — con un cartel ATENCION! No se sincronizan: Título · Zona · Categoría · Plan. La descripción, precio, fotos y atributos sí se actualizan correctamente. Para cambiar título o categoría tenés que finalizar el aviso, borrarlo de MercadoLibre y publicarlo de nuevo desde cero.

¿Puedo programar publicaciones automáticas? No todavía. Actualmente cada publicación se activa manualmente desde el botón Publicar. Programaciones automáticas están en el roadmap.

¿Qué pasa si un comprador hace la misma pregunta dos veces? MercadoLibre las muestra como preguntas separadas (cada una con su propio ID). Vas a ver ambas en tu inbox. Respondelas individualmente.

¿Los datos de contacto del interesado son reales? Sí. MercadoLibre comparte los datos reales del comprador con vos (nombre, email, teléfono). Son datos verificados por ML.

¿Mapaprop publica mis datos o los de mi inmobiliaria en MercadoLibre? En el aviso público sólo aparece el nombre de tu inmobiliaria y los datos de la propiedad. Los datos tuyos/del agente quedan internos en MercadoLibre para que los compradores te contacten por los canales habilitados (pregunta, WhatsApp, llamada, etc.).

¿Qué pasa si MercadoLibre bloquea mi aviso? Lo más común es que el título, descripción o fotos hayan incluido datos de contacto o algo que viola las políticas. Revisá el mensaje de error en Mapaprop, corregí el aviso y volvé a publicar. Si el bloqueo persiste sin razón aparente, contactá al soporte de MercadoLibre.

¿Por qué muchos de mis avisos quedan en estado "En proceso" y no se activan? Lo más común es que el plan que elegiste no tiene cupo disponible (pack_quota_pending). Cada plan de MercadoLibre (Gratuito, Plata, Oro) tiene un cupo limitado de publicaciones simultáneas. Si publicaste más avisos que los que el plan permite, los que sobran quedan esperando. Soluciones: comprar más pack en MercadoLibre, cambiar a un plan superior, o finalizar avisos viejos para liberar cupo. Ver la FAQ específica de avisos "En proceso".

¿Qué hago si el aviso dice "Requiere pago"? Significa que elegiste un plan pago (Plata u Oro) pero no tenés un pack contratado en tu cuenta de MercadoLibre. Tenés dos opciones: clickear Completar pago desde Mapaprop para contratar el pack en ML, o cancelar el aviso y republicar con plan Gratuito. Ver la FAQ específica de "Requiere pago".

¿Puedo cambiar el plan de un aviso ya finalizado? Sí. Cuando el aviso está en estado Finalizado, podés cambiar el plan en el editor de MercadoLibre, guardar, y luego clickear el botón Republicar (↻ verde). El aviso nuevo se publicará con el plan elegido. Esto no es posible mientras el aviso está activo. Ver la FAQ específica de cambio de plan en finalizado.

¿Cuánto tarda en activarse un aviso después de publicar? Depende del plan y del estado de la cuenta. Con cupo disponible y fotos sanas, los avisos se activan en segundos a pocos minutos. Si el plan no tiene cupo o las fotos tardan en descargarse, puede tomar horas o quedar bloqueado hasta que el problema se resuelva. Usá el botón Actualizar Estado para consultar el estado actual.

¿Qué significa "Imágenes en descarga"? MercadoLibre intenta bajar las fotos desde el servidor de Mapaprop para incluirlas en el aviso. Si por algún motivo no las puede bajar (lentitud de red, IP bloqueada, etc.), el aviso queda en este subestado y no se activa. Habitualmente se resuelve solo en pocos minutos. Si persiste más de 1 hora, reportá a soporte.

¿Qué pasa con las visitas y ventas si republico un aviso finalizado? Si republicás dentro de los 60 días desde que se cerró, MercadoLibre transfiere las visitas y ventas al aviso nuevo (excepto en plan Gratuito). Pasados los 60 días, igual podés republicar pero los stats arrancan desde cero.

¿Puedo importar mis avisos actuales de ML a Mapaprop? Esta funcionalidad está en planificación y vendrá pronto. Por ahora, los avisos existentes en ML quedan administrados desde el panel de MercadoLibre hasta que los publiques desde Mapaprop.

Soporte

Si tenés problemas con la integración:

1. Leé la guía de configuración detallada: Notion - Configuración de MercadoLibre.
2. Convertir tu cuenta a inmobiliaria: Notion - Convertir cuenta.
3. Reportar un problema técnico: abrí un ticket desde la sección de Configuración → Reportar un problema.
4. Problemas con tu cuenta en MercadoLibre (facturación, cuotas, bloqueos): contactá directamente al soporte oficial de MercadoLibre.

Otras ayudas de Mercadolibre

Publicar en Mercadolibre

Convertir su cuenta MercadoLibre en Inmobiliaria

Configuracion de Mercadolibre

Reconectar cuenta de Mercadolibre