Saltar al contenido
memberarea memberarea.io

Leer el registro de webhooks de Shopify

Lea cada entrega que envió su tienda, entienda qué hizo su memberarea con ella y vuelva a ejecutar una que haya fallado.

En este artículo

Cuando ocurre algo en su tienda, Shopify envía un mensaje al respecto a su memberarea. Cada uno de esos mensajes es una entrega, y cada entrega se registra con su resultado, haya funcionado o no. El registro de webhooks es el lugar donde mirar cuando un comprador dice que le falta su curso o cuando quiere saber qué hizo realmente un reembolso o un cambio de producto.

Abrir el registro

Abra su página de Shopify en /admin/settings/integrations/shopify, o abra Configuraciones, después Integraciones, después Añadir integración y Shopify. Después elija la pestaña Registro de webhooks. El registro sigue siendo legible mientras la tienda está desconectada, así que puede seguir consultando lo que llegó antes.

Hasta que llega la primera entrega, la pestaña dice "Todavía no se han recibido webhooks. Haz un pedido de prueba en tu tienda para comprobar la conexión." Un pedido de prueba es la forma más rápida de ver la primera fila.

Qué muestra una fila

La lista no tiene encabezados de columna. Cada entrega es una fila:

Dónde Qué muestra
Línea superior El tema, que nombra lo que ocurrió en la tienda.
Línea de debajo Una nota breve sobre lo que hizo su memberarea con la entrega. Si falló, en su lugar aparece el error.
Bajo la nota La fecha y la hora en que se recibió la entrega.
Insignia a la derecha El resultado: Procesado, Ignorado, Aún no procesado, Reintentando o Fallida.
Botón al lado Volver a procesar, solo en las filas que se pueden volver a ejecutar.
El Registro de webhooks muestra entregas con los resultados Procesado, Ignorado, Reintentando y Fallida, cada una con su nota y su hora.
El Registro de webhooks muestra entregas con los resultados Procesado, Ignorado, Reintentando y Fallida, cada una con su nota y su hora.

Haga clic en una fila para abrir sus detalles. Muestran lo que la entrega llevaba de Número de pedido, Correo electrónico, Total, Moneda e ID de Shopify, siempre el número de Intentos y el error completo si lo hubo. Haga clic de nuevo en la fila para cerrarla.

Los temas que verá son orders/paid, orders/cancelled, refunds/create, customers/create, customers/update, customers/delete, products/update, products/delete y app/uninstalled. Los tres temas de privacidad de Shopify, customers/data_request, customers/redact y shop/redact, también llegan aquí.

Los cinco resultados

Procesado significa que su memberarea hizo el trabajo. Para un pedido pagado, la nota dice algo como "Order SHP-1042 imported, 1 mapped item(s)." y el comprador tiene el acceso asignado. Un pedido pagado de un producto que nadie asignó también se procesa: la nota dice "Order SHP-1042 imported, no mapped item." El pedido existe, cuenta en sus ingresos y el comprador se convierte en miembro sin ningún acceso. Esto incluye también los productos físicos que vende junto a sus cursos.

Ignorado significa que la entrega se entendió y no había nada que hacer. La nota dice por qué, por ejemplo "This product is not mapped." para un cambio de un producto al que no apunta ninguna asignación, o "This update is the echo of our own push." después de que usted mismo enviara un producto a Shopify.

Aún no procesado significa que la entrega llegó y está esperando su turno. Una fila no debería quedarse así más de unos segundos. Si muchas filas siguen en Aún no procesado, algo se ha atascado de nuestro lado. Escriba a support@memberarea.io.

Reintentando significa que la entrega salió mal y está a punto de volver a intentarse sola. La línea de la nota indica el error del último intento.

Fallida significa que algo salió mal y los intentos automáticos se han agotado. La línea de la nota indica el error, y la fila ofrece Volver a procesar.

Las entregas fallidas se vuelven a intentar solas

Una entrega que falla se vuelve a intentar automáticamente unas cuantas veces, con una pausa entre intentos. Mientras esos intentos siguen en curso, la fila muestra Reintentando, y Intentos en los detalles aumenta con cada intento. Solo cuando falla el último intento la fila pasa a Fallida. Una fila en Fallida le necesita: corrija la causa y después vuelva a ejecutarla. El registro de webhooks de la app dentro de su administración de Shopify muestra los mismos estados en inglés, "Retrying" hasta que se agotan los intentos y "Failed" después.

Volver a ejecutar una entrega

