Gestiona preguntas y respuestas

Las preguntas son la forma en que los compradores pueden comunicarse con los vendedores en la página Detalles del artículo antes de realizar una transacción y, por lo tanto, la forma en que manejes la interacción en esta etapa será decisiva para realizar una venta exitosa.

Contenidos:

Buscar preguntas

Existen varias formas de buscar preguntas.

Preguntas recibidas por un vendedor

curl -X GET -H "Content-Type: application/json" 'https://api.mercadolibre.com/questions/search?seller_id={Seller_id}&access_token=$ACCESS_TOKEN'

Preguntas recibidas respecto de un artículo

curl -X GET -H "Content-Type: application/json" 'https://api.mercadolibre.com/questions/search?item={Item_id}'

Preguntas realizadas por un usuario respecto de un artículo

curl -X GET -H "Content-Type: application/json" 'https://api.mercadolibre.com/questions/search?item={Item_id}&from={Cust_id}'

Preguntas por id

curl -X GET -H "Content-Type: application/json" 'https://api.mercadolibre.com/questions/{question_id}?access_token=$ACCESS_TOKEN'

Nota: Ten en cuenta que si consultas sin access token y el estado de la pregunta es DELETED o BANNED obtendrás “question not found” .



Analicemos los atributos que encontraremos en el recurso de Buscar Preguntas.

Descripción de atributos

id
ID de la pregunta.
date_created
Fecha de creación.
item_id
ID del artículo al cual pertenece la pregunta.
seller_id
ID del vendedor del artículo.
status
Estado de la pregunta. Valores posibles:
Atributos
unanswered
La pregunta aún no fue respondida.
answered
La pregunta fue respondida.
closed_unanswered
El artículo está cerrado y la pregunta nunca fue respondida.
under_review
El artículo está en revisión y la pregunta también.
text
Texto de la pregunta.
answer
Respuesta del vendedor a la pregunta.
Atributos
date_created
Fecha de creación.
status
Estado de la respuesta. Valores posibles:
Atributos
active
La respuesta está activa.
disabled
La respuesta fue deshabilitada.
text
Texto de la respuesta.


¡Excelente! Ahora conoces qué aspectos debes tener en cuenta sobre las preguntas. Consulta las acciones disponibles conforme a la búsqueda de preguntas.

Métodos permitidos

GET /questions/:id
Devuelve una pregunta con ese ID.
POST /questions
Crea una pregunta sobre un artículo.
DELETE /questions/:id
Elimina una pregunta.
POST /answers/
PUBLICA una respuesta a una pregunta determinada.
POST /my/questions/hidden
Oculta preguntas.
Como ves, puedes buscar preguntas por artículo, vendedor y usuario que la formuló y filtrarlas por estado o período. Si lo deseas, también puedes buscar todas las preguntas recibidas y ocultarlas.

Recursos y conexiones relacionados

Utiliza los siguientes recursos para buscar preguntas por artículo o por usuario. Deberás incluir el item_id o el cust:id.

"related_resources": [
    	"/items",
        "/users"
	],
	"connections": {
    	"item_id": "/items/:id",
    	"seller_id": "/users/:id"
	}
}


Veamos algunos ejemplos de cómo buscar preguntas en nuestra plataforma.

Formular preguntas

Es una tarea muy fácil. Solo debes conocer el item_id y enviarlo junto con un String de texto en el cuerpo del JSON como en el siguiente ejemplo:

curl -i -X POST -H "Content-Type: application/json" -d
'{
   "text":"Do you have these shoes in red?",
   "item_id":"MLA123456"
}'

https://api.mercadolibre.com/questions/{Item_Id}?access_token=$ACCESS_TOKEN

Responder preguntas

Cuando tienes gran cantidad de artículos publicados en Mercado Libre, es probable que recibas muchas preguntas; por eso, te recomendamos que desarrolles un método para responder esas preguntas de un modo semiautomático, en el cual los operadores reciben respuestas sugerencias en base a palabras clave frecuentemente recibidas.
Para hacerlo, debes saber cómo responder una pregunta por API. Esto será fácil.

Primero, veamos todas las preguntas recibidas para tu artículo. Simplemente, realiza una búsqueda de preguntas por artículo como muestra el ejemplo:

curl 'https://api.mercadolibre.com/questions/search?item_id=ITEM_ID&access_token=XXXX'

Verás que las preguntas tienen un estado, por eso es probable que debas mantenerlas en el estado “unanswered”.

