Documentação do Mercado Livre

Confira todas as informações necessárias sobre as APIs Mercado Livre.
circulos azuis em degrade

Documentação do

Última atualização em 10/07/2026

Mensagens bloqueadas

Lembre-se que moderamos os links encurtados com as seguintes ferramentas:

  • Bitly
  • Bl.ink
  • Polr
  • Rebrandly
  • T2M
  • TinyURL
  • URL Shortener by Zapier
  • Yourls

Consultar mensagens bloqueadas

Chamada:

curl -X GET -H 'Authorization: Bearer $ACCESS_TOKEN' https://api.mercadolibre.com/messages/packs/$PACK_ID/sellers/$SELLER_ID?tag=post_sale

Exemplo:

curl -X GET -H 'Authorization: Bearer $ACCESS_TOKEN' https://api.mercadolibre.com/messages/packs/22175467/sellers/32086568493?tag=post_sale

Resposta:

{
    "paging": {
        "limit": 10,
        "offset": 0,
        "total": 4
    },
    "conversation_status": {
        "path": "/packs/22175467/sellers/32086568493",
        "status": "blocked",
        "substatus": "blocked_by_buyer",
        "status_date": "2020-01-10T19:58:04.317Z",
        "status_update_allowed": false,
        "claim_ids": null,
        "shipping_id": null
    },
    "messages": [...]
}

Campos da resposta

status

Este campo aceita dois valores:

  • active: a conversa está aberta para enviar/receber mensagens
  • blocked: a conversa está fechada para enviar/receber mensagens

substatus

Motivos pelos quais bloqueamos determinadas mensagens pós-venda para melhorar a experiência do comprador:

Substatus Descrição
blocked_by_time O vendedor poderá responder desde que não tenham se passado 30 dias desde a última mensagem. O prazo para receber mensagens expirou e só será reaberto se o comprador assim decidir.
blocked_by_buyer O comprador decide bloquear o recebimento de mensagens.
blocked_by_mediation Existe uma mediação em andamento entre o comprador e o vendedor.
blocked_by_fulfillment Por ser uma venda com Fulfillment, a mensageria estará disponível quando o pacote for entregue (status de envio: delivered).
blocked_by_payment O pagamento ainda não foi realizado ou ainda não foi processado. Uma ordem não se encontra paga quando tem algum dos status: payment_required, payment_in_process ou partially_paid. Este bloqueio é temporário até que o pagamento seja realizado.
blocked_by_conversation_initiated_by_seller A compra na totalidade é de produtos de Supermercado e o vendedor inicia a conversa. Aplica na Argentina, México e Brasil. Quando o comprador iniciar a conversa, a mensageria do vendedor não será bloqueada.
blocked_by_conversation_use_message_api O vendedor tenta se comunicar através de action-guide quando o comprador já iniciou a conversa.
blocked_by_conversation_initiated_by_seller_limited Este bloqueio se aplica para vendas com Mercado Envios 2. Você deverá utilizar o recurso Motivos para se comunicar. Quando o assistente de IA iniciar a conversa, a mensageria do vendedor não será bloqueada.
blocked_by_cancelled_order Não pode se comunicar, pois a venda está cancelada.
blocked_by_cancelled_order_by_fraud Não pode se comunicar, porque a venda está cancelada por comportamentos irregulares. As mensagens não estarão disponíveis por ponto de risco.
blocked_by_mediation_fbm O vendedor não pode se comunicar porque existe uma mediação em andamento em uma venda Fulfillment.
blocked_by_conversation_expired A mensageria fica bloqueada e não são retornadas as mensagens quando o ML detecta que se passaram 18 meses desde a data da compra.
blocked_by_refund O vendedor não pode se comunicar com o comprador, pois foi realizado um reembolso parcial ou total sobre a ordem. Só será reaberto se o comprador enviar uma nova mensagem.
blocked_by_claim_change_closed A mensageria de reclamação se encontra bloqueada porque existe uma troca de produto em andamento associada à ordem.
blocked_by_deactivated_account A mensageria se encontra bloqueada porque o comprador ou vendedor excluiu sua conta.
blocked_by_restrictions A mensageria se encontra bloqueada porque existe uma restrição sobre o vendedor ou comprador.
blocked_by_cancelled_order_hidden Não pode se comunicar, pois a compra/venda não conseguiu ser processada e foi cancelada. A ordem só será visível para o comprador.
blocked_by_claim_change_open A mensageria se encontra bloqueada porque existe uma troca de produto em andamento associada à ordem.
blocked_by_message_pending_review O vendedor não pode se comunicar com o comprador porque a conversa se encontra sob revisão. Poderá fazê-lo após a revisão das mensagens.
blocked_by_return_to_buyer_fulfillment A mensageria se encontra bloqueada para os casos onde, após a revisão de triagem em fulfillment, decide-se devolver o produto ao comprador por descumprimento das políticas de devolução.
blocked_by_ai_assistant A mensageria com o comprador está desabilitada porque é uma venda Fulfillment e o assistente de IA está ativado.
blocked_by_ai_assistant_expired A mensageria com o assistente de IA se encontra expirada.
blocked_by_ai_assistant_contact_closed A mensageria com o assistente de IA se encontra fechada por consulta finalizada.
block_by_ai_assistant_initiated_by_seller_expired A mensageria iniciada pelo vendedor com o assistente de IA expirou.
blocked_by_resale A mensageria se encontra desabilitada porque na venda há pelo menos um produto de revenda.
blocked_by_proximity_groceries A mensageria se encontra desabilitada porque a venda corresponde a uma compra de supermercado com entrega imediata (Proximity).

status_date

É a data quando o status da conversa foi atualizado.


Voltar: Gestão de mensagens.