• API Docs
  • Guia para servicios
  • Gestiona contactos y visitas
Última actualización 06/12/2022

Gestiona contactos y visitas

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.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

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”).


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/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:

Respuesta:

{
 "code":"bad_request",
 "message":"error decoding 'user_id'. It must be string or number"
}


Siguiente:
Recibe notificaciones.