Gerenciamento de perguntas e respostas

As perguntas a forma pela qual os compradores podem se comunicar com os vendedores na página Detalhes do produto antes de realizar uma transação e, portanto, o modo como você lida com a interação nessa fase será decisivo para uma venda bem-sucedida.

Assuntos

Busca de perguntas

Existem várias maneiras de buscar perguntas.

Perguntas recebidas pelo vendedor

curl -X GET -H "Content-Type: application/json" 'https://api.mercadolibre.com/questions/search?seller_id={Seller_id}&access_token=$ACCESS_TOKEN'

Perguntas recebidas sobre um produto

curl -X GET -H "Content-Type: application/json" 'https://api.mercadolibre.com/questions/search?item={Item_id}'

Perguntas feitas por um usuário sobre um produto

curl -X GET -H "Content-Type: application/json" 'https://api.mercadolibre.com/questions/search?item={Item_id}&from={Cust_id}'

Perguntas por id

curl -X GET -H "Content-Type: application/json" 'https://api.mercadolibre.com/questions/{question_id}?access_token=$ACCESS_TOKEN'

Observação: Leve em conta que se você fizer uma consulta sem accesstoken e o estado da pergunta for DELETED ou BANNED obterá “question not found”.



Vamos analisar os atributos que encontraremos no recurso Search Questions.

Descrição dos atributos

id
ID da pergunta.
date_created
Data de criação.
item_id
ID do produto ao qual pertence a pergunta.
seller_id
ID do vendedor do produto.
status
Status da pergunta. Valores possíveis:
Atributos
unanswered
A pergunta ainda não foi respondida.
answered
A pergunta foi respondida.
closed_unanswered
O produto está encerrado, e a pergunta nunca foi respondida.
under_review
O produto está em análise, e a pergunta também.
text
Texto da pergunta.
answer
Resposta do vendedor.
Atributos
date_created
Data de criação.
status
Status da resposta. Valores possíveis:
Atributos
active
A resposta se encontra ativa.
disabled
A resposta foi desabilitada.
text
Texto da resposta

Excelente! Agora você já sabe quais aspectos deve levar em conta com relação às perguntas. Veja quais são as ações disponibilizadas conforme a busca de perguntas.

Métodos autorizados

GET /questions/:id
Retorna uma pergunta com esse ID.
POST /questions
Cria uma pergunta sobre um produto.
DELETE /questions/:id
Exclui uma pergunta.
POST /answers/
Publica uma resposta para uma determinada pergunta.
POST /my/questions/hidden
Oculta perguntas.
Como pode ver, é possível buscar perguntas por produto, vendedor e usuário que as tenha formulado, e filtrá-las por estado ou período. Se quiser, você também pode buscar todas as perguntas recebidas e ocultá-las.

Recursos e conexões relacionados

Use os recursos a seguir para buscar perguntas por produto ou usuário. É preciso incluir o item_id ou cust:id.

 "related_resources": [
        "/items",
        "/users"
    ],
    "connections": {
        "item_id": "/items/:id",
        "seller_id": "/users/:id"
    }
}'

Veja alguns exemplos de como buscar perguntas em nossa plataforma.

Formulação de perguntas

É muito fácil. Você só precisa conhecer o item_id e enviá-lo com uma cadeia de texto no corpo do JSON, como no exemplo abaixo:

 curl -i -X POST -H "Content-Type: application/json" -d
'{
   "text":"Do you have these shoes in red?",
   "item_id":"MLA123456"
}'

https://api.mercadolibre.com/questions/{Item_Id}?access_token=$ACCESS_TOKEN

Resposta a perguntas

Quando você tem uma grande quantidade de produtos publicados no Mercado Livre, é bem provável que receba muitas perguntas. Por isso, recomendamos desenvolver um método para respondê-las de modo semiautomático, no qual as respostas são sugeridas aos operadores com base nas palavras-chave recebidas frequentemente.
Para isso, você deve saber como responder a uma pergunta via API. Vai ser fácil.

Primeiramente, vamos dar uma olhada em todas as perguntas recebidas sobre seu produto. Basta fazer uma busca de perguntas por produto, conforme o exemplo abaixo:

 curl 'https://api.mercadolibre.com/questions/search?item_id=ITEM_ID&access_token=XXXX'

Você vai ver que as perguntas têm um status. Por isso, é provável que você tenha de mantê-las com o status “unanswered”.

