Resumen
Esta guía te ayudará a configurar la integración con MercadoLibre para publicar tus propiedades directamente desde Brokar.
Paso 1: Crear una Aplicación en MercadoLibre
1.1 Acceder al Centro de Desarrolladores
- Ve a: developers.mercadolibre.com.mx/devcenter
- Inicia sesión con tu cuenta de MercadoLibre (la misma que usas para vender).
1.2 Crear Nueva Aplicación
- Haz clic en "Crear aplicación" o "Create application".
- Completa el formulario con los siguientes datos:
| Campo | Valor a Ingresar |
|---|---|
| Nombre de la aplicación | Mi Inmobiliaria - CRM (o el nombre de tu agencia) |
| Descripción corta | Integración para publicar propiedades inmobiliarias |
| URL de redirección (Redirect URI) | https://dev.brokar.com.mx/mercadolibre/callback |
IMPORTANTE: La URL de redirección debe ser EXACTAMENTE igual a la que está configurada en Brokar. Si usas un dominio diferente, ajústala.
1.3 Obtener Credenciales
Una vez creada la aplicación, verás:
- App ID (también llamado Client ID): Un número largo como
8264105382966844 - Client Secret: Una cadena alfanumérica como
AbCdEf123456...
Nota: Guarda estos valores de forma segura, los necesitarás en el siguiente paso.
Paso 2: Configurar en Brokar
2.1 Acceder a la Configuración
- Inicia sesión en Brokar
- Ve a Integraciones → MercadoLibre
- Haz clic en "Configurar"
2.2 Ingresar Credenciales
Completa el formulario con los datos de tu aplicación:
| Campo en Brokar | Valor a Ingresar |
|---|---|
| Client ID (App ID) | El número de tu aplicación (ej: 8264105382966844) |
| Client Secret | El secret de tu aplicación |
| País/Sitio | Selecciona México (MLM) |
2.3 Autorizar Conexión
- Haz clic en "Guardar y Conectar".
- Serás redirigido a MercadoLibre.
- Inicia sesión si es necesario.
- Haz clic en "Autorizar" o "Permitir".
- Serás redirigido de vuelta a Brokar con un mensaje de éxito.
Paso 3: Verificar la Conexión
3.1 Comprobar Estado
- Ve a Integraciones → MercadoLibre
- Deberías ver:
- ✅ Estado: Conectado
- Tu nombre de usuario de MercadoLibre
- Fecha de última sincronización
3.2 Probar Publicación
- Ve a una de tus propiedades.
- Haz clic en "Publicar en MercadoLibre".
- Completa los campos adicionales requeridos por ML.
- Confirma la publicación.
Solución de Problemas Comunes
Error: "Invalid redirect_uri"
Causa: La URL de redirección en tu app de ML no coincide con la de Brokar.
Solución:
- Ve a tu app en developers.mercadolibre.com.mx
- Edita la aplicación
- Asegúrate que el Redirect URI sea EXACTAMENTE:
https://dev.brokar.com.mx/mercadolibre/callback
Error: "Token expirado"
Causa: El token de acceso expiró (duran unas horas).
Solución:
- Ve a Integraciones → MercadoLibre
- Haz clic en "Reconectar"
- Autoriza nuevamente
Error: "Access denied"
Causa: No autorizaste todos los permisos o cancelaste el proceso.
Solución: Intenta conectar nuevamente y asegúrate de hacer clic en "Autorizar".
La propiedad no aparece en MercadoLibre
Causas posibles:
- La publicación está en revisión (puede tomar hasta 24h).
- Faltan campos requeridos (fotos, descripción, precio).
- La categoría no es correcta.
Códigos de País (Site IDs)
| País | Código |
|---|---|
| México | MLM |
| Argentina | MLA |
| Brasil | MLB |
| Chile | MLC |
| Colombia | MCO |
| Uruguay | MLU |
Permisos Requeridos
Tu aplicación de MercadoLibre necesita estos permisos:
- read - Para leer información de tu cuenta
- write - Para publicar y editar propiedades
- offline_access - Para renovar tokens automáticamente
Estos permisos se solicitan automáticamente cuando autorizas la conexión.
¡Listo! Una vez configurado, podrás publicar propiedades en MercadoLibre con un solo clic.