Documentação

PERGUNTAS

Permite buscar e responder as perguntas feitas sobre os anúncios, tanto no MercadoLivre como na loja.

No MercadoShops a diferença em relação ao MercadoLivre existe no conceito ‘conversação’, que agrupa perguntas e respostas mantidas com um cliente.

Cada conversação tem um ID único para poder identificar conversações com os clientes.

Indice

Busca Busca por Id Busca por estado Busca por palavra Responder Excluir pergunta Busca por conversação

AÇÕES:

BUSCA POR ID

Retorna a informação de uma pergunta identificada pelo seu ID

GET  /v1/shops/{SHOP_ID}/questions/{QUESTION_ID} 

Mostrar exemplo 
https://api.mercadoshops.com/v1/shops/{SHOP_ID}/questions/{QUESTION_ID}?access_token={access_token} 

Parâmetros

ParâmetroValoresExemplo
access_token Código de segurança access_token=APP_USR-4X30-XXXXX-
SHOP_ID Id do usuário do mercadolivre / mercadoshops https://api.mercadoshops.com/v1/shops /15XXXXX24/
QUESTION_ID Id da pergunta https://api merdoshops.com/v1/shops/15XXXXX24/questions/11111111?acess_token=**************
{
id
Id único da Pergunta
Tipo
NUMERICO
status
Estado
Tipo
STRING
Valores possíveis
"unanswered"
"answered"
store_id
Id da loja
Tipo
NUMERICO
Recurso relacionado: link para a API de info da loja
from
{
Usuário que perguntou
Tipo
OBJETO
email
Email
Tipo
STRING
name
Nome do usuário
Tipo
STRING
client_id
Id do usuário
Tipo
NUMERICO
Recurso relacionado: link para a API dos clientes
},
question
{
Descrição
Pergunta
Tipo
OBJETO
text
Texto da pergunta
Tipo
STRING
date
Data que a pergunta foi feita
Tipo
Date(ISO_8601)
},
type
Tipo de anúncio da pergunta
Tipo
STRING
Valores possíveis
shop
Pergunta feita na loja a partir da seção de contato
item
Pergunta feita em um item anunciado no MercadoLivre ou na loja
thread_id
Id da conversação que contém a pergunta
Tipo
STRING
channel
Canal de venda do anúncio
Tipo
STRING
Valores possíveis
mshops
mercadoshops
meli
mercadolivre
publication
{ Dados do anúncio da pergunta
Tipo
OBJETO
id
ID do anúncio da pergunta
Tipo
STRING
currency_id
Tipo Moeda
Tipo
STRING
title
Título do anúncio da pergunta
Tipo
STRING
price
Preço do anúncio da pergunta
Tipo
STRING
stock
Estoque disponível do anúncio da pergunta
Tipo
STRING
thumbnail
Link da miniatura da imagem do anúncio
Tipo
STRING
permalink
Link do anúncio
Tipo
STRING
}
}
{
id
60******,
store_id
1*******4,
channel
"meli",
status
"answered",
type
"item",
creation_date
"2014-09-02T00:49:35.000-04:00",
question
{
date
"2014-09-02T00:49:31.000-04:00",
text
"texto de exemplo"
},
answer
{
date
"2014-09-02T09:21:53.000-04:00",
text
"Hola * * * * * * * * * * * * icial.",
source
"ML"
},
thread_id
"meli-15****4-94306809-MLA*****14",
publication
{
id
"MLA576205014",
title
"****** Fluid",
permalink
"http://articulo.mercadolibre.com.ar/MLA-576****4-campera-*****-_JM",
thumbnail
"http://mla-s2-p.mlstatic.com/18210-MLA*****16_082014-I.jpg",
stock
5,
currency_id
"ARS",
price
570
},
from
{
client_id
131,
name
"****aro",
meli_cust_id
94****9,
nickname
"NF*******89"
}
}
BUSCA POR ESTADO
GET  /v1/shops/{SHOP_ID}/questions/search 

Mostrar ejemplo 
https://api.mercadoshops.com/v1/shops/{SHOP_ID}/questions/search?status=unanswered&limit=10&orders=question_date_asc&access_token={access_token} 

