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 | Si se envía en true, se realiza la validación pero la consulta no se registra. |
| 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&phone=6667117&message=Want%20to%20know%20more%20about%20this
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"
}