Crear webhooks

Los webhooks son una herramienta para recuperar y almacenar datos de un evento específico. Permiten registrar una URL https:// donde se pueden almacenar los datos del evento en formatos JSON o XML. Los webhooks se usan comúnmente por las siguientes razones:

  • Realizar un pedido
  • Cambiar el precio de un producto
  • Notificar a tu cliente de mensajería instantánea o a tu buscapersonas cuando estás offline
  • Recopilar datos para un almacén de datos
  • Integrar el software de contabilidad
  • Filtrar los artículos del pedido e informar a varios transportistas sobre el pedido
  • Eliminar datos de clientes de tu base de datos cuando desinstalan tu aplicación

Eventos de webhook compatibles

Puedes seleccionar cualquiera de los eventos de la lista cuando creating a webhook. Por ejemplo, si quieres crear un webhook que se envíe cada vez que se pague un pedido, selecciona Pago de pedido. Otro ejemplo: si quieres crear un webhook que se envíe cada vez que se actualice una propiedad de la tienda, selecciona Actualización de tienda.

Tabla con los eventos de webhook compatibles disponibles en el panel de control de Shopify.
CategoríaEventos
Carrito
  • Creación de carrito
  • Actualización de carrito
Pago
  • Creación de pago
  • Eliminación de pago
  • Actualización de pago
Colección
  • Creación de colección
  • Eliminación de colección
  • Actualización de colección
Cliente
  • Actualización del consentimiento de marketing por SMS del cliente
  • Actualización de la configuración de la cuenta de cliente
  • Creación de cliente
  • Eliminación de cliente
  • Desactivación de cliente
  • Actualización del consentimiento para email marketing del cliente
  • Activación de cliente
  • Creación de grupo de clientes
  • Eliminación de grupo de clientes
  • Actualización de grupo de clientes
  • Etiquetas de cliente agregadas
  • Etiquetas de cliente eliminadas
  • Actualización de cliente
Descuento
  • Creación de descuento
  • Eliminación de descuento
  • Actualización de descuento
Pedido preliminar
  • Creación de pedido preliminar
  • Eliminación de pedido preliminar
  • Actualización de pedido preliminar
Preparación de pedidos
  • Creación de la preparación de pedido
  • La orden de preparación de pedido no puede completarse por el servicio de logística
  • Líneas de artículo de la orden de preparación de pedido preparadas para retiro
  • Orden de preparación de pedido trasladada
  • Orden de preparación de pedido en espera
  • Orden de preparación de pedido reprogramada
  • Vencimiento de la orden de preparación de pedido programada
  • Enrutamiento de la orden de preparación de pedido completado
  • Órdenes de preparación de pedido canceladas
  • Solicitud de cancelación de órdenes de preparación de pedido aceptada
  • Solicitud de cancelación de órdenes de preparación de pedido rechazada
  • Solicitud de cancelación de órdenes de preparación de pedido enviada
  • Solicitud de preparación aceptada para órdenes de preparación de pedido
  • Solicitud de preparación rechazada para órdenes de preparación de pedido
  • Solicitud de preparación enviada para órdenes de preparación de pedido
  • Liberación de la espera en las órdenes de preparación de pedido
  • Líneas de artículo de órdenes de preparación de pedido preparadas para entrega local
  • Órdenes de preparación de pedido fusionadas
  • Órdenes de preparación de pedido divididas
  • Actualización de la preparación de pedido
Inventario
  • Creación de artículo de inventario
  • Eliminación de artículo de inventario
  • Actualización de artículo de inventario
  • Conexión del nivel de inventario
  • Desconexión del nivel de inventario
  • Actualización del nivel de inventario
Sucursal
  • Activación de la sucursal
  • Creación de la sucursal
  • Desactivación de la sucursal
  • Eliminación de la sucursal
  • Actualización del elemento en la sucursal
Mercado
  • Creación del mercado
  • Eliminación del mercado
  • Actualización del mercado
Pedido
  • Cancelación del pedido
  • Creación del pedido
  • Eliminación del pedido
  • Edición del pedido
  • Preparación del pedido
  • Pago del pedido
  • Cambio en la evaluación del riesgo del pedido
  • Actualización del pedido
Producto
  • Creación del producto
  • Eliminación del producto
  • Actualización del producto
Reembolso
  • Creación del reembolso
Tienda
  • Actualización de la tienda
Medio de pago
  • Creación de transacción de pago
Tema
  • Creación del tema
  • Eliminación del tema
  • Publicación del tema
  • Actualización del tema
Transacción
  • Creación de la transacción

Crear webhooks