Parâmetros

ParâmetroValoresExemplo
access_token Código de segurança access_token=APP_USR-4X30-XXXXX-
SHOP_ID Id do usuário do mercadolivre / mercadoshops https://api.mercadoshops.com/v1/shops /15XXXXX24/

Filtros

NomeValoresExemplo
status Unanswered : Sem responder

Answered : Respondidas
status=unanswered
channel mshops : mercadoshops

meli: mercadolivre
channel=mshops

Paginação e Ordenação

NomeValoresExemplo
limit Limite de itens devolvidos limit=10
orders question_date_asc

Ordem por data de criação crescente

question_date_desc

Ordem por data de criação decrescente
orders=question_date_asc
{
seller_id
Id usuário do mercadolivre / mercadoshops
Tipo
NUMERICO
query
palavra que foi usada para a busca
Tipo
STRING
paging
{
Descrição
Resumo da Paginação
Tipo
OBJETO
total
Total de resultados devolvidos
Tipo
NUMERICO
offset
Offset aplicado
Tipo
NUMERICO
limit
Limite de resultados aplicados
Tipo
NUMERICO
},
results
[
Descrição
Resultado
Tipo
OBJETO
{
creation_date
Data de Criação
Tipo
Date(ISO_8601)
id
Id único da Pergunta
Tipo
NUMERICO
status
Estado
Tipo
STRING
Valores possíveis
"unanswered"
"answered"
store_id
Id da loja
Tipo
NUMERICO
from
{
Usuário que perguntou
Tipo
OBJETO
email
Email
Tipo
STRING
name
Nome do usuário
Tipo
STRING
client_id
Id do usuário
Tipo
NUMERICO
},
question
{
Descrição
Pergunta
Tipo
OBJETO
text
Texto da pergunta
Tipo
STRING
date
Data que a pergunta foi feita
Tipo
Date(ISO_8601)
},
type
Tipo de anúncio da pergunta
Tipo
STRING
Valores possíveis
shop
mercadoshops
item
mercadolivre
thread_id
Id da conversação que contém esta pergunta
Tipo
STRING
channel
Canal de venda do anúncio
Tipo
STRING
Valores possíveis
mshops
mercadoshops
meli
mercadolivre
},
],
orders
[
Descrição
Tipos de ordenações APLICADAS
Tipo
ARRAY DE OBJETOS
{
id
"question_date_asc",
name
"Order by question date ascending"
}
],
filters
[
Descrição
Tipos de filtros APLICADOS
Tipo
ARRAY DE OBJETOS
{
id
"status",
name
"Status",
values
[
{
id
"answered",
name
"Answered questions",
results
0
},
{
id
"unanswered",
name
"Unanswered questions",
results
2
}
]
}
],
available_orders
[
Descrição
Tipos de ordenações possíveis
Tipo
ARRAY DE OBJETOS
{
id
"question_date_asc",
name
"Order by question date ascending"
},
{
id
"question_date_desc",
name
"Order by question date descending"
}
],
available_filters
[
Descrição
Tipos de filtros possíveis
Tipo
ARRAY DE OBJETOS
{
id
"status",
name
"Status",
values
[
{
id
"answered",
name
"Answered questions",
results
1
},
{
id
"unanswered",
name
"Unanswered questions",
results
1
},
{
id
"closed_unanswered",
name
"Closed unanswered questions",
results
0
}
]
},
{
id
"channel",
name
"Channel",
values
[
{
id
"mshops",
name
"MercadoShops questions",
results
2
},
{
id
"meli",
name
"MercadoLibre questions",
results
0
}
]
}
]
}
ERROS :
403: Token Invalido
BUSCA POR PALAVRA
GET  /v1/shops/{SHOP_ID}/questions/search/q 

Mostrar exemplo 
https://api.mercadoshops.com/v1/shops/{SHOP_ID}/questions/search?q={PALABRA}&limit=3&access_token={access_token} 

Parâmetros

