Gestiona contactos y visitas

Introducción

Cuando los usuarios buscan en los artículos clasificados, 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. Existe una diferencia respecto del funcionamiento entre los usuarios que iniciaron sesión y los usuarios invitados. Cuando los usuarios invitados realizan una pregunta sobre tu artículo, el contacto se dirige directamente al buzón de entrada de tu correo electrónico y se mostrará en nuestro recurso de contacts, porque no sigue el flujo de preguntas habitual. Cuando un usuario que tiene cuenta en nuestro sitio e inició sesión realiza una pregunta, sigue el flujo de preguntas habitual y puedes utilizar el recurso de questions. Para ver cómo trabajar con preguntas de usuarios que iniciaron sesión, consulta nuestra guía de Administración 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.

Descripción de parámetros

Preguntas 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

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
}

Preguntas 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

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"
}

Clicks 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_date}

Por usuario

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
        	}
    	]
	}
]

Siguiente: Recibe notificaciones.