Resolución de errores y límites de uso de Flow

Este documento describe los errores frecuentes y los límites, por qué se producen y cómo resolverlos. Hay dos tipos de errores que puedes encontrar en Flow, permanentes y transitorios.

Errores transitorios

Los errores transitorios son errores temporales que se producen cuando Flow no puede completar una tarea. Se reintenta solucionar estos errores hasta que se tiene éxito o se alcanza un límite de tiempo. Por ejemplo, si Flow no puede contactar a un partner al ejecutar una acción de conector, Flow reintenta la tarea varias veces antes de desistir.

Los reintentos se separan y el retraso entre cada intento posterior aumenta con respecto al retraso anterior. Por lo general, cuando un flujo de trabajo experimenta errores transitorios, permanece en el estado de ejecución durante mucho tiempo mientras reintenta las tareas.

Cuando se reintenta una tarea correctamente, el flujo de trabajo continúa. Si una tarea que se reintenta tiene un error permanente, el flujo de trabajo falla. Cada sección de flujo de trabajo tiene un límite de ejecución superior combinado de 36 horas. Si un paso con errores transitorios no se completa correctamente antes de alcanzar ese límite, fallará el flujo de trabajo.

Los flujos de trabajo con pasos de espera se dividen en secciones, lo que afecta la forma en que se calculan los límites de tiempo en un flujo de trabajo. Cada sección es un grupo de tareas que se ejecutan juntas y cada una tiene su propio límite de tiempo de 36 horas. Por ejemplo, si un flujo de trabajo tiene un paso que espera una hora, las tareas antes de dicho paso de espera se ejecutarán juntas en una sección y las tareas después de él se ejecutarán juntas en otra sección. Si un flujo de trabajo tiene varios pasos de espera, las tareas entre cada uno de ellos se ejecutarán juntas en una sección. Los flujos de trabajo sin un paso de espera se consideran una sección.

Los errores transitorios ocasionales son frecuentes. Sin embargo, si tienes un flujo de trabajo que encuentra sistemáticamente el mismo error transitorio entre varias ejecuciones, es posible que el flujo de trabajo deba configurarse de nuevo.

Se agotó el tiempo del paso

Step timed out Normalmente, se producen errores cuando una tarea en el flujo de trabajo intenta consultar demasiados datos en una sección. Este error se produce frecuentemente en flujos de trabajo que iteran en listas, especialmente en las anidadas, que son demasiado grandes para buscar de manera oportuna.

Cuando un flujo de trabajo encuentra este error, el activador o paso de espera se muestra como retrying.

Para resolver esto, verifica las condiciones que accedan a listas y listas anidadas para asegurarte de que sean correctas. Un problema común es que una condición verifica todos los productos de una tienda en lugar de solo los productos de un pedido.

Estado 5xx

La mayoría de las acciones de Flow implican realizar llamadas HTTP. Ocasionalmente, las redes u otros problemas con el servidor pueden hacer que no se puedan realizar llamadas HTTP y devolver un código de error entre 500 y 599. Ver un caso de este error no es un problema, pero las instancias repetidas pueden indicar un problema con el servidor que gestiona la tarea, más que con la forma en que está configurado el paso.

Este tipo de error se observa frecuentemente en la acción Enviar solicitud HTTP, pero puede ocurrir en la mayoría de las tareas.

GraphQL acelerado

El volumen total de trabajo realizado por un flujo de trabajo está restringido por los límites de solicitudes a la API, que se determinan en parte por el plan. En general, estos límites no se alcanzan, a menos que un flujo de trabajo sea muy complejo o tenga un error de diseño involuntario. Los siguientes son ejemplos de escenarios que pueden producir este error:

