Mercado Libre - Get Questions

Description

This module allows querying questions that buyers ask about your products, with filters by status, item, and more.

Configuration

Credentials

This module requires Mercado Libre (OAuth) credentials with the following fields:

Field	Description
access_token	Valid OAuth access token

Parameters

Field	Type	Required	Description
credentials_id	string	Yes	Credentials ID
question_id	string	No	Specific question ID
item_id	string	No	Filter by item
seller_id	string	No	Seller ID
status	string	No	Question status
unanswered_only	boolean	No	Only unanswered
sort	string	No	Sort field
sort_type	string	No	DESC or ASC
limit	number	No	Questions per page
offset	number	No	Offset

Question Statuses

Value	Description
UNANSWERED	Unanswered
ANSWERED	Answered
CLOSED_UNANSWERED	Closed unanswered
UNDER_REVIEW	Under review

Output

{
  "success": true,
  "questions": [
    {
      "id": 123456789,
      "text": "Tienen stock disponible?",
      "status": "UNANSWERED",
      "date_created": "2024-01-15T10:30:00.000-03:00",
      "item_id": "MLA123456789",
      "from": {
        "id": 987654321,
        "nickname": "COMPRADOR123"
      },
      "answer": null
    }
  ],
  "total": 15,
  "limit": 50,
  "offset": 0,
  "message": "15 questions retrieved"
}

Usage Example

Get question by ID

{
  "credentials_id": "meli_cuenta",
  "question_id": "123456789"
}

Unanswered questions

{
  "credentials_id": "meli_cuenta",
  "unanswered_only": true
}

Questions for an item

{
  "credentials_id": "meli_cuenta",
  "item_id": "MLA123456789",
  "status": "UNANSWERED"
}

All recent questions

{
  "credentials_id": "meli_cuenta",
  "sort": "date_created",
  "sort_type": "DESC",
  "limit": 50
}

Answered questions

{
  "credentials_id": "meli_cuenta",
  "status": "ANSWERED",
  "limit": 100
}

Question Fields

Field	Description
id	Unique question ID
text	Question text
status	Current status
date_created	Creation date
item_id	Related item ID
from	Buyer information
answer	Answer (if exists)
deleted_from_listing	If deleted

Example Workflows

Answer questions automatically

[Question webhook] -> [MeliGetQuestions] -> [AI generate response] -> [MeliAnswerQuestion]

Question monitor

[Schedule every 5min] -> [MeliGetQuestions unanswered] -> [Alert if pending]

Question analysis

[Daily schedule] -> [MeliGetQuestions] -> [Classify by topic] -> [Report]

Usage with ExecuteScript

// Analyze pending questions
const preguntas = ctx.data.questions;

// Classify by query type
const clasificacion = {
  stock: [],
  envio: [],
  precio: [],
  otro: []
};

preguntas.forEach(p => {
  const texto = p.text.toLowerCase();
  if (texto.includes('stock') || texto.includes('disponible')) {
    clasificacion.stock.push(p);
  } else if (texto.includes('envio') || texto.includes('demora')) {
    clasificacion.envio.push(p);
  } else if (texto.includes('precio') || texto.includes('descuento') || texto.includes('oferta')) {
    clasificacion.precio.push(p);
  } else {
    clasificacion.otro.push(p);
  }
});

ctx.data = {
  total: preguntas.length,
  sobre_stock: clasificacion.stock.length,
  sobre_envio: clasificacion.envio.length,
  sobre_precio: clasificacion.precio.length,
  otras: clasificacion.otro.length,
  preguntas_clasificadas: clasificacion
};

API Used

• API: Mercado Libre Questions API
• Endpoint: GET /questions/search, GET /questions/{id}
• Documentation: https://developers.mercadolibre.com/

Notes

• Unanswered questions affect reputation
• Response time is a ranking factor
• Deleted or spam questions have a special status
• It is recommended to respond in less than 1 hour
• Mercado Libre may remove questions that violate policies

Related Nodes

• MeliAnswerQuestion - Answer pending questions
• MeliGetItems - Get queried item information
• MeliGetUser - Get data of the user who asked