ParâmetroValoresExemplo
access_token Código de segurança access_token=APP_USR-4X30-XXXXX-
SHOP_ID Id do usuário do mercadolivre / mercadoshops https://api.mercadoshops.com/v1/shops /15XXXXX24/
q Palavra para buscar q=campera

Filtros

NombreValoresEjemplo
status Unanswered : Sem responder

Answered : Respondidas
status=unanswered
channel mshops : mercadoshops

meli: mercadolivre
channel=mshops

Paginação e Ordenação

NomeValoresExemplo
limit Limite de itens devolvidos limit=10
orders question_date_asc

Ordem por data de criação crescente

question_date_desc

Ordem por data de criação decrescente
orders=question_date_asc
{
seller_id
Id usuário do mercadolivre / mercadoshops
Tipo
NUMERICO
query
palavra que foi usada para a busca
Tipo
STRING
paging
{
Descrição
Resumo da Paginação
Tipo
OBJETO
total
Total de resultados devolvidos
Tipo
NUMERICO
offset
Offset aplicado
Tipo
NUMERICO
limit
Limite de resultados aplicados
Tipo
NUMERICO
},
results
[
Descrição
Resultado
Tipo
OBJETO
{
creation_date
Data da Criação
Tipo
Date(ISO_8601)
id
Id único da Pergunta
Tipo
NUMERICO
status
Estado
Tipo
STRING
Valores possíveis
"unanswered"
"answered"
store_id
Id da loja
Tipo
NUMERICO
from
{
Usuário que perguntou
Tipo
OBJETO
email
Email
Tipo
STRING
name
Nome do usuário
Tipo
STRING
client_id
Id do usuário
Tipo
NUMERICO
},
question
{
Descrição
Pergunta
Tipo
OBJETO
text
Texto da pergunta
Tipo
STRING
date
Data que a pergunta foi feita
Tipo
Date(ISO_8601)
},
type
Tipo de anúncio da pergunta
Tipo
STRING
Valores possíveis
shop
mercadoshops
item
mercadolivre
thread_id
Id da conversação que contém esta pergunta
Tipo
STRING
channel
Canal de venda do anúncio
Tipo
STRING
Valores possíveis
mshops
mercadoshops
meli
mercadolivre
},
],
orders
[
Descrição
Tipos de ordenações APLICADAS
Tipo
ARRAY DE OBJETOS
{
id
"question_date_asc",
name
"Order by question date ascending"
}
],
filters
[
Descrição
Tipos de filtros APLICADOS
Tipo
ARRAY DE OBJETOS
{
id
"status",
name
"Status",
values
[
{
id
"answered",
name
"Answered questions",
results
0
},
{
id
"unanswered",
name
"Unanswered questions",
results
2
}
]
}
],
available_orders
[
Descrição
Tipos de ordenações possíveis
Tipo
ARRAY DE OBJETOS
{
id
"question_date_asc",
name
"Order by question date ascending"
},
{
id
"question_date_desc",
name
"Order by question date descending"
}
],
available_filters
[
Descrição
Tipos de filtros possíveis
Tipo
ARRAY DE OBJETOS
{
id
"status",
name
"Status",
values
[
{
id
"answered",
name
"Answered questions",
results
1
},
{
id
"unanswered",
name
"Unanswered questions",
results
1
},
{
id
"closed_unanswered",
name
"Closed unanswered questions",
results
0
}
]
},
{
id
"channel",
name
"Channel",
values
[
{
id
"mshops",
name
"MercadoShops questions",
results
2
},
{
id
"meli",
name
"MercadoLibre questions",
results
0
}
]
}
]
}
RESPONDER UMA PERGUNTA

Responde uma pergunta por meio do seu ID.

PUT  /v1/shops/{SHOP_id}/questions/{QUESTION_ID} 

Mostrar exemplo 
https://api.mercadoshops.com/v1/shops/{SHOP_ID}/questions/{QUESTION_ID}?access_token={token} 

Para responder uma pergunta tem que fazer um PUT para a url indicada com um JSON que inclua a resposta com este formato

Content-Type: application/json

{answer: " resposta da pergunta "}

Parâmetros

