Gerenciamento de contatos

Toda vez que os usuários fazem uma busca nos produtos classificados, eles podem contatar o proprietário do produto por meio de um formulário exibido na publicação ou podem ver o telefone do proprietário. 
Existe uma diferença de funcionamento para usuários que fizeram login e convidados. Quando usuários convidados fazem uma pergunta sobre seu produto, o contato é dirigido diretamente à caixa de entrada de seu correio eletrônico e é exibido em nosso recurso de contatos, pois não está seguindo o fluxo habitual das perguntas. Quando um usuário que já tem conta em nosso site e já fez login faz uma pergunta, ele segue o fluxo habitual das perguntas e a API de perguntas pode ser usada. Para ver como trabalhar com perguntas feitas por usuários conectados, consulte nosso guia de Gerenciamento de perguntas e respostas. Este guia ajudará você a coletar dados sobre perguntas e visualizações de telefone em seus produtos classificados. É uma API somente leitura, muito útil para fazer métricas de seus produtos classificados. Você pode consultar dados sobre perguntas e fazer um registro de quantos cliques a opção "Ver telefone" teve. Você pode consultar por usuário, produto, datas e períodos.

Assuntos:

 

Descrição de parâmetros

Tipo Parâmetro Descrição
Integer {userId} ID de usuário.
Integer {itemId} ID do produto.
Date {dateFrom} Data, no formato ISO, que define o início da consulta.
Date {dateTo} Data, no formato ISO, que define o final da consulta.
Integer {limit} Opcional. Quantidade máxima de produtos a devolver.
Integer {offset} Opcional. Paginação.
Integer {last} Opcional. Denota quantas horas/dias a amostra abrangerá.
String {unit} Unidade de consulta, valores possíveis: [“dia”, “hora”].
Date {ending} Opcional. Data, em formato ISO, estabelecendo o tempo de finalização da amostra; por padrão, deve ser a data e a hora atuais.
String {order} Opcional. Classifica os resultados por data: [“desc”, “asc”] (por padrão, “asc”).

Total de perguntas

Você pode acessar o total de perguntas que um produto teve, ou o total de perguntas recebidas por um vendedor em todos os seus produtos, em um intervalo de tempo.

Por produto

GET https://api.mercadolibre.com/items/{Item_id}/contacts/questions?date_from={Date_from}&date_to={Date_to}

Por usuário

curl -X GET https://api.mercadolibre.com/users/{User_id}/contacts/questions?date_from={Date_from}&date_to={Date_to}
Exemplo: 
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
Resposta: 
{
    "date_from": "2014-08-01T00:00:00.000-03:00",
    "date_to": "2014-08-02T23:59:59.999",
    "item_id": "MLV421672596",
    "total": 9
}

Perguntas por data

Este recurso permite acessar as perguntas sobre um determinado produto ou vendedor durante um intervalo de tempo especificado. Além disso, você obtém detalhes sobre contatos feitos em modo convidado (usuários que não fizeram login ou não são cadastrados), em intervalos de tempo, por hora ou por dia.

Por produto

curl -X GET https://api.mercadolibre.com/items/{Item_id}/contacts/questions/time_window?last={Last}&unit={Unit}
Caso você precise concatenar produtos, faça o seguinte: 
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 usuário

curl -X GET https://api.mercadolibre.com/users/{User_id}/contacts/questions/time_window?last={Last}&unit={Unit}
Exemplo: 
curl -X GET https://api.mercadolibre.com/items/MLA510272257/contacts/questions/time_window?last=2&unit=hour
Resposta: 
{
    "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
        }
    ]
}

Total de telefones de contato

Você pode acessar o total de cliques da opção “Ver telefone“ de um produto, ou para cada um dos produtos de um usuário, em intervalos de tempo.

Por produto

curl -X GET https://api.mercadolibre.com/items/{Item_id}/contacts/phone_views?date_from={Date_from}&date_to={Date_to}

Por usuário

curl -X GET https://api.mercadolibre.com/users/{User_id}/contacts/phone_views?date_from={Date_from}&date_to={Date_to}
Exemplo: 
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
Resposta: 
{
    "date_from": "2014-05-28T00:00:00.000-03:00",
    "date_to": "2014-05-29T23:59:59.999",
    "total": 71,
    "user_id": "52366166"
}

Telefones de contato por data

Você pode acessar o total de cliques da opção “Ver telefone" de um produto, ou para cada um dos produtos de um usuário, durante um determinado intervalo de tempo. Além de fornecer o total de visitas, as informações são listadas e agrupadas por intervalos de tempo.

Por produto

curl -X GET https://api.mercadolibre.com/items/{Item_id}/contacts/phone_views/time_window?last={Last}&unit={Unit}
Caso você precise concatenar produtos, faça o seguinte: 
curl -X GET https://api.mercadolibre.com/items/contacts/phone_views/time_window?ids={Id1,Id2}&last={Last}&unit={Unit}&ending={Ending_date}

Por usuário

curl -X GET https://api.mercadolibre.com/users/{User_id}/contacts/phone_views/time_window?last={Last}&unit={Unit}
Exemplo: 
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
Resposta: 
[
    {
        "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
            }
        ]
    }
]
Próximo: Recebimento de notificações.
ou registre-se para receber as últimas notícias sobre nossa API