Mensagems pendentes
→Mensagens ainda não lidas
→Mensagens de leitura pendente filtradas por resource
↳Modos de uso
→Marcar mensagens como lidas
Mensagens ainda não lidas
Esta opção vai lhe permitir obter as mensagens ainda não lidas no Mercado Livre de todas as ordens existentes ou somente daquelas especificadas. Além disso, você também vai poder definir o role (função) de usuário para cada caso, comprador ou vendedor. Para obter essas informações, você terá que realizar o GET abaixo.
Lembre-se de que ao verificar /messages/packs/pack_id/sellers/seller_id as mensagens serão marcadas como lidas. Caso não queira marcá-los como lidos, execute o GET com o parâmetro mark_as_read = false e a consulta será: /messages/packs/pack_id/sellers/seller_id?mark_as_read=false.
Chamada:
curl -X GET -H 'Authorization: Bearer $ACCESS_TOKEN' https://api.mercadolibre.com/messages/unread
parâmetro opcional
-“role”: “buyer”/”seller”
Erros
Status | Erro | Mensagem |
---|---|---|
400 | Messages id empty or invalid | IDs de mensagem inválidos ou vazios |
400 | The specified message id: a does not exists | ID de mensagem inexistente |
400 | Not allowed messages from multiple orders | ID de mensagem correspondendo a pedidos diferentes |
404 | The message with id: a could not be retrieved from storage | Mensagem não encontrada no servidor, tente novamente em alguns segundos |
Mensagens de leitura pendente filtradas por resource
Chamada:
curl -X GET -H 'Authorization: Bearer $ACCESS_TOKEN' https://api.mercadolibre.com/messages/unread/$RESOURCE
Exemplo:
curl -X GET -H 'Authorization: Bearer $ACCESS_TOKEN' https://api.mercadolibre.com/messages/unread/packs/1234/sellers/2345
Resposta:
{
"user_id":2345,
"results":[
{
"resource":"/packs/1234/sellers/2345",
"count":1
}
]
}
Modos de uso
Caso você queira obter todas as ordens com mensagens ainda não lidas como vendedor, deverá realizar a chamada abaixo:
curl -x GET -H 'Authorization: Bearer $ACCESS_TOKEN' https://api.mercadolibre.com/messages/unread?role=$ROLE
Os valores possíveis para ROLE são “buyer” ou “seller”.
Resposta:
Se a resposta da API for satisfatória, retornará um JSON similar ao seguinte:
{
"user_id":378136913,
"results":[
{
"resource":"/packs/1977056109/sellers/378136913",
"count":1
}
]
}
Nessa resposta você verá:
- ID do usuário que realizou a solicitação (“user_id”).
- Mensagens ainda não lidas (“count”).
- Cada ordem disponível (“order_id”).
Por último, se não houver mensagens ainda não lidas, a resposta será similar à seguinte:
{
"user_id": "1234512314",
"results": []
}
Marcar mensagens como lidas
Com o seguinte GET, você pode marcar as mensagens como lidas.
Chamada:
curl -X PUT -H 'Authorization: Bearer $ACCESS_TOKEN' https://api.mercadolibre.com/messages/packs/$PACK_ID/sellers/$SELLER_ID
Exemplo:
curl -X GET -H 'Authorization: Bearer $ACCESS_TOKEN' https://api.mercadolibre.com/messages/packs/2000000089077943/sellers/415458330
Resposta:
{
"paging": {
"limit": 2,
"offset": 1,
"total": 31
},
"conversation_status": {
"path": "/packs/2000000089077943/seller/415458330",
"status": "active",
"substatus": null,
"status_date": "2019-04-08T16:36:30.000Z",
"status_update_allowed": false,
"claim_id": null,
"shipping_id": null
},
"messages": [
{
"id": "2c92808469fea23a0169febf14580001",
"site_id": "MLA",
"client_id": 123,
"from": {
"user_id": "415458330",
"email": "test_user_83388960@testuser.com",
"name": "Juan Pablo Robledo"
},
"status": "IN_MODERATION",
"text": "Test message ToUserId",
"message_date": {
"received": "2019-04-08T20:58:49.000Z",
"available": null,
"notified": null,
"created": "2019-04-08T20:58:49.000Z",
"read": "2019-04-08T20:58:52.000Z"
},
"message_moderation": {
"status": "NON_MODERATED",
"reason": "none",
"by": "none",
"moderation_date": null
},
"message_attachments": [
{
"filename": "415460047_a96d8dea-38cd-4402-938e-80a1c134fc5d.pdf",
"original_filename": "Ayuda-Memoria-Arduino-ELINSI.pdf",
"type": "application/octet-stream",
"size": 225677,
"potential_security_threat": false,
"creation_date": "2019-04-08T20:58:49.000Z"
}
],
"message_resources": [
{
"id": "2000000089077943",
"name": "packs"
},
{
"id": "415458330",
"name": "seller"
}
]
},
{
"id": "2c92808469fea23a0169febdb0570000",
"site_id": "MLA",
"client_id": 123,
"from": {
"user_id": "415458330",
"email": "test_user_83388960@testuser.com",
"name": "Juan Pablo Robledo"
},
"status": "IN_MODERATION",
"text": "Test message ToUserId",
"message_date": {
"received": "2019-04-08T20:57:18.000Z",
"available": null,
"notified": null,
"created": "2019-04-08T20:57:18.000Z",
"read": "2019-04-08T20:57:22.000Z"
},
"message_moderation": {
"status": "NON_MODERATED",
"reason": "none",
"by": "none",
"moderation_date": null
},
"message_attachments": [
{
"filename": "415460047_a96d8dea-38cd-4402-938e-80a1c134fc5d.pdf",
"original_filename": "Ayuda-Memoria-Arduino-ELINSI.pdf",
"type": "application/octet-stream",
"size": 225677,
"potential_security_threat": false,
"creation_date": "2019-04-08T20:57:19.000Z"
}
],
"message_resources": [
{
"id": "2000000089077943",
"name": "packs"
},
{
"id": "415458330",
"name": "seller"
}
]
}
]
}
Seguinte: Mensagens bloqueadas.