Soy cliente de Mapaprop
Los demás flujos están escritos para un integrador: una app que publica el inventario de otras inmobiliarias. Si vos contrataste Property API para automatizar tu propia cuenta, el único "cliente" sos vos — y hay cinco cosas que funcionan distinto.
1 · tu token Configuración > API Token un clic, no vence
2 · tu ficha POST /customers una vez
3 · tu portal conectás tu cuenta SÍ, otra vez. Ver abajo
4 · publicás POST /properties branchRef = tu branchId
5 · tus consultas GET /leads?portal=mapapropapi tu bandeja, sin gastar cupo
1 · El token no se pide, se activa
No registrás una app ni esperás credenciales: contratás Property API y activás tu Token de API con un clic desde Configuración > API Token. Es el mismo token de todos tus servicios de API y no vence. Cómo se hace: Property API Token.
2 · La ficha: sí, también la declarás
POST /property-v1/customers x-client-ref: mi-inmobiliaria
{ "name": "…", "email": "…", "phone1": "…" }
El x-client-ref lo elegís vos y es el mismo en todas tus llamadas. Te devolvemos nuestro id
(MAPAPROP-PA-000001), que conviene que guardes.
¿Por qué, si Mapaprop ya tiene tus datos? Porque es lo que se publica como contacto del aviso,
y la API no asume: lo declarás una vez y queda explícito. Cambiarlo después es un PUT a la misma
ruta.
3 · 🔴 La cuenta del portal se conecta de nuevo
Aunque ya publiques en ese portal desde Mapaprop. La conexión de Property API es propia y separada de la que usa la web: son dos caminos distintos hacia el mismo portal, y conectar uno no conecta el otro.
Se hace igual que para cualquier cliente, y la forma la define el portal: con un enlace o con la credencial.
4 · Tus sucursales: mandá el branchId, nada más
Esto es lo que más se simplifica para vos. Tus sucursales ya existen en tu cuenta, con su id y su nombre, así que no declarás nada:
POST /property-v1/properties
{ "canonical": { }, "branchRef": 777 }
Ese número es el de tu sucursal, y lo leés con
GET /branches. Sin declararlas, sin bautizarlas.
Y además podés administrarlas, todo opcional:
| Querés… | Hacés |
|---|---|
que tu código hable de "centro" y no de un número | declarás el mapeo en branches |
| crear una sucursal nueva | la declarás con sus datos en PUT /customers y te devolvemos su id |
| editar una | PUT /branches/{branchRef} |
| borrar una | DELETE /branches/{branchRef} |
Podés nombrarla por tu ref o directamente por su branchId: las dos formas funcionan.
El dato de una sucursal de tu cuenta vive en Mapaprop, y sigue siendo así. Lo que cambió es que
ahora tenés una puerta más para escribirlo: el PUT de arriba escribe en Mapaprop, no una
copia al lado. Por eso no hay dos versiones del mismo teléfono — hay un solo dato y dos formas de
editarlo, la webapp y la API.
Lo que la ficha declara sobre una sucursal ya vinculada no se publica: al publicar, el contacto sale de Mapaprop. La ficha es el mapeo, no el dato.
Borrar una sucursal mueve sus propiedades. Sus propiedades, contactos, carteles y usuarios pasan
a otra sucursal, y eso no se deshace. Con 3 o más sucursales elegís a cuál con ?targetBranchRef=;
con 2 van a la principal. El detalle está acá.
5 · Tus consultas: las de tu propia bandeja, con una llamada
🟢 Acá tenés algo que un integrador todavía no: las consultas que entran a tu cuenta de Mapaprop —por tu sitio web, tu chat, el portal de Mapaprop, o un portal que las deja en tu bandeja— las leés con una sola llamada.
curl "https://property-api.mapaprop.com/property-v1/leads?portal=mapapropapi&fromDate=20260101" \
-H "Authorization: Bearer $TOKEN"
| No gasta cupo de ningún portal | la fuente es tu propia cuenta, así que paginar no te cuesta llamadas |
| Traen el hilo | data.questionId agrupa la conversación: pegá los mensajes en vez de abrir una ficha por cada uno |
| Ventana de un año | por pedido. Más que eso devuelve 400 window_too_wide |
| Y te llegan solas | si declaraste un webhook, las mismas consultas te llegan por ahí sin pedirlas |
Funciona porque tu token es de una cuenta de Mapaprop, y es la diferencia con un integrador.
Esta fuente resuelve la cuenta a partir del token, así que te devuelve tus consultas y no las de
otro. Un integrador que pruebe ?portal=mapapropapi recibe
400 no_mapaprop_account: lo que le sirve a él es el webhook.
El detalle está en las consultas de toda la cuenta.
Y de ahí en adelante, todo igual
Publicar, los estados, las consultas y la baja funcionan exactamente como en los demás flujos:
Tus propiedades entran a tu cuenta de Mapaprop. A diferencia de las de un integrador —que viven sólo en Property API— las tuyas se registran también en tu cuenta, así que las ves en la web como cualquier otra. Es lo que hace que el adicional tenga sentido.
Relacionado
- Dar de alta un cliente — el mismo recorrido contado para un integrador, con más detalle de cada paso
POST /customers— todos los campos de la fichaGET /branches— tus sucursales y sus idsPUT /branches/{branchRef}yDELETE— editar y borrar una