Ahora, respondamos una sola pregunta:

curl -i -X POST -H "Content-Type: application/json" -d
'{
   	question_id: QUESTION_ID,
   	text:"Some text here..."
}'

https://api.mercadolibre.com/answers?access_token=XXXX

Al trabajar con preguntas, es muy útil escuchar las Notificaciones, porque te permiten tener un feed en tiempo real de los eventos que se producen con relación a las mismas. Conoce cómo trabajar con Notificaciones.

Eliminar preguntas

Si necesitas eliminar una pregunta que realizó un usuario sobre tu artículo, simplemente utiliza el método ELIMINAR con el ID de pregunta y el access token del usuario.

Ejemplo:

curl -X DELETE 'https://api.mercadolibre.com/questions/${question_id}?access_token=$ACCESS_TOKEN'

Eliminar con nuestros SDK (ejemplo)

Respuesta:

[
  "Question deleted."
]

Lista negra de preguntas

Administrar la lista negra de preguntas te permite bloquear usuarios para evitar que pregunten sobre tus artículos. Más tarde, puedes eliminarlos de la lista negra para permitir preguntas.

La lista negra está basada en el usuario y el vendedor tiene pleno control sobre la lista de usuarios que la integran. Veamos algunos ejemplos de lo que puedes hacer con ella.

Enviar usuarios a la lista negra de preguntas

curl -X POST -H "Content-Type: application/json" -d
'{
  "user_id": blocked user id
}'
https://api.mercadolibre.com/users/$SELLER_ID/questions_blacklist?access_token=$ACCESS_TOKEN

Ver la lista negra

curl -X GET 'https://api.mercadolibre.com/users/$SELLER_ID/questions_blacklist?access_token=$ACCESS_TOKEN '

Eliminar a un usuario de la lista negra

curl -X DELETE 'https://api.mercadolibre.com/users/$SELLER_ID/questions_blacklist/$USER_ID?access_token=$ACCESS_TOKEN'

Prefecto, ahora sabes todo lo necesario sobre nuestra lista negra de preguntas. Esperamos que te sea útil, si fuese necesario.

Cómo tomar conocimiento de una pregunta

Una pregunta sobre un artículo es un evento que se produce del lado de Mercado Libre, por eso deberás suscribirte a nuestro feed de preguntas para tomar conocimiento en tiempo real cuando ese evento ocurre.
En primer lugar, debemos configurar nuestra aplicación para poder recibir notificaciones. Esto se puede realizar al suscribir tu aplicación a notificaciones de preguntas. Dirígete a nuestro Administrador de Aplicaciones y edita las Configuraciones de Notificaciones de tu aplicación. Para más información sobre crear y configurar una nueva aplicación, por favor consulta este link.
Debes seleccionar un Callback URL: configura el URL público del dominio donde deseas recibir todas las notificaciones de Mercado Libre. Por ejemplo: “http://backend.soleorigami.com/notification”.
También debes especificar qué “topic” [tema] consignarás; en este caso, debe seleccionar preguntas.
Esta configuración te permite interactuar con las notificaciones de Mercado Libre. Todos los eventos relativos a nuevas preguntas serán notificados a tu Callback URL.

Recibir una Notificación

Mercado Libre te enviará notificaciones a través de un mensaje POST con información en el cuerpo de artículo. El atributo más importante del mensaje es el user_id, que está relacionado con la notificación, y el segundo en importancia es el recurso. El recurso es el elemento que fue actualizado o creado.

{
  "user_id": 1234,
  "resource": "/questions/139876",
  "topic": "questions",
  "received": "2011-10-19T16:38:34.425Z",
  "sent" : "2011-10-19T16:40:34.425Z",
}

Después de recibir la notificación, debes enviar un acuse de recibo [acknowledgment] (ACK 200) a Mercado Libre para dejar de recibirla.
Para más información, consulta nuestro tutorial de Notificaciones.

Referencia de códigos de error

Error_codeMensaje de errorDescripciónPosible solución
invalid_questionLa pregunta es inválidaNo se puede responder la pregunta.El parámetro question_id debe ser un número entero. (Para buscar tu pregunta, llama a resource/questions/search [recurso/preguntas/búsqueda]).
invalid_post_bodyJSON inválido. Los atributos válidos son: {0}.Parámetros inválidos.Los parámetros esperados son question_id y text.



Siguiente:
Gestiona ventas.

Por favor califica del 1 al 5