Gestiona preguntas y contactos

Cuando los usuarios buscan en los artículos clasificados (inmuebles, vehículos, servicios), pueden contactar al propietario del artículo a través de un formulario que se muestra en la publicación o pueden ver el teléfono del propietario (ver teléfono). En el caso de una pregunta, cuando se realiza, se la envía automáticamente al buzón de entrada de mensajes, dentro de la cuenta del cliente en Mercado Libre. Es muy importante que su integración lea las preguntas y también permita que los usuarios puedan responderlas a través del sistema. Para saber cómo manejar las preguntas y respuestas (leads), consulte nuestra guía de Gestión de preguntas y respuestas. Aquí tiene todo el contenido necesario para poder realizar la integración de leads de Mercado Libre. Además de la guía mencionada arriba, puede consultar datos sobre preguntas y registrar cuántos clics tuvo la opción "Ver teléfono". Estos métodos se detallan más abajo. Recuerda que las publicaciones con el botón "Quiero que me contacten", cuando este sea presionado por el comprador, se generará una nueva pregunta en la misma API de preguntas y respuestas.


Guía de contactos clasificados

Esta guía te ayudará a recolectar datos sobre preguntas y visualizaciones del teléfono en tus artículos clasificados. Se trata de una API de solo lectura, muy útil para llevar métricas de tus artículos clasificados. Puedes consultar datos sobre preguntas y llevar un registro de cuántas veces se hizo clic en la opción ‘Ver teléfono’. Puedes consultar por usuario, artículo, fechas y períodos de tiempo.


Contenidos

→Descripción de parámetros
→Contactos totales
→Clicks en teléfonos de contacto
→Click en teléfonos de contacto con fecha
→Visitas por publicación


Descripción de parámetros

Tipo Parámetro Descripción
Entero {userId} ID de usuario.
Entero {itemId} ID de artículo.
Fecha {dateFrom} Fecha, en formato ISO, que define el inicio de la consulta.
Fecha {dateTo} Fecha, en formato ISO, que define el fin de la consulta.
Entero {limit} Opcional. Cantidad máxima de artículos a devolver.
Entero {offset} Opcional. Paginación.
Entero {last} Opcional. Denota cuántas horas/días atrás cubrirá la muestra.
Cadena {unit} Unidad de consulta, valores posibles: [“día”, “hora”].
Fecha {ending} Opcional. Fecha, en formato ISO, que establece el tiempo de finalización de la muestra; por defecto es la fecha y hora actuales.
Cadena {order} Opcional. Clasifica los resultados por fecha: [“desc”, “asc”] (por defecto es “asc”).

Contactos totales

Puedes acceder a las preguntas totales que tuvo un artículo o las preguntas totales que tuvo un vendedor en todos sus artículos en un rango de fechas.


Por artículo:

curl -X GET https://api.mercadolibre.com/items/$ITEM_ID/contacts/questions?date_from=$DATE_FROM&date_to=$DATE_TO

Por usuario:

Ejemplo:

curl -X GET https://api.mercadolibre.com/users/$USER_ID/contacts/questions?date_from=$DATE_FROM&date_to=$DATE_TO

Ejemplo:

curl -X GET https://api.mercadolibre.com/items/MLV421672596/contacts/questions?date_from=2014-08-01T00:00:00.000-03:00&date_to=2014-08-02T23:59:59.999

Respuesta:

{
	"date_from": "2014-08-01T00:00:00.000-03:00",
	"date_to": "2014-08-02T23:59:59.999",
	"item_id": "MLV421672596",
	"total": 9
}

Contactos con fecha

Este recurso te permite acceder a las preguntas sobre un artículo específico o por vendedor para un período de tiempo específico. Además, accedes a detalles sobre contactos realizados en modo invitado (usuarios que no iniciaron sesión o que no están registrados) entre intervalos de tiempo, por hora o por día.


Por artículo

curl -X GET https://api.mercadolibre.com/items/$ITEM_ID/contacts/questions/time_window?last=$LAST&unit=$UNIT

Si necesitas concatenar artículos, haz lo siguiente:

