Webhook
Un webhook es una llamada HTTP automatizada que envía datos a otro sistema en el momento en que ocurre un evento específico.
¿Qué es un webhook?
Un webhook es una llamada HTTP automatizada (generalmente un POST) que un sistema envía a una URL acordada en el momento en que ocurre un evento específico. El receptor nunca tiene que seguir solicitando datos; la fuente envía (pushes) la información por sí misma cada vez que ocurre algo nuevo. Esa es la diferencia clave entre un webhook y una REST API: una API requiere que obtenga datos repetidamente (polling), mientras que un webhook entrega los datos por sí solo tan pronto como se activa el evento.
¿Por qué es importante un webhook?
En una tienda en línea ocurren constantemente cosas a las que otros sistemas deben reaccionar de inmediato: se crea un pedido, se liquida un pago, cambia el stock. Con los webhooks evita consultar a Shopify cada minuto para notar esto: el evento desencadena la acción en tiempo real. Esto hace que las integraciones con su ERP, sistema de inventario, contabilidad o correos electrónicos transaccionales sean más rápidas y confiables, y reduce las llamadas de API innecesarias y los retrasos.
Casos de uso comunes
- Gestión de pedidos: envíe nuevos pedidos a un ERP o sistema de envío a través de
orders/create. - Inventario y productos: sincronice cambios con
products/updateoinventory_levels/update. - Limpieza de aplicaciones: elimine datos de clientes cuando se desinstale una aplicación a través de
app/uninstalled. - Notificaciones: active un correo electrónico, un mensaje de Slack o una factura cuando se complete un pago.
Perspectiva de Shopify
En Shopify puede crear webhooks en el administrador en Configuración → Notificaciones o mediante la Admin API desde una aplicación. La entrega es un POST a su endpoint HTTPS (JSON de forma predeterminada, aunque también se admiten XML y canales como EventBridge y Pub/Sub). Verifique siempre el encabezado X-Shopify-Hmac-Sha256 con el secreto de su aplicación para saber que la llamada proviene realmente de Shopify. Su endpoint debe responder rápidamente con un estado 2xx (generalmente 200); de lo contrario, Shopify volverá a intentarlo durante un máximo de 48 horas y luego eliminará la suscripción.