Puedes crear un webhook en cualquier momento. Los webhooks se firman con una identificación compuesta por una combinación de letras y números que es única de la tienda.

Pasos:

Escritorio
  1. Desde el panel de control de Shopify, ve a Configuración > Notifications.

  2. Haz clic en Webhooks.

  3. Haz clic en ⊕ Crear webhook.

  4. En el menú desplegable Evento, selecciona alguno de los supported webhook events que quieras usar. No puedes cambiar el evento del webhook después de crear el webhook.

  5. En el menú desplegable Formato, elige el formato en el que quieres que Shopify te envíe esta información. Hay dos opciones: JSON o XML.

  6. En el campo URL, ingresa la URL donde quieres almacenar los datos. No se pueden entregar webhooks a las siguientes URL:

    • Localhost
    • Cualquier URL que termine con la palabra "internal" (por ejemplo, example.com/internal)
    • Cualquier URL de un dominio personalizado asociado a la tienda
    • Dominios de ejemplo (como www.example.com)
    • Dominios de Shopify (como shopify.com y myshopify.com)
  7. En Versión de la API de webhook, selecciona la versión de webhook que prefieras.

  8. Haz clic en Guardar.

Móvil
  1. Desde la app de Shopify, toca Menu y luego toca Settings Configuración.

  2. En la sección Configuración de la tienda, toca Notificaciones.

  3. Toca Webhooks.

  4. Toca ⊕ Crear webhook.

  5. En el menú desplegable Evento, selecciona alguno de los supported webhook events que quieras usar. No puedes cambiar el evento del webhook después de crear el webhook.

  6. En el menú desplegable Formato, elige el formato en el que quieres que Shopify te envíe esta información. Hay dos opciones: JSON o XML.

  7. En el campo URL, ingresa la URL donde quieres almacenar los datos. No se pueden entregar webhooks a las siguientes URL:

    • Localhost
    • Cualquier URL que termine con la palabra "internal" (por ejemplo, example.com/internal)
    • Cualquier URL de un dominio personalizado asociado a la tienda
    • Dominios de ejemplo (como www.example.com)
    • Dominios de Shopify (como shopify.com y myshopify.com)
  8. En Versión de la API de webhook, selecciona la versión de webhook que prefieras.

  9. Toca Guardar o .

Después de guardar el nuevo webhook, se muestra en la página Webhooks.

Editar webhooks

Puedes editar la configuración de un webhook después de crearlo. Sin embargo, no puedes modificar el selected webhook event.

Pasos:

Escritorio
  1. Desde el panel de control de Shopify, ve a Configuración > Notifications.

  2. Haz clic en Webhooks.

  3. En la fila del webhook que quieres editar, haz clic en ... > Editar.

  4. En el cuadro de diálogo Editar webhook, modifica el webhook según sea necesario.

  5. Haz clic en Guardar.

Móvil
  1. Desde la app de Shopify, toca Menu y luego toca Settings Configuración.

  2. En la sección Configuración de la tienda, toca Notificaciones.

  3. Toca Webhooks.

  4. En la fila del webhook que quieres editar, toca ... > Editar.

  5. En el cuadro de diálogo Editar webhook, modifica el webhook según sea necesario.

  6. Toca Guardar o .

Probar webhooks

Puedes probar el webhook para asegurarte de que la información del evento se envía a la URL correcta.

Pasos:

Escritorio
  1. Desde el panel de control de Shopify, ve a Configuración > Notifications.

  2. Haz clic en Webhooks.

  3. En la fila del webhook que quieres probar, haz clic en ... > Enviar prueba.

  4. En la URL que especificaste para el webhook, verifica que la notificación funcione.

Móvil
  1. Desde la app de Shopify, toca Menu y luego toca Settings Configuración.

  2. En la sección Configuración de la tienda, toca Notificaciones.

  3. Toca Webhooks.

  4. En la fila del webhook que quieres probar, toca ... > Enviar prueba.

  5. En la URL que especificaste para el webhook, verifica que la notificación funcione.

Eliminar webhooks

Puedes eliminar un webhook desde el panel de control de Shopify. Esta acción no se puede deshacer.

Pasos:

Escritorio
  1. Desde el panel de control de Shopify, ve a Configuración > Notifications.

  2. Haz clic en Webhooks.

  3. En la fila del webhook que quieres eliminar, haz clic en ... > Eliminar.

Móvil
  1. Desde la app de Shopify, toca Menu y luego toca Settings Configuración.

  2. En la sección Configuración de la tienda, toca Notificaciones.

  3. Toca Webhooks.

  4. En la fila del webhook que quieres eliminar, toca ... > Eliminar.