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 que cuentan con el botón "Quiero que me contacten", el comprador agregar este botón e se genera 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
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
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_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 } ] } ]
Visitas por publicación
Para consultar las visitas por anuncio, utilice el artículo Recurso de Visitas.
Siguiente: Recibe notificaciones.