ParâmetroValoresExemplo
access_token Código de segurança access_token=APP_USR-4X30-XXXXX-
SHOP_ID Id do usuário do mercadolivre / mercadoshops https://api.mercadoshops.com/v1/shops /159999999/
ID ID da pergunta v1/shops/159999999/questions/999911111
HTTP STATUS 200 OK
{
answer
"resposta da pergunta "
}
EXCLUIR UMA PERGUNTA
DELETE  HEADER: Content-Type: application/json                      
         /v1/shops/{SHOP_id}/questions/{QUESTION_ID} 

Mostrar exemplo 
https://api.mercadoshops.com/v1/shops/{SHOP_ID}/questions/{QUESTION_ID}?access_token={token} 

Parâmetros

ParâmetroValoresExemplo
access_token Código de segurança access_token=APP_USR-4X30-XXXXX-
SHOP_ID Id do usuário do mercadolivre / mercadoshops https://api.mercadoshops.com/v1/shops/159999999/
ID ID da pergunta v1/shops/159999999/questions/999911111
HTTP STATUS 204
BUSCA POR CONVERSAÇÃO
GET  /v1/shops/{SHOP_ID}/questions/threads/search 

Mostrar exemplo 
https://api.mercadoshops.com/v1/shops/{SHOP_ID}/questions/threads/search?status=answered&access_token={token} 

Parâmetros

ParâmetroValoresExemplo
access_token Código de segurança access_token=APP_USR-4X30-XXXXX-
SHOP_ID Id do usuário do mercadolivre / mercadoshops https://api.mercadoshops.com/v1/shops/15XXXXX24/

Filtros

NomeValoresExemplo
status Unanswered : Sem responder

Answered : Respondidas
status=unanswered
Thread_id Id da Conversação Thread_id =meli-158424724-94306809-
Client_id ID do usuário Client_id =15999999999
query Palava da busca Query=stock

Paginação e Ordenação

NomeValoresExemplo
limit Limite de itens devolvidos limit=10
orders last_question_date_asc

Ordem por data da última pergunta crescente

last_question_date_desc

