Preparate para el primer lead
Cuando tu cliente suma el permiso de consultas a su cuenta de Mapaprop, las consultas que entran a su bandeja empiezan a llegarte. No hay que activar nada más, no hay una migración que correr y no hay un botón que apretar: de un momento al otro empiezan a aparecer.
Esta página es lo que conviene tener listo antes de ese momento.
Esto es la fuente mapapropapi, la que no es un portal: son las consultas que entran por el
sitio web de tu cliente, su chat, el portal de Mapaprop, o un portal que las deja en su bandeja.
Los leads de portal siguen funcionando exactamente igual que antes.
Qué pasa exactamente cuando se enciende
hoy no te llega nada de esta fuente
↓ se agrega el permiso a la cuenta de tu cliente
desde ahí cada consulta nueva te llega por tu webhook, en segundos
Tres cosas que conviene saber de ese corte:
| Empieza por lo nuevo | no te reenviamos el historial. La primera que te llega es la primera que entra después del permiso |
| No se pierde lo de antes | está en la cuenta de tu cliente, y la podés pedir por cuenta hasta un año atrás |
| Tu cliente sigue viendo todo | las consultas no se mudan: siguen en su bandeja de Mapaprop, y él las sigue respondiendo desde ahí |
Las cinco cosas que tienen que estar listas antes
1 · El webhook registrado, y el secreto guardado
Se declara una sola vez con PUT …/webhooks/lead. De ahí sale el
secreto con el que firmamos cada entrega.
El secreto se devuelve UNA sola vez. Guardalo en ese momento: no lo podemos volver a mostrar, y sin él no podés verificar que las entregas son nuestras.
2 · Un endpoint que conteste rápido y guarde
Guardá el sobre crudo y contestá 2xx; procesá después. Un endpoint que valida, enriquece y
escribe en tres sistemas antes de contestar es un endpoint que se cae más seguido que el que sólo
guarda — y tenés tres intentos con unos 2 minutos entre uno y otro.
🟢 Y acá hay una red que los leads de portal no tienen: si tu endpoint estuvo caído, las consultas de esta fuente siguen existiendo y las podés volver a pedir por cuenta. No dependés sólo de la entrega.
3 · Dedupe por eventId
Es la clave, y sale del hecho, no del intento: si te reenviamos la misma consulta, llega con el
mismo eventId. Guardalo y listo.
4 · Aceptar una consulta sin propiedad
🔴 El 16,9 % de las consultas no es sobre ningún aviso. Alguien escribe para preguntar por una
zona, por un presupuesto, por disponibilidad en general. Llegan con data.property en null.
Si tu sistema sólo sabe guardar una consulta colgada de una propiedad, esas se te pierden sin que nada falle. Es lo más caro de descubrir tarde. Necesitás una bandeja para las que no son de ningún aviso.
5 · Pegar los mensajes del mismo hilo
Una consulta puede tener varios mensajes. Dos leads con el mismo data.questionId son la misma
conversación, y lead.event te dice qué es cada uno:
lead.event | Qué hacer |
|---|---|
lead.created | abrir la ficha: nació la conversación |
lead.message | agregar al hilo que ya existe, no abrir otra |
Sin esto, tu usuario ve tres contactos donde hay una sola persona escribiendo tres veces.
El día 1: qué mirar
- ¿Llegó algo? Pedí las consultas de la cuenta con
?portal=mapapropapi. Es gratis: esta fuente no gasta cupo de ningún portal. - ¿Llegó por el webhook y además está en el
GET? Tiene que ser el mismoeventId. Si lo es, la cadena está completa. - ¿El
GETtrae consultas y el webhook no te llegó ninguna? Entonces el problema está en la entrega, no en el origen: revisá que tu endpoint conteste2xxy que la URL registrada sea la que creés.
Antes de escribirnos, ese orden ahorra la mitad de los casos: el GET te dice si la consulta
existe de nuestro lado. Separa "no entró" de "no te la pudimos entregar", que son dos problemas
distintos con dos soluciones distintas.
Si algo no sale
Cuando algo no sale tiene el recorrido completo. Lo que vale repetir acá:
El soporte sube por la cadena: tu cliente te escribe a vos, y vos nos escribís a nosotros.
Mandanos el reference del error y el clientRef: con eso encontramos tu llamada exacta.
Lo que NO cambia
- Tu cliente sigue trabajando igual. Las consultas siguen llegando a su bandeja de Mapaprop y las responde desde ahí. Esto no le cambia la pantalla ni le mueve nada de lugar.
- Los leads de portal siguen como estaban. Esta fuente se suma; no reemplaza nada.
- Lo que tu cliente contrata con cada portal —su cuenta, su plan— es suyo y directo, como siempre.
Relacionado
- El objeto lead — la forma, campo por campo
- Las consultas de toda la cuenta — incluida la fuente
mapapropapi - Webhooks — declarar a dónde te entregamos
- Recibir consultas — el flujo completo
- Cambios de la API — la forma del lead cambió el 20 de noviembre de 2026