Shopify Next Generation Events: webhooks granulares con GraphQL

El problema de los webhooks tradicionales de Shopify

Cualquiera que haya construido una integración ERP o PIM sobre Shopify conoce el problema: cada vez que se actualiza un producto, el webhook dispara el payload completo, aunque solo haya cambiado una etiqueta o un metafield irrelevante para el sistema receptor.

Esto genera tres ineficiencias concretas:

• Alto volumen de deliveries no accionables, que consumen recursos de red y de procesamiento
• Over-fetching estructural, con campos innecesarios transportados en cada evento
• Lógicas de diff en la aplicación, necesarias para determinar qué cambió realmente respecto al estado anterior

Los Next Generation Events, ahora disponibles en developer preview en la Shopify Admin GraphQL API, abordan estos tres problemas de forma directa.

Tres dimensiones de control granular

El nuevo sistema introduce control en tres niveles distintos: qué desencadena la delivery, qué contiene el payload y qué ha cambiado.

1. Field-level triggers

Con los Next Generation Events es posible definir una suscripción sobre una ruta específica como product.variants.price. Una suscripción configurada de esta manera no se activa ante cambios en el título, las etiquetas u otros campos: se dispara exclusivamente cuando cambia el precio de las variantes.

Esto elimina de raíz la categoría de las deliveries espurias, sin necesidad de filtros en el lado de la aplicación.

2. Payload personalizado mediante query GraphQL

En lugar de recibir un payload fijo determinado por Shopify, con el nuevo sistema se define directamente la query GraphQL que popula cada delivery. El resultado es que cada evento contiene exactamente los campos necesarios para el procesamiento, sin campos superfluos y sin necesidad de una llamada API adicional para recuperar datos faltantes.

Para las integraciones que hoy siguen el patrón webhook + API call de enriquecimiento, esto representa una reducción neta del número de peticiones hacia la API de Shopify.

3. El campo fields_changed

Cada delivery incluye ahora un campo fields_changed con la lista explícita de las rutas modificadas, incluyendo el path completo y el ID de la entidad. Esto hace obsoleta cualquier lógica de comparación con el estado anterior en el código de la aplicación.

En lugar de mantener un snapshot local de la entidad y calcular el diff en cada evento, el sistema receptor puede leer directamente qué campos han cambiado y actuar en consecuencia.

query_filter: reducir las deliveries no accionables

Otro mecanismo de control adicional es el query_filter, que permite filtrar las deliveries en función del estado actual de la entidad en el momento del evento. Un ejemplo típico: entregar eventos solo para productos con status ACTIVE, ignorando borradores y productos archivados.

Combinado con los field-level triggers, el query_filter permite construir suscripciones muy precisas, reduciendo el tráfico hacia los endpoints de recepción a una fracción del volumen actual.

Config as code con shopify.app.toml

Las suscripciones de Next Generation Events se configuran directamente en el archivo shopify.app.toml, junto con el resto de la configuración de la aplicación. Esto significa que la definición de los eventos es:

• Versionable en el repositorio del proyecto
• Revisable en el proceso de code review
• Reproducible en distintos entornos sin configuraciones manuales

Para equipos que gestionan múltiples entornos (desarrollo, staging, producción) o que siguen prácticas GitOps, este enfoque elimina la dependencia de configuraciones gestionadas manualmente en el panel de Shopify.

Impacto práctico para integraciones ERP y PIM

Para catálogos de alto volumen, la suma de estos cambios tiene un impacto medible en rendimiento y costes:

• Reducción del número de deliveries recibidas gracias a triggers precisos y query_filter
• Reducción del tamaño medio de los payloads gracias a las queries GraphQL personalizadas
• Eliminación de las llamadas API de enriquecimiento post-delivery
• Simplificación del código de la aplicación gracias a fields_changed

Las integraciones que hoy procesan miles de eventos al día con una baja tasa de accionabilidad son las que más se benefician de esta arquitectura.

Recomendaciones para quienes empiezan hoy

El sistema está actualmente en developer preview sobre la API unstable de Shopify, con soporte para las topics Product y Customer. Antes de evaluar su adopción:

• Analiza tu tráfico actual: identifica los webhooks con alto volumen y baja utilidad del payload, son los candidatos prioritarios a la migración
• Prueba en preview: utiliza las topics Product y Customer disponibles hoy para validar el comportamiento esperado
• Reemplaza las lógicas de diff: refactoriza los consumers existentes guiándote por fields_changed
• Configura query_filter: define los criterios de filtrado sobre el estado actual para eliminar deliveries no accionables
• Planifica la migración: la API está en unstable y no es apta para producción sin un plan de migración hacia una versión estable

Si estás construyendo o evolucionando integraciones custom en Shopify Plus y quieres evaluar la arquitectura más adecuada para tu volumen y requisitos, puedes consultar nuestros servicios en la página de planes para desarrolladores Shopify.

Conclusión

Los Next Generation Events no son solo una mejora del rendimiento de los webhooks: redefinen el modelo de integración con Shopify, trasladando el control granular al lado del desarrollador. Para quienes construyen integraciones serias sobre catálogos de alto volumen, vale la pena explorar este patrón ahora, antes de que alcance la estabilidad y se convierta en el estándar esperado.