POST /api/action/portal-v2/messages

PROD

Este servicio se usa para enviar una consulta al cliente. Se validan los datos básicos y se realiza verificación anti-spam.

Información del recurso
Autenticación	Required
Método HTTP	POST
Respuesta	JSON
Versión	1

URL del recurso

https://mapaprop.app/api/action/portal-v2/messages

Parámetros

Clave	Tipo	Requerido	Descripción
propertyHash	string	yes	El hash ID de la propiedad. Obtenés los IDs en GET /api/action/express-v1/properties o GET /api/action/express-v1/properties/{propertyHash}
userAgent	string	yes	El userAgent real del navegador del usuario. Requerido para verificación anti-spam.
referer	string	yes	El referer desde donde se envía la consulta. Requerido para verificación anti-spam.
ip	string	yes	La IP del usuario que envía la consulta. Requerido para verificación anti-spam.
url	string	yes	La URL del aviso en tu sitio. Puede ser igual al referer.
name	string	yes	Nombre del usuario que envía la consulta.
email	string	or	Email del usuario que envía la consulta. Se debe enviar email o teléfono.
phone	string	or	Teléfono del usuario que envía la consulta. Se debe enviar email o teléfono.
message	string	yes	Texto enviado por el usuario referido a la consulta, o texto generado automáticamente legible para la agencia.

Ejemplo de llamada

POST /api/action/portal-v2/messages HTTP/1.1
Host: mapaprop.app
Content-Type: application/x-www-form-urlencoded
Content-Length: 0
Authorization: Bearer {access_token}

propertyHash=32ojflsdfjasld-avC&
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=someinmo.com&url=http%3A%2F%2Fsomeinmo.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 exitosamente. En caso contrario, informa si está en cola de moderación por sospecha de spam o si hay campos inválidos.

Objeto	Campo	Tipo	Requerido	Descripción
Response	success	boolean	yes	Booleano que indica si el envío fue exitoso o no
	error	string	no	Texto que indica el tipo de error cuando success == false

Ejemplo de respuesta

{
    "success": false,
    "error": "INVALID_EMAIL"
}