Agora responderemos a uma só pergunta:

 curl -i -X POST -H "Content-Type: application/json" -d
'{
  question_id: QUESTION_ID,
  text:"Some text here..."
}'

https://api.mercadolibre.com/answers?access_token=XXXX

Vamos fazer isso utilizando os nossos SDKs (exemplo).

Ao trabalhar com perguntas, é importante ouvir as Notificações, pois isso permite obter um feed em tempo real dos eventos produzidos em relação a elas. Saiba como trabalhar com Notificações.

Exclusão de perguntas

Se você precisar excluir uma resposta de um usuário sobre seu produto, use o método EXCLUIR com o ID da pergunta e o token de acesso do usuário.
Exemplo:

 curl -X DELETE 'https://api.mercadolibre.com/questions/${question_id}?access_token=$ACCESS_TOKEN'

Exclusão com os nossos SDK (exemplo)

Resposta:

[
  "Question deleted."
]

Lista negra de perguntas

Gerenciar a lista negra de perguntas permite bloquear usuários para evitar que eles façam perguntas sobre seus produtos. Posteriormente, você pode removê-los da lista negra para que possam perguntar novamente.

A lista negra é baseada em usuário, e o vendedor tem controle total sobre a lista de usuários que fazem parte dela. Vamos ver alguns exemplos de o que pode ser feito com ela.

Enviar usuários à lista negra de perguntas

 curl -X POST -H "Content-Type: application/json" -d
'{
  "user_id": blocked user id
}'
https://api.mercadolibre.com/users/$SELLER_ID/questions_blacklist?access_token=$ACCESS_TOKEN

Visualizar a lista negra

 curl -X GET 'https://api.mercadolibre.com/users/$SELLER_ID/questions_blacklist?access_token=$ACCESS_TOKEN '

Remover um usuário da lista negra

 curl -X DELETE 'https://api.mercadolibre.com/users/$SELLER_ID/questions_blacklist/$USER_ID?access_token=$ACCESS_TOKEN'

Perfeito! Agora você já sabe o necessário sobre nossa lista negra de perguntas. Esperamos que seja útil para você, se necessário.

Como tomar conhecimento de uma pergunta

Uma pergunta sobre um produto é um evento que acontece pelo lado do Mercado Livre. Por isso, você deverá inscrever-se para nosso feed de perguntas para ficar sabendo, em tempo real, quando esse evento acontecer.
Em primeiro lugar, é necessário configurar nosso aplicativo para poder receber notificações. Isso pode ser feito inscrevendo seu aplicativo para receber notificações de perguntas. Acesse nosso Gerenciador de aplicativos e edite Configuração de notificações de seu aplicativo. Para obter mais informações sobre a criação e configuração de um novo aplicativo, consulte o link.
Você tem de selecionar uma URL de retorno: configure a URL pública do domínio onde deseja receber todas as notificações do Mercado Livre.
Exemplo:

 "http://backend.soleorigami.com/notification"

questions

Também é necessário especificar qual assunto você vai listar, nesse caso, você deve selecionar perguntas.
Essa configuração permite interagir com as notificações do Mercado Livre. Todos os eventos relativos a novas perguntas serão notificados à URL de retorno.

Recebimento de uma notificação

O Mercado Livre enviará notificações através de uma mensagem POST com informações no corpo do item. O atributo mais importante da mensagem é o user_id, que está relacionado à notificação, o segundo em importância é o resource. O resource é o elemento que foi atualizado ou criado.

 {
  "user_id": 1234,
  "resource": "/questions/139876",
  "topic": "questions",
  "received": "2011-10-19T16:38:34.425Z",
  "sent" : "2011-10-19T16:40:34.425Z",
}

Depois de receber a notificação, você deve enviar uma confirmação de recebimento (ACK 200) ao Mercado Livre, para que ela não mais seja enviada.
Para obter mais informações, consulte nosso tutorial Notificações.

Referência de códigos de erro

Error_codeMensagem de erroDescriçãoPossível solução
invalid_questionA pergunta é inválidaNão é possível responder à pergunta.O parâmetro question_id deve ser um número inteiro. (Para buscar sua pergunta, faça uma chamada para resource/questions/search [recurso/perguntas/busca]).
invalid_post_bodyJSON inválido. Os atributos válidos são: {0}.Parâmetros inválidos.Os parâmetros esperados são question_id e text



Próximo:
Gerenciamento de vendas.

Qualifique entre 1 e 5