Introducción a Workflow Webhooks

Shopify Flow Es potente, pero solo reacciona a eventos que tienen lugar dentro de Shopify. Workflow Webhooks elimina esa limitación. Le proporciona un punto final de URL seguro al que los sistemas externos pueden enviar solicitudes POST; y, cuando lo hacen, su flujo de trabajo de Shopify Flow se activa al instante, con los datos del payload pasados como variables utilizables.

Workflow Webhooks

Cómo funciona

  • Su herramienta externa envía una solicitud HTTP POST a la URL de su webhook con un payload en formato JSON (por ejemplo, nombre, correo electrónico, pregunta). Funciona con n8n, Make, Zapier o cualquier herramienta compatible con HTTP.
  • Workflow Webhooks la recibe, autentifica la solicitud y la registra con todos los encabezados y la payload, tras lo cual activa el activador vinculado Shopify Flow.
  • Shopify Flow ejecuta su proceso de automatización: colocar una etiqueta en un cliente, enviar un correo electrónico, actualizar un metacampo: uso de los datos de la carga útil como variables con nombre ({{fieldOne}}, {{fieldTwo}}, {{fieldThree}}, {{fieldFour}}). También puede enviar datos adicionales si marca la casilla Seguridad -> Permitir el cuerpo de solicitud personalizado en el webhook.
  • Un único punto final de webhook puede gestionar cualquier automatización de Shopify Flow.

El flujo de trabajo final: activador de webhook, una condición basada en el ID del webhook y, a continuación, envío de un correo electrónico interno en la rama «True».
Una solicitud a la URL de su webhook inicia un flujo de trabajo de Shopify Flow. La condición limita el proceso a un único webhook; la acción es cualquier cosa que pueda realizar Shopify Flow.

Características

Característica Descripción
Activadores de webhook para Shopify Flow Puntos de conexión HTTP seguros que inician cualquier automatización de Shopify Flow bajo demanda
Asignación de variables Asigne los campos de la carga útil a las variables de Shopify Flow y haga referencia a ellos como {{fieldOne}}, {{fieldTwo}}, etc.
Autenticación Token estático (simple) o HMAC SHA256 (a prueba de manipulaciones)
Historial de invocaciones Registro completo de todas las solicitudes: marca de tiempo, payload, encabezados y estado
Soporte para CORS Habilitar integraciones basadas en navegador o en la interfaz de usuario
Cuerpo de la solicitud personalizada para clientes Admitir estructuras de payload flexibles procedentes de plataformas de terceros
Panel de control de Webhooks Gestione, supervise y realice pruebas en todos los terminales desde un único lugar
Protección contra duplicados Ignore las entregas repetidas que incluyan un identificador de evento que ya haya visto

Autenticación

Método Cómo funciona Ideal para
Ninguno Sin autenticación Solo para pruebas, no para producción
Token estático ✓ Se ha corregido el token en el encabezado X-Api-Key La mayoría de las integraciones (n8n, Make, Zapier)
HMAC SHA-256 Firma a partir de la payload y la clave secreta Alta seguridad o cumplimiento normativo

Asignación de variables

Workflow Webhooks Le permite asignar los campos de su payload JSON entrante a variables con nombre que pueda utilizar Shopify Flow. Defina hasta cuatro nombres de campo en la pestaña «Configuración avanzada». También puede enviar datos adicionales si marca la casilla «Seguridad» -> «Permitir cuerpo de solicitud personalizado».

Campo en la aplicación Su clave de payload Referencia en Shopify Flow
Campo 1 name {{fieldOne}}
Campo 2 email {{fieldTwo}}
Campo 3 question {{fieldThree}}
Campo 4 other {{fieldFour}}
El panel «Añadir una variable» de Shopify Flow para el activador Webhook, en el que se muestran «webhookId» y «fieldOne» a «fieldFour» con valores de ejemplo de una solicitud reciente
Lo que el activador le proporciona a su flujo de trabajo: el ID del webhook y sus cuatro campos asignados, que se muestran con los valores de una solicitud reciente.

Protección contra entregas duplicadas

La mayoría de los sistemas vuelven a intentar enviar un webhook cuando no obtienen una respuesta rápida. Si el primer intento se envió correctamente, su flujo de trabajo de Flow se ejecuta dos veces para el mismo evento: un segundo correo electrónico, una segunda etiqueta o una nota duplicada.

Si su sistema de envío incluye un identificador único por evento, asigne ese nombre a la cabecera en «Configuración avanzada» → «Detección de envíos duplicados» en el webhook; de este modo, se ignorarán las repeticiones.

Comportamiento
Primera solicitud con un identificador determinado Si se procesa de forma habitual, se producen incendios.
Repítalo en un plazo de 24 horas 200 OK con duplicate: true - no enviado a Shopify Flow
Identificador diferente Se ha tramitado con normalidad
No aparece dicho encabezado en la solicitud Se ha tramitado con normalidad

Nombres habituales de encabezados: Event-Id, Idempotency-Key, X-Request-Id. La coincidencia no distingue entre mayúsculas y minúsculas.

bash
# Second call with the same Event-Id is accepted but not re-sent to Flow
curl -X POST https://.../webhook/<short> \
  -H "Content-Type: application/json" \
  -H "Event-Id: evt_12345" \
  -d '{"orderId":"1001"}'

Casos de uso habituales

  • Etiquetar o actualizar a un cliente de Shopify cuando se envíe un formulario desde fuera
  • Activar pedidos o acciones de preparación desde un flujo de trabajo de n8n o Make
  • Sincronice los datos de contacto de un CRM o un servicio de asistencia técnica con Shopify cada vez que se modifique un registro
  • Iniciar un Shopify Flow cuando finalice una automatización de Zapier
  • Automatizaciones de Fire desde un formulario de interfaz de usuario (con CORS habilitado)
  • Sustituya varias integraciones de uso específico por un único gestor de webhooks unificado

Guías de integración paso a paso

  1. Cómo conectar n8n con Workflow Webhooks
  2. Cómo conectar Make con Workflow Webhooks
  3. Cómo conectar Zapier con Workflow Webhooks

Lo que opinan los comerciantes

«Esta aplicación hace que Shopify Flow sea cinco veces más útil. Es muy fácil ponerse en contacto con el desarrollador». «y de gran ayuda». - SuperFast Startup, Portugal

«La pieza que le faltaba a Shopify Flow: solo necesita un Shopify Flow para trabajar con todos «your webhooks». - Senkels, Austria

«Justo lo que estaba intentando resolver mediante varias aplicaciones de terceros. Muy «Lo recomiendo». - Aloha Tinyboards, Estados Unidos

Instalar

Instale Workflow Webhooks desde la tienda de Shopify

Soporte

¿Necesita ayuda? Visite Soporte o utilice el icono de chat que aparece en cualquier página de la aplicación en su panel de administración de Shopify.