• Liquid o las condiciones en el flujo de trabajo realizan un bucle en una lista con grandes cantidades de datos, como la verificación de los valores de metacampos que contienen HTML.
• Liquid o las condiciones en el flujo de trabajo realizan un bucle en una gran lista, como realizar un bucle en shop.orders en una gran tienda.
• Un flujo de trabajo genera un bucle infinito en el que dicho flujo de trabajo sigue creando nuevas ejecuciones de flujos de trabajo. Por ejemplo, esto puede suceder si el flujo de trabajo usa el activador Etiquetas de cliente agregadas e incluye la acción Agregar etiquetas de cliente.

Si se alcanza el límite, recibirás el error GraphQL throttled. Este error puede afectar a otros flujos de trabajo cuando intenten ejecutarse, por lo que debe resolverse inmediatamente si se produce.

Errores permanentes

Los errores permanentes se producen cuando Flow no puede completar una tarea y esta no se puede reintentar. Por ejemplo, si Flow no puede enviar un correo electrónico porque la dirección de correo electrónico no es válida, no reintentará la tarea. En su lugar, el flujo de trabajo falla.

Flow no tiene permiso para acceder a tu cuenta de Hojas de cálculo de Google. Vuelve a conectar la cuenta.

El conector de Hojas de cálculo de Google requiere que vincules tu cuenta de Google a Flow a fin de tener permiso para escribir en la hoja. Este error puede ocurrir cuando Flow no tiene permiso para escribir en una hoja, ya sea porque la cuenta se desvinculó de Flow o porque esa cuenta no puede acceder a esa hoja.

Para resolver esto, asegúrate de que la cuenta que se está utilizando para el conector pueda abrir la hoja y tenga acceso de edición. Si la cuenta incorrecta está vinculada, puedes desconectarla y conectar una nueva.

Pasos:

1. Abre o crea un nuevo flujo de trabajo.
2. Agrega una acción.
3. Selecciona el conector de Hojas de cálculo de Google.
4. Haz clic en Desconectar y luego en Conectar.

Acción de Flow recibida con propiedades no válidas. El cliente no acepta marketing.

La acción Enviar correo electrónico de marketing no envía correos electrónicos a clientes que no aceptaron recibirlos y falla permanentemente si el flujo de trabajo intenta hacerlo.

Para resolver esto, agrega una condición en el flujo de trabajo que verifica el estado de suscripción de los clientes. Puedes asegurarte de que los clientes aceptaron recibir correos electrónicos de marketing antes de enviarlos. Sigue los pasos en Gestión de la lista de suscriptores de correo electrónico.

Falta el recurso para el [tipo de recurso]

Este error indica que un recurso, como customer o order, se eliminó antes de que el flujo de trabajo pudiera buscar sus datos. La mayoría de las veces esto se produce después de un paso de espera, pero es posible que esto también suceda en el activador si el recurso se elimina muy rápidamente después de que ocurra el evento activador.

Recibir notificaciones cuando ocurra un error

Si tener errores afectará las operaciones de la tienda, puedes configurar notificaciones para cuando ocurra un error. Las notificaciones de error se pueden crear como cualquier otro flujo de trabajo con el activador Se produjo un error en el flujo de trabajo. Las notificaciones de error están diseñadas para limitar el ruido, por lo que solo recibirás una notificación por versión del flujo de trabajo.

Para comenzar, puedes usar una de las siguientes plantillas:

• Recibir una alerta de Shopify cuando se detectan errores de ejecución del flujo de trabajo
• Recibir notificaciones por correo electrónico cuando se detectan errores de ejecución del flujo de trabajo
• Recibir una notificación de Slack cuando se detectan errores de ejecución del flujo de trabajo

Reintentar ejecuciones

En algunos casos, una ejecución de flujo de trabajo puede detectar un error o no ejecutarse como debe. Después de solucionar los problemas y corregir los errores del flujo de trabajo relacionado, se pueden reintentar manualmente las ejecuciones anteriores para corregir su resultado de forma retroactiva. Obtén más información sobre cómo reintentar ejecuciones de flujos de trabajo.