Mercado Libre - Obtener Mensajes

Descripcion

Este modulo permite consultar los mensajes de conversaciones post-venta con compradores, ya sea de una orden especifica o listar conversaciones recientes.

Configuracion

Credenciales

Este modulo requiere credenciales de tipo Mercado Libre (OAuth) con los siguientes campos:

Campo	Descripcion
access_token	Token de acceso OAuth valido

Parametros

Campo	Tipo	Requerido	Descripcion
credentials_id	string	Si	ID de las credenciales
pack_id	string	No	ID del pack/carrito
order_id	string	No	ID de la orden
user_id	string	No	ID del usuario
role	string	No	seller o buyer
status	string	No	unread, unanswered
tag	string	No	post_sale, pre_sale
limit	number	No	Mensajes por pagina
offset	number	No	Desplazamiento

Estados de Mensaje

Valor	Descripcion
unread	No leidos
unanswered	Sin responder

Tags de Conversacion

Valor	Descripcion
post_sale	Mensajes post-venta
pre_sale	Preguntas pre-venta

Salida

{
  "success": true,
  "messages": [
    {
      "id": "abc123",
      "from": {
        "user_id": 123456789,
        "role": "buyer"
      },
      "to": {
        "user_id": 987654321,
        "role": "seller"
      },
      "text": "Hola, cuando llega mi pedido?",
      "date_created": "2024-01-15T10:30:00.000-03:00",
      "status": "unread"
    }
  ],
  "pack_id": "2000001234567890",
  "conversation_status": {...},
  "message": "5 mensajes obtenidos"
}

Ejemplo de Uso

Mensajes de una orden

{
  "credentials_id": "meli_cuenta",
  "order_id": "2000001234567890"
}

Mensajes de un pack

{
  "credentials_id": "meli_cuenta",
  "pack_id": "2000001234567890"
}

Mensajes sin leer

{
  "credentials_id": "meli_cuenta",
  "status": "unread"
}

Mensajes sin responder

{
  "credentials_id": "meli_cuenta",
  "status": "unanswered",
  "role": "seller"
}

Conversaciones post-venta

{
  "credentials_id": "meli_cuenta",
  "tag": "post_sale",
  "limit": 50
}

Campos del Mensaje

Campo	Descripcion
id	ID unico del mensaje
from	Remitente (user_id, role)
to	Destinatario
text	Contenido del mensaje
date_created	Fecha de envio
status	Estado (read, unread)
attachments	Archivos adjuntos

Workflows de Ejemplo

Respuesta automatica

[Webhook mensaje] -> [MeliGetMessages] -> [Clasificar] -> [MeliSendMessage respuesta]

Monitor de mensajes

[Schedule c/5min] -> [MeliGetMessages unread] -> [Alerta si hay pendientes]

Analisis de conversaciones

[MeliGetMessages order] -> [Analizar sentimiento] -> [Clasificar satisfaccion]

Uso con ExecuteScript

// Clasificar mensajes por urgencia
const mensajes = ctx.data.messages;

const clasificados = {
  urgente: [],
  normal: [],
  resuelto: []
};

const palabrasUrgentes = ['urgente', 'problema', 'reclamo', 'devolucion', 'reembolso'];

mensajes.forEach(m => {
  const texto = m.text.toLowerCase();

  if (palabrasUrgentes.some(p => texto.includes(p))) {
    clasificados.urgente.push(m);
  } else if (m.status === 'unread') {
    clasificados.normal.push(m);
  } else {
    clasificados.resuelto.push(m);
  }
});

ctx.data = {
  total_mensajes: mensajes.length,
  urgentes: clasificados.urgente.length,
  pendientes: clasificados.normal.length,
  resueltos: clasificados.resuelto.length,
  mensajes_urgentes: clasificados.urgente
};

API Utilizada

• API: Mercado Libre Messaging API
• Endpoint: GET /messages/packs/{pack_id}/sellers/{user_id}
• Documentacion: https://developers.mercadolibre.com/

Notas

• Los mensajes estan vinculados a ordenes o packs
• El tiempo de respuesta afecta metricas de atencion
• Los mensajes pueden incluir archivos adjuntos
• El historial de conversacion es importante para reclamos
• Los mensajes eliminados no se pueden recuperar

Nodos Relacionados

• MeliSendMessage - Enviar mensajes a compradores
• MeliGetOrders - Obtener ordenes asociadas a mensajes
• MeliGetUser - Obtener datos del comprador