curl -X GET https://api.mercadolibre.com/items/$ITEM_ID/contacts/questions/time_window?ids=$ID1,ID2&last=$LAST&unit=$UNIT&ending=$ENDING_DATE

Por usuario

Llamada:

curl -X GET https://api.mercadolibre.com/users/$USER_ID/contacts/questions/time_window?last=$LAST&unit=$UNIT

Ejemplo:

curl -X GET https://api.mercadolibre.com/items/MLA510272257/contacts/questions/time_window?last=2&unit=hour

Respuesta:

{
	"item_id": "MLA510272257",
	"total": 0,
	"date_from": "2014-08-06T12:00:00Z",
	"date_to": "2014-08-06T14:00:00Z",
	"last": 2,
	"unit": "hour",
	"results": [
    	{
        	"date": "2014-08-06T12:00:00Z",
        	"total": 0
    	},
    	{
      	  "date": "2014-08-06T13:00:00Z",
        	"total": 0
    	}
	]
}

Clicks en teléfonos de contacto

Puedes acceder a la cantidad total de veces que se hizo clic en la opción ‘Ver teléfono’ de un artículo o para cada artículo de un usuario en rangos de fechas.


Por artículo

curl -X GET https://api.mercadolibre.com/items/$ITEM_ID/contacts/phone_views?date_from=$DATE_FROM&date_to=$DATE_TO

Por usuario

curl -X GET https://api.mercadolibre.com/users/$USER_ID/contacts/phone_views?date_from=$DATE_FROM&date_to=$DATE_TO

Ejemplo:

curl -X GET https://api.mercadolibre.com/users/52366166/contacts/phone_views?date_from=2014-05-28T00:00:00.000-03:00&date_to=2014-05-29T23:59:59.999

Respuesta:

{
	"date_from": "2014-05-28T00:00:00.000-03:00",
	"date_to": "2014-05-29T23:59:59.999",
	"total": 71,
	"user_id": "52366166"
}

Click en teléfonos de contacto con fecha

Puedes acceder a la cantidad total de veces que se hizo clic en la opción ‘Ver teléfono’ de un artículo o para cada artículo de un usuario durante cierto período de tiempo. Además de entregar las visitas totales, la información se detalla y agrupa por intervalo de tiempo.


Por artículo

curl -X GET https://api.mercadolibre.com/items/$ITEM_ID/contacts/phone_views/time_window?last=$LAST&unit=$UNIT

Si necesitas concatenar artículos:

curl -X GET https://api.mercadolibre.com/items/contacts/phone_views/time_window?ids=$ID1,ID2&last=$LAST&unit=$UNIT&ending=$ENDING_NOTE

Por usuario

Llamada:

curl -X GET https://api.mercadolibre.com/users/$USER_ID/contacts/phone_views/time_window?last=$LAST&unit=$UNIT

Ejemplo:

curl -X GET https://api.mercadolibre.com/items/contacts/phone_views/time_window?ids=MLA510272257,MLA489747739&last=2&unit=hour&ending=2014-05-28T00:00:00.000-03:00

Respuesta:

[
	{
    	"item_id": "MLA510272257",
    	"total": 0,
    	"date_from": "2014-05-28T02:00:00Z",
    	"date_to": "2014-05-28T04:00:00Z",
    	"last": 2,
    	"unit": "hour",
    	"results": [
        	{
            	"date": "2014-05-28T02:00:00Z",
            	"total": 0
        	},
        	{
            	"date": "2014-05-28T03:00:00Z",
            	"total": 0
        	}
    	]
	},
	{
    	"item_id": "MLA489747739",
    	"total": 0,
    	"date_from": "2014-05-28T02:00:00Z",
  	  "date_to": "2014-05-28T04:00:00Z",
    	"last": 2,
    	"unit": "hour",
    	"results": [
        	{
            	"date": "2014-05-28T02:00:00Z",
            	"total": 0
        	},
        	{
            	"date": "2014-05-28T03:00:00Z",
            	"total": 0
        	}
    	]
	}
]

Visitas por publicación

Para consultar las visitas por anuncio, utilice el artículo Recurso de Visitas.

Siguiente: Recibe notificaciones.

o regístrate para recibir las últimas novedades sobre nuestra API