Pulse Volver a procesar en la fila. El botón solo aparece en una entrega que falló, se está reintentando o aún no se ha procesado. Una fila que cuenta como procesada o ignorada no lo tiene. La fila vuelve a Aún no procesado y después se procesa con los datos que Shopify envió originalmente, así que volver a ejecutarla después de corregir la causa hace el trabajo completo, no una versión recortada.

Una entrega de reembolso fallida y desplegada muestra su error, el número de intentos y el botón Volver a procesar.
Una entrega de reembolso fallida y desplegada muestra su error, el número de intentos y el botón Volver a procesar.
Nota

Nada se ejecuta dos veces. Si Shopify vuelve a enviar la misma entrega, no recibe una segunda fila. Un pedido pagado que llega dos veces sigue siendo un solo pedido y desbloquea el acceso una vez, y un reembolso que llega dos veces se registra una vez. Pulsar Volver a procesar nunca duplica un pedido, un acceso ni un reembolso.

Filtrar y recorrer el registro

Los botones encima de la lista la limitan a Procesado, Ignorado o Fallida, y Todos lo devuelve todo. Fallida solo lista las entregas cuyos intentos automáticos se han agotado. Las filas en Aún no procesado y Reintentando solo aparecen en Todos. Actualizar vuelve a cargar la página en la que está, así que puede ver cómo entra una entrega nueva.

En una página caben veinticinco entregas, las más nuevas primero. Las entregas más antiguas están en las páginas siguientes, a las que llega debajo de la lista.

Cuando un cliente informa de que le falta un curso, filtre primero por Fallida, después por Ignorado y después mire su fila orders/paid en Procesado. Entre esos tres casi siempre encontrará la respuesta.

Notas que verá en la práctica

Nota Qué significa y qué hacer
"Order SHP-1042 imported, no mapped item." El pedido está aquí, pero su producto no desbloquea nada. Asigne el producto para que los próximos compradores reciban acceso; consulte Vincular un producto de Shopify a un curso.
"This product is not mapped." Cambió en la tienda un producto al que no apunta ninguna asignación. No hay nada que hacer, salvo que quisiera asignarlo.
"This update is the echo of our own push." Shopify devolvió un cambio que hizo su memberarea. No hay nada que hacer.
"This delivery carried no order id or the order was already imported." O la entrega no tenía id de pedido, o el pedido ya está aquí. No hay nada que hacer.
"Refund recorded, the refunded items were not mapped." El reembolso está registrado, pero era de productos que nunca se asignaron, así que no había acceso que retirar.
"The order for this refund has not been imported yet, trying again shortly." El reembolso llegó antes que su pedido. Se vuelve a intentar solo, y mientras tanto la fila muestra Reintentando. Si termina en Fallida, pulse Volver a procesar cuando la fila del pedido muestre Procesado.

Lo que los reembolsos y las cancelaciones hacen con el acceso, el pedido y las comisiones se explica en Reembolsos y cancelaciones en Shopify.

Solo entregas reales de Shopify

Cada entrega tiene que llevar una firma válida de Shopify. Un mensaje sin ella se rechaza y nunca aparece en el registro. Tampoco se acepta una entrega que Shopify desencadenó hace más de siete días. Si falta por completo una fila que esperaba, compruebe que la tienda está conectada; consulte Conectar su tienda Shopify.

Solicitudes de privacidad de Shopify

Shopify transmite las solicitudes de privacidad de los clientes de su tienda, y cada una aparece como una fila.

Cuando un cliente pide a Shopify que elimine sus datos, llega una entrega customers/redact. Su memberarea elimina el vínculo con ese cliente de Shopify y las entregas guardadas sobre él. El miembro, el contacto y sus pedidos se quedan: pertenecen a su espacio de trabajo, y el cliente puede haberle comprado también en otro lugar. La nota dice algo como "Removed 1 link and 4 stored deliveries for Shopify customer 7012345678. The member itself belongs to the workspace and stays." Si también quiere que la persona desaparezca de su memberarea, elimine usted mismo el miembro o el contacto.

Cuando un cliente pide sus datos, llega una entrega customers/data_request y los propietarios de su espacio de trabajo reciben un correo y una notificación con el título "Un cliente de Shopify ha solicitado sus datos". Shopify espera su respuesta en un plazo de 30 días, y su memberarea no envía los datos por usted. Lo demás que ocurre en torno a la privacidad y la desinstalación se explica en Desconectar Shopify y eliminar los datos de la tienda.

Qué se conserva

Cada entrega se guarda con los datos que envió Shopify, para que volver a ejecutarla haga el trabajo completo. Esos datos son de sus clientes, por eso se guardan cifrados. Las entregas se eliminan 90 días después de su llegada.

Artículos relacionados

Last updated on October 25, 2026

¿Le ha resultado útil este artículo?

Artículos relacionados