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úmerodeclarás el mapeo en branches
crear una sucursal nuevala declarás con sus datos en PUT /customers y te devolvemos su id
editar unaPUT /branches/{branchRef}
borrar unaDELETE /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 portalla fuente es tu propia cuenta, así que paginar no te cuesta llamadas
Traen el hilodata.questionId agrupa la conversación: pegá los mensajes en vez de abrir una ficha por cada uno
Ventana de un añopor pedido. Más que eso devuelve 400 window_too_wide
Y te llegan solassi 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