Ordem por data da última pergunta decrescente
orders=last_question_date_asc
{
seller_id
Id usuário do mercadolivre / mercadoshops
Tipo
NUMERICO
query
palavra para buscar
Tipo
STRING
paging
{
Descrição
Resumo da Paginação
Tipo
OBJETO
total
Total de resultados devolvidos
Tipo
NUMERICO
offset
Offset aplicado
Tipo
NUMERICO
limit
Limite de resultados aplicados
Tipo
NUMERICO
},
results
[
Descrição
Resultado
Tipo
OBJETO
{
id
Id único da Conversação
Tipo
STRING
answered_quantity
quantidade de perguntas respondidas
Tipo
STRING
status
Estado
Tipo
STRING
Valores possíveis
"unanswered"
"answered"
last_question_date
Data da última pergunta
Tipo
Date(ISO_8601)
store_id
Id da loja
Tipo
NUMERICO
channel
Canal de venda do anúncio
Tipo
STRING
Valores possíveis
mshops
mercadoshops
meli
mercadolivre
main_question
{ Pergunta Principal
Tipo
OBJETO
creation_date
Data da criação da pergunta
Tipo
Date(ISO_8601)
id
Id único da Pergunta
Tipo
NUMERICO
status
Estado
Tipo
STRING
Valores possíveis
"unanswered"
"answered"
store_id
Id da loja
Tipo
NUMERICO
from
{
nickname
Apelido do Comprador
Tipo
STRING
name
Nome do comprador
Tipo
STRING
meli_cust_id
meli_cust_id
Tipo
NUMERICO
client_id
Id do usuário
Tipo
NUMERICO
},
question
{ Pergunta
Tipo
OBJETO
text
Texto da pergunta
Tipo
STRING
date
Data de criação da pergunta
Tipo
Date(ISO_8601)
},
type
Tipo de anúncio da pergunta
Tipo
STRING
Valores possíveis
shop
mercadoshops
item
mercadolivre
thread_id
Id da conversação que contém esta pergunta
Tipo
STRING
channel
Canal de venda do anúncio
Tipo
STRING
Valores possíveis
mshops
mercadoshops
meli
mercadolivre
publication
{ Anúncio
Tipo
OBJETO
id
Id do Anúncio em que a pergunta foi feita
Tipo
STRING
currency_id
Id do Tipo de Moeda do preço
Tipo
STRING
title
Título do anúncio
Tipo
STRING
price
Preço do anúncio
Tipo
NUMERICO
stock
Estoque disponível do anúncio da pergunta
Tipo
STRING
thumbnail
Link da miniatura da imagem do anúncio
Tipo
STRING
permalink
Link do anúncio
Tipo
STRING
}
},
unanswered_quantity
Quantidade de pergunta sem responder dentro desta conversação
Tipo
NUMERICO
},
{},
{},
{},
{},
{},
{},
{},
{},
{}
],
orders
[],
filters
[
],
available_orders
[],
available_filters
[],
unanswered_quantity
Quantidade de perguntas sem responder em toda a consulta realizada
Tipo
NUMERICO
}
{
seller_id
999999999,
query
"campera",
paging
{
total
765,
offset
0,
limit
10
},
results
[
{
id
"meli-1999994-549991-MLA57599999",
answered_quantity
0,
status
"unanswered",
last_question_date
"2015-09-15T10:47:07.000Z",
store_id
15999999999,
channel
"meli",
main_question
{
creation_date
"2015-09-15T10:47:13.000Z",
id
349999999999,
status
"unanswered",
store_id
15999999999,
from
{
nickname
"CAXXXXXX1",
name
"Fulano Mengano",
meli_cust_id
50000000,
client_id
399999990
},
question
{
text
"Hola, como va? Te queria preguntar si tenes en stock? Muchas gracias",
date
"2015-09-15T10:47:07.000Z"
},
type
"item",
thread_id
"meli-15999999-599-MLA57599999",
channel
"meli",
publication
{
id
"MLA9999999",
currency_id
"ARS",
title
"Producto a la Venta ",
price
1695,
stock
10,
thumbnail
"http://mla-s2-p.mlstatic.com/18288-ML99999999991_082014-I.jpg",
permalink
"http://articulo.mercadolibre.com.ar/MLA999999-99fred-gold-_JM",
}
},
unanswered_quantity
1
},
{},
{},
{},
{},
{},
{},
{},
{},
{}
],
orders
[],
filters
[
],
available_orders
[
{
id
"last_question_date_asc",
name
"Order by question date ascending"
},
{
id
"last_question_date_desc",
name
"Order by question date descending"
}
],
available_filters
[
{
id
"status",
name
"Status",
values
[]
},
{
id
"channel",
name
"Channel",
values
[]
}
],
unanswered_quantity
5,
}
BUSCA POR ID DE CONVERSAÇÃO
GET  /v1/shops/{SHOP_ID}/questions/threads/{THREAD_ID} 

Mostrar exemplo 
https://api.mercadoshops.com/v1/shops/{SHOP_ID}/questions/threads/{thread_id}?acess_token={token}

Parâmetros

ParâmetroValoresExemplo
access_token Código de segurança access_token=APP_USR-4X30-XXXXX-
SHOP_ID Id do usuário do mercadolivre / mercadoshops https://api.mercadoshops.com/v1/shops/15XXXXX24/
THREAD_ID Id da conversação https://api merdoshops.com/v1/shops/15XXXXX24/questions/threads/meli-1999999-599999MLA575642941?acess_token=**************

Paginação e Ordenação

NomeValoresExemplo
limit Limite de itens devolvidos limit=10
orders question_date_asc

Ordem por data de criação das perguntas crescentes

question_date_desc

