BETA

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 nuevono te reenviamos el historial. La primera que te llega es la primera que entra después del permiso
No se pierde lo de antesestá en la cuenta de tu cliente, y la podés pedir por cuenta hasta un año atrás
Tu cliente sigue viendo todolas 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.eventQué hacer
lead.createdabrir la ficha: nació la conversación
lead.messageagregar 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

  1. ¿Llegó algo? Pedí las consultas de la cuenta con ?portal=mapapropapi. Es gratis: esta fuente no gasta cupo de ningún portal.
  2. ¿Llegó por el webhook y además está en el GET? Tiene que ser el mismo eventId. Si lo es, la cadena está completa.
  3. ¿El GET trae consultas y el webhook no te llegó ninguna? Entonces el problema está en la entrega, no en el origen: revisá que tu endpoint conteste 2xx y 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