Consulta programada de direcciones URL

Normalmente, un webhook espera a que alguien lo active. Con una programación, es la aplicación la que se encarga de activarlo: consulta una URL que usted indique a intervalos fijos y envía la respuesta al mismo webhook, de modo que su flujo de trabajo de Shopify Flow se ejecuta de forma programada desde cualquier API que devuelva datos en formato JSON, datos de formulario o XML.

Usos habituales: obtener los datos de existencias de un proveedor cada 15 minutos, consultar un sistema ERP en busca de nuevos pedidos cada hora o leer un punto final de estado una vez al día y dejar que Shopify Flow actúe en consecuencia.

Cómo configurarlo

Para crear un nuevo webhook, seleccione «Crear webhook» y responda a la pregunta «¿Qué activará este webhook?» con «Nada: ejecutarlo según una programación». El webhook se crea con un token secreto, de modo que nadie más pueda acceder a su URL, y se abre en la pestaña «Programación». Para un webhook que ya tenga, ábralo y vaya a la pestaña «Programación». A continuación, rellene:

Campo	Para qué sirve
Activado	Activa la programación. La URL del webhook seguirá funcionando en cualquier caso.
URL	La dirección desde la que se debe realizar la recuperación. Únicamente http y https, y debe ser accesible desde la red pública de Internet.
Intervalo	Cada 5, 15 o 30 minutos, cada 1, 3, 6 o 12 horas, o una vez al día.
Modo	Cada solicitud activa Shopify Flow en cada ejecución. «Only when the response changes» se activa únicamente cuando el cuerpo difiere del de la ejecución anterior.
Encabezados de solicitud	Opcional: para una clave de API o un token de portador. Se almacena cifrado y no se muestra nunca más.

La primera ejecución tiene lugar en el plazo de un minuto tras activarla.

Análisis de la respuesta

El cuerpo recuperado pasa por el webhook exactamente igual que una solicitud que alguien le haya enviado: se analiza por tipo de contenido, su asignación de campos selecciona los valores que recibe Shopify Flow y, si está configurada, se aplica la división en matriz.

Dado que la API determina por sí misma el formato de su respuesta, las ejecuciones programadas omiten la comprobación de «campos inesperados» que se aplica al JSON enviado por sus propios sistemas. Solo tiene que asignar los valores que le interesen.

{
  "updated_at": "2026-09-17T08:00:00Z",
  "items": [
    { "sku": "ABC-1", "stock": 4 },
    { "sku": "ABC-2", "stock": 0 }
  ]
}

Asigne updated_at a un campo de Flow para utilizarlo en su flujo de trabajo. Para gestionar cada elemento por separado, configure la ruta de división en items en «Configuración avanzada»; de este modo, cada elemento activará su propia ejecución de Flow. Consulte Formatos de cuerpo y matrices de división.

Ejecute ahora

La opción «Ejecutar ahora» realiza una ejecución real de forma inmediata: recupera la URL, le muestra el estado HTTP, la vista previa de la respuesta y lo que ha ocurrido (se ha activado, no ha habido cambios o se ha producido un error), y activa Shopify Flow si la respuesta es válida. Utilícela después de modificar la URL o los encabezados, en lugar de esperar al siguiente intervalo.

Solo cuando la respuesta cambie

En este modo, la aplicación compara el cuerpo de la respuesta obtenida con el anterior y solo activa Shopify Flow cuando hay diferencias. Utilícelo para puntos finales que devuelven el mismo documento hasta que se produzca un cambio real, como, por ejemplo, un feed de cotizaciones bursátiles o de estado. La comparación se realiza sobre el cuerpo completo, por lo que una API que incluya una marca de tiempo o un identificador de solicitud en cada respuesta se mostrará de forma diferente en cada ocasión.

Cuando falla una programación

El bloque «Estado» de la pestaña muestra la última ejecución, el último estado HTTP, la próxima ejecución y el último error.

• Un error de red, un código de estado distinto de 2xx o un cuerpo que no se pueda analizar se considera una ejecución fallida y no activa Shopify Flow.
• Tras 20 fallos consecutivos, la programación se detiene automáticamente y le avisa de ello, en lugar de seguir intentando acceder indefinidamente a una URL que ya no funciona. Corrija la URL o las credenciales y vuelva a activarla.
• Alcanzar el límite de su plan no se considera un fallo. Esas ejecuciones se bloquean y se muestran en el panel de control.

Lo que la aplicación no recuperará

Solo se admiten direcciones públicas. Se rechazan las direcciones internas y privadas (localhost, rangos privados, puntos finales de metadatos en la nube), incluso cuando una redirección apunte a una de ellas. Las respuestas tienen un límite de 1 MB y 10 segundos, y se siguen como máximo 3 redirecciones. Sus encabezados se descartan si una redirección conduce a un sitio web diferente.

Dónde aparecen las ejecuciones programadas

En «Historia», con la fuente «Programada». Todo lo demás funciona como de costumbre: la payload, el resultado del activador de Shopify Flow, los reintentos y la reproducción.