Este webservice envía una consulta al cliente. Se validan los datos básicos, se realiza la verificación de spam y se registra el lead.
| Información del recurso | |
|---|---|
| Autenticación | Requerida |
| Método HTTP | POST |
| Respuesta | JSON |
| Versión | 1 |
URL del recurso
https://mapaprop.app/api/action/feed-v1/submit-question
Parámetros
| Clave | Tipo | Requerido | Descripción |
|---|---|---|---|
| agencyId | string | sí | El ID de la inmobiliaria exactamente como lo proporciona el campo agency.id de GET /api/action/feed-v1/get-properties o GET /api/action/feed-v1/get-delta. Tratarlo como una cadena opaca; no intentar parsearlo (ver Get Started). |
| propertyId | string | sí | El ID de la propiedad generado por el sistema, proporcionado por GET /api/action/feed-v1/get-properties o GET /api/action/feed-v1/get-delta. No es el propertyCode sino el campo llamado 'id'. |
| portalName | string | sí | El nombre del portal que envía la consulta. Ej. Trovit |
| userAgent | string | sí | El string userAgent del navegador. Requerido para la verificación de spam. |
| referer | string | sí | El string referer de la solicitud. Requerido para la verificación de spam. |
| ip | string | sí | La IP del usuario que envía la consulta. Requerida para la verificación de spam. |
| domain | string | sí | El nombre de dominio del portal que envía la consulta. |
| url | string | sí | La URL del aviso en tu sitio. Puede ser igual al referer. |
| urlAlt | string | no | Una URL alternativa útil para la inmobiliaria. Por ejemplo, una URL de estadísticas. |
| test | boolean | no | Modo de prueba. La consulta se registra igual, pero se deriva a una cuenta de prueba de Mapaprop en lugar de la inmobiliaria del aviso: no le llega a ninguna inmobiliaria real. Es la forma recomendada de verificar la integración de punta a punta antes de publicar los avisos. No exime de las validaciones: el agencyId y el aviso tienen que ser válidos igual. |
| name | string | sí | Nombre del usuario que envía la consulta. |
| string | o | Email del usuario que envía la consulta. Hay que enviar email o teléfono. | |
| phone | string | o | Teléfono del usuario que envía la consulta. Hay que enviar email o teléfono. |
| message | string | sí | Texto enviado por el usuario con la consulta, o texto autogenerado legible para la inmobiliaria. |
Ejemplo de código
POST /api/action/feed-v1/submit-question HTTP/1.1
Host: mapaprop.app
Content-Type: application/x-www-form-urlencoded
Content-Length: 0
Authorization: Bearer {access_token}
agencyId=ECID00222201EN&propertyId=16928-avC&portalName=Trovit&
userAgent=Mozilla%2F5.0%20%28X11%3B%20Linux%20x86_64%29%20AppleWebKit%2F537.36%20%28KHTML%2C%20like%20Gecko%29%20Chrome%2F32.0.1700.77%20Safari%2F537.36
&referer=http%3A%2F%2Ftrovit.com%2Fad%3Fid%3D111
&ip=85.33.65.69&domain=trovit.com&url=http%3A%2F%2Ftrovit.com%2Fad%3Fid%3D111
&name=John%20Doe&email=john.doe%40example.com&phone=6667117&message=Want%20to%20know%20more%20about%20this
Alcanza con email o phone, pero conviene enviar las dos claves —aunque una vaya vacía—, como en el ejemplo de arriba. Es la forma que no depende de cómo serialice el formulario de tu sitio.
Respuesta
La respuesta JSON indica si la consulta fue enviada correctamente. En caso contrario, informa si quedó en cola de moderación por parecer spam o si contiene campos inválidos.
| Objeto | Campo | Tipo | Requerido | Descripción |
|---|---|---|---|---|
| Response | success | boolean | sí | Booleano que indica si el envío fue exitoso |
| error | string | no | Texto que indica el tipo de error cuando success == false |
ACCIÓN REQUERIDA
Si recibís error=PROPERTY_NOT_FOUND, debés eliminar la propiedad de tu inventario de inmediato. Eso significa que el cliente dejó de publicar esa propiedad o la eliminó de nuestro inventario.
Muchos clientes se quejan de que sus propiedades siguen publicadas en portales externos.
{
"success": false,
"error": "INVALID_EMAIL"
}