Mercado Libre - Enviar Mensaje

Descripcion

Este modulo permite enviar mensajes post-venta a compradores, ya sea para dar seguimiento a una orden, responder consultas o proporcionar informacion adicional.

Configuracion

Credenciales

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

Campo	Descripcion
access_token	Token de acceso OAuth con permisos de escritura

Parametros

Campo	Tipo	Requerido	Descripcion
credentials_id	string	Si	ID de las credenciales
pack_id	string	Condicional	ID del pack/carrito
order_id	string	Condicional	ID de la orden (alternativo)
text	string	Si	Texto del mensaje
attachments	array	No	URLs de archivos adjuntos

Se requiere pack_id O order_id

Salida

{
  "success": true,
  "message_sent": {
    "id": "msg_123456789",
    "text": "Hola! Tu pedido ya fue despachado...",
    "date_created": "2024-01-15T10:35:00.000-03:00",
    "status": "sent"
  },
  "message_id": "msg_123456789",
  "pack_id": "2000001234567890",
  "message": "Mensaje enviado correctamente"
}

Ejemplo de Uso

Mensaje de seguimiento

{
  "credentials_id": "meli_cuenta",
  "order_id": "2000001234567890",
  "text": "Hola! Tu pedido ya fue despachado. El numero de seguimiento es ABC123. Gracias por tu compra!"
}

Mensaje a pack/carrito

{
  "credentials_id": "meli_cuenta",
  "pack_id": "2000001234567890",
  "text": "Buenos dias! Queremos confirmar que recibiste el pedido en buenas condiciones. Todo OK?"
}

Mensaje con informacion de entrega

{
  "credentials_id": "meli_cuenta",
  "order_id": "2000001234567890",
  "text": "Tu pedido esta en camino y llegara manana entre las 9:00 y 18:00. El repartidor te llamara antes de llegar."
}

Solicitar calificacion

{
  "credentials_id": "meli_cuenta",
  "order_id": "2000001234567890",
  "text": "Esperamos que disfrutes tu compra! Si todo llego bien, te agradeceriamos una calificacion positiva. Gracias!"
}

Mensaje de disculpa

{
  "credentials_id": "meli_cuenta",
  "order_id": "2000001234567890",
  "text": "Lamentamos la demora en la entrega. Estamos haciendo seguimiento con el correo. Te mantendremos informado."
}

Workflows de Ejemplo

Notificacion automatica de envio

[Envio despachado] -> [Obtener tracking] -> [MeliSendMessage] -> [Log]

Seguimiento post-entrega

[Envio entregado] -> [Esperar 2 dias] -> [MeliSendMessage pedir review]

Respuesta a consulta

[Mensaje recibido] -> [IA generar respuesta] -> [MeliSendMessage]

Alerta de problema

[Detectar incidencia] -> [MeliSendMessage disculpa] -> [Notificar equipo]

Uso con ExecuteScript

// Generar mensaje de seguimiento personalizado
const orden = ctx.data.order;
const envio = ctx.data.shipment;

let mensaje = `Hola ${orden.buyer.first_name || ''}! `;

switch (envio.status) {
  case 'ready_to_ship':
    mensaje += 'Tu pedido esta listo y sera despachado hoy. ';
    break;
  case 'shipped':
    mensaje += `Tu pedido ya esta en camino. `;
    if (envio.tracking_number) {
      mensaje += `Numero de seguimiento: ${envio.tracking_number}. `;
    }
    break;
  case 'delivered':
    mensaje += 'Tu pedido fue entregado! Esperamos que lo disfrutes. ';
    mensaje += 'Si todo llego bien, te agradeceriamos una calificacion positiva. ';
    break;
}

mensaje += 'Gracias por tu compra!';

ctx.data = {
  order_id: orden.id,
  text: mensaje
};

// Respuesta automatica a consulta comun
const mensajeRecibido = ctx.data.message;
const texto = mensajeRecibido.text.toLowerCase();

let respuesta = '';

if (texto.includes('cuando llega') || texto.includes('demora')) {
  respuesta = 'El envio esta en camino y llegara en los proximos 2-3 dias habiles. Podes seguirlo desde "Mis compras". Saludos!';
} else if (texto.includes('devolucion') || texto.includes('cambio')) {
  respuesta = 'Para devoluciones o cambios, inicia el reclamo desde "Mis compras" en MercadoLibre. Responderemos a la brevedad. Saludos!';
} else if (texto.includes('factura')) {
  respuesta = 'La factura se envia por email dentro de las 24hs posteriores a la compra. Revisa tu casilla de spam. Saludos!';
} else {
  respuesta = 'Gracias por tu mensaje. Te responderemos a la brevedad. Saludos!';
}

ctx.data = {
  pack_id: mensajeRecibido.pack_id,
  text: respuesta
};

Buenas Practicas

Que HACER

• Responder rapido (menos de 24 horas)
• Ser claro y conciso
• Incluir informacion util (tracking, fechas)
• Mantener tono profesional y amable
• Personalizar con nombre del comprador

Que NO HACER

• Incluir datos de contacto externos
• Mencionar otras plataformas
• Enviar mensajes masivos/spam
• Usar lenguaje agresivo
• Ignorar consultas o reclamos

Errores Comunes

Error	Causa	Solucion
”Order not found”	Orden incorrecta	Verificar order_id
”Pack not found”	Pack incorrecto	Verificar pack_id
”Empty message”	Texto vacio	Incluir texto del mensaje
”Forbidden content”	Contenido prohibido	Eliminar datos de contacto
”Message limit exceeded”	Demasiados mensajes	Esperar antes de enviar mas

API Utilizada

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

Notas

• Los mensajes quedan registrados en el historial de la orden
• No se pueden editar o eliminar mensajes enviados
• El tiempo de respuesta afecta metricas de atencion al cliente
• Incluir datos de contacto externo puede resultar en penalizaciones
• Los mensajes son visibles para Mercado Libre en caso de mediacion

Nodos Relacionados

• MeliGetMessages - Obtener mensajes de conversaciones
• MeliGetOrders - Obtener ordenes para enviar mensajes
• MeliGetShipment - Obtener informacion de envio para incluir en el mensaje