Ordem por data de criação das perguntas decrescentes
orders=question_date_asc
{
seller_id
Id usuário do mercadolivre / mercadoshops
Tipo
NUMERICO
query
palavra para buscar
Tipo
STRING
paging
{
Descrição
Resumo da Paginação
Tipo
OBJETO
total
Total de resultados devolvidos
Tipo
NUMERICO
offset
Offset aplicado
Tipo
NUMERICO
limit
Limite de resultados aplicado
Tipo
NUMERICO
},
results
[
Descrição
Resultado
Tipo
OBJETO
{
id
Id único da Conversação
Tipo
STRING
answered_quantity
quantidade de perguntas respondidas
Tipo
STRING
status
Estado da conversação
Tipo
STRING
Valores possíveis
"unanswered"
"answered"
last_question_date
Data da última pergunta
Tipo
Date(ISO_8601)
store_id
Id da loja
Tipo
NUMERICO
channel
Canal de venda do anúncio
Tipo
STRING
Valores possíveis
mshops
mercadoshops
meli
mercadolivre
main_question
{ Pergunta Principal
Tipo
OBJETO
creation_date
Data de criação da pergunta
Tipo
Date(ISO_8601)
id
Id único da Pergunta
Tipo
NUMERICO
status
Estado da Pergunta
Tipo
STRING
Valores possíveis
"unanswered"
"answered"
store_id
Id da loja
Tipo
NUMERICO
from
{
nickname
Apelido do Comprador
Tipo
STRING
name
Nome do comprador
Tipo
STRING
meli_cust_id
meli_cust_id
Tipo
NUMERICO
client_id
Id do usuário
Tipo
NUMERICO
},
question
{ Pergunta
Tipo
OBJETO
text
Texto da pergunta
Tipo
STRING
date
Data de criação da pergunta
Tipo
Date(ISO_8601)
},
type
Tipo de anúncio da pergunta
Tipo
STRING
Valores possíveis
shop
mercadoshops
item
mercadolivre
thread_id
Id da conversação que contém esta pergunta
Tipo
STRING
channel
Canal de venda do anúncio
Tipo
STRING
Valores possíveis
mshops
mercadoshops
meli
mercadolivre
publication
{ Anúncio
Tipo
OBJETO
id
Id do Anúncio em que a pergunta foi feita
Tipo
STRING
currency_id
Id do Tipo de Moeda do preço
Tipo
STRING
title
Título do anúncio
Tipo
STRING
price
Preço do anúncio
Tipo
NUMERICO
stock
Estoque disponível do anúncio da pergunta
Tipo
STRING
thumbnail
Link da miniatura da imagem do anúncio
Tipo
STRING
permalink
Link do anúncio
Tipo
STRING
}
},
unanswered_quantity
Quantidade de perguntas sem responder dentro desta conversação
Tipo
NUMERICO
},
],
orders
[],
filters
[
],
available_orders
[],
available_filters
[],
}
{
seller_id
999999999,
query
"campera",
paging
{
total
765,
offset
0,
limit
10
},
results
[
{
id
"meli-1999994-549991-MLA57599999",
answered_quantity
0,
status
"unanswered",
last_question_date
"2015-09-15T10:47:07.000Z",
store_id
15999999999,
channel
"meli",
main_question
{
creation_date
"2015-09-15T10:47:13.000Z",
id
349999999999,
status
"unanswered",
store_id
15999999999,
from
{
nickname
"CAXXXXXX1",
name
"Fulano Mengano",
meli_cust_id
50000000,
client_id
399999990
},
question
{
text
"Hola, como va? Te queria preguntar si tenes en stock? Muchas gracias",
date
"2015-09-15T10:47:07.000Z"
},
type
"item",
thread_id
"meli-15999999-599-MLA57599999",
channel
"meli",
publication
{
id
"MLA9999999",
currency_id
"ARS",
title
"Producto a la Venta ",
price
1695,
stock
10,
thumbnail
"http://mla-s2-p.mlstatic.com/18288-ML99999999991_082014-I.jpg",
permalink
"http://articulo.mercadolibre.com.ar/MLA999999-99fred-gold-_JM",
}
},
unanswered_quantity
1
},
],
orders
[],
filters
[
],
available_orders
[
{
id
"last_question_date_asc",
name
"Order by question date ascending"
},
{
id
"last_question_date_desc",
name
"Order by question date descending"
}
],
available_filters
[
{
id
"status",
name
"Status",
values
[]
},
{
id
"channel",
name
"Channel",
values
[]
}
],
}