max_steps_reached
HTTPHTTP 400
El workflow llegó al máximo de pasos; hay que dividir la lógica en otro workflow.
Workflows: guardar, validar y activar
Códigos de error · 46 códigos · catálogo del 2026-10-21
Validaciones al guardar, activar o correr wf validar sobre un workflow (src/workflows/services/*.validator.ts). Un workflow que no pasa no se guarda o no se activa.
Para toda la familia
Lo que un código no dice lo hereda de aquí.
- Cómo se detecta
- Respuesta del guardado o de
yarn -s wf validar(elcodey el paso culpable). - Qué hacer
- Corregir la configuración del paso que nombra el mensaje (skill
cambiar-workflowocrear-workflow).
Códigos
WORKFLOW_ACTION_CHANNEL_UNSUPPORTED
detalle
Una action del workflow no sale por un canal que escucha el trigger (p. ej. una lista de WhatsApp en un workflow de Instagram). Guardar el paso o la action lo rechaza siempre (400) desde el 15/10/2026, por la API, wf y el editor; antes era solo un aviso en el log.
- Qué hacer
- Quitar esa action o cambiarla por una que el canal sí mande (el mensaje dice cuál y en qué rama), o separar el workflow por canal.
WORKFLOW_ACTION_TREE_TOO_DEEP
HTTPHTTP 400
El árbol de ramas es más hondo que el tope (10 niveles); hay que separar ramas en pasos con «Ir a paso».
WORKFLOW_ACTIVE_CANNOT_DELETE
HTTPHTTP 409
No se borra un workflow activo: hay que desactivarlo antes (y borrar es irreversible).
WORKFLOW_CATEGORY_MISSING_SPECIAL_BRANCH
HTTPHTTP 400
Ramificar por categoría exige las ramas _none (sin categoría) y _other (otra).
WORKFLOW_CATEGORY_NO_SNAPSHOT
HTTPHTTP 400
Ramificar por categoría necesita al menos una categoría: hay que recargar las categorías de Zauru antes de guardar.
WORKFLOW_CONFIG_MISSING_FIELDS
HTTPHTTP 400
Faltan campos obligatorios de la configuración de una action; el mensaje dice cuáles.
WORKFLOW_DURATION_INVALID
HTTPHTTP 400
Una duración no es un número entero de segundos mayor a 0.
WORKFLOW_DURATION_TOO_LONG
HTTPHTTP 400
Una duración pasa el máximo de 1 año.
WORKFLOW_FAN_OUT_TRIGGER_NOT_ALLOWED
HTTPHTTP 400
El workflow reparte a muchos contactos (fan-out) y su trigger no lo permite (solo programado o manual).
WORKFLOW_GOTO_STEP_NOT_FOUND
HTTPHTTP 400
Hay saltos «Ir a paso» a pasos que no existen.
WORKFLOW_INVOKED_TRIGGER_IS_INTERNAL
HTTPHTTP 400
Este workflow solo puede ser invocado desde la action final de otro workflow.
WORKFLOW_LIST_INVALID_ROWS
HTTPHTTP 400
La lista no la aceptaría WhatsApp (título largo, filas repetidas o de más); el mensaje dice qué.
WORKFLOW_LIST_WITHOUT_ROWS
HTTPHTTP 400
La lista no tiene ninguna opción que ofrecer.
WORKFLOW_LOCATION_IN_USE
HTTPHTTP 409
La ubicación la usan actions de workflow: se archiva en vez de borrarla, o se quita primero de esos flujos.
WORKFLOW_LOOP_BODY_NO_RETURN
HTTPHTTP 400
El cuerpo del bucle tiene ramas que terminan sin volver; cada hoja debe terminar en «Ir a paso», nunca en «Finalizar».
WORKFLOW_LOOP_CANNOT_BE_NESTED
HTTPHTTP 400
Un bucle no puede vivir dentro de una rama: tiene que ser la única action de su paso.
WORKFLOW_LOOP_MISSING_BRANCH
HTTPHTTP 400
Al bucle le faltan las ramas _item (cuerpo) o _done (al terminar).
WORKFLOW_LOOP_SOURCE_MUST_BE_STABLE
HTTPHTTP 400
El bucle tiene que ser la única action de su paso; la lectura de datos va en un paso anterior.
WORKFLOW_LOOP_SOURCE_NOT_CONFIGURED
HTTPHTTP 400
El bucle no dice de dónde sacar la colección o cómo identificar cada ítem.
WORKFLOW_MESSAGE_LIMIT_EXCEEDED
HTTPHTTP 400
Un mensaje del workflow pasa los límites del canal; hay que acortarlo antes de guardar.
WORKFLOW_REPLY_MISSING_CATCH_ALL
HTTPHTTP 400
Una action que espera respuesta no tiene las ramas _other y _timeout; sin ellas el flujo muere en silencio ante una respuesta no prevista.
WORKFLOW_RETURN_POINT_DUPLICATE
HTTPHTTP 400
El mismo punto de regreso está marcado más de una vez.
WORKFLOW_RETURN_POINT_IN_USE
HTTPHTTP 409
Se quitó un punto de regreso que todavía usa un «Volver».
WORKFLOW_RETURN_POINT_INVALID
HTTPHTTP 400
El punto de regreso necesita nombre y una clave válida.
WORKFLOW_RETURN_POINT_NOT_ALLOWED
HTTPHTTP 400
Esa action no puede ser punto de regreso (salta o termina el flujo).
WORKFLOW_RETURN_POINT_NOT_FOUND
HTTPHTTP 400
El punto de regreso elegido no es válido; hay que elegirlo de nuevo.
WORKFLOW_SCHEDULE_CRON_MISSING
HTTPHTTP 400
Un workflow programado no tiene horario: se activaría y nunca correría.
WORKFLOW_STEP_HAS_REFERENCES
HTTPHTTP 409
El paso que se quiere borrar recibe saltos de otros pasos (pasarían a «Finalizar»).
WORKFLOW_STEP_TOO_LARGE
HTTPHTTP 400
El paso es muy grande (cerca del tope de ~100 KB del cuerpo); hay que dividirlo en más pasos.
WORKFLOW_SWITCH_CASE_WITHOUT_CONDITIONS
HTTPHTTP 400
Un caso de la evaluación múltiple no tiene condiciones y nunca se cumpliría.
WORKFLOW_SWITCH_NO_CASES
HTTPHTTP 400
La evaluación múltiple no tiene casos: todo se iría por «Sino».
WORKFLOW_TEMPLATE_BRANCH_WITHOUT_BUTTON
HTTPHTTP 400
Hay ramas que no corresponden a ningún botón de la plantilla.
WORKFLOW_TEMPLATE_BUTTON_WITHOUT_BRANCH
HTTPHTTP 400
La plantilla espera respuesta y tiene botones sin rama: el flujo quedaría esperando sin saber a dónde ir.
WORKFLOW_TEMPLATE_BUTTONS_NEED_SWITCH
HTTPHTTP 400
Con varios números emisores, las plantillas con botones no caben en un solo envío: hay que separar los números con un switch.
WORKFLOW_TEMPLATE_CHANNEL_ACCOUNT_NOT_IN_ENTITY
HTTPHTTP 400
La configuración de «plantilla por número» nombra números que no son de la entidad.
WORKFLOW_TEMPLATE_HEADER_MEDIA_MISSING
HTTPHTTP 400
La plantilla tiene encabezado con archivo y no se resolvió; hay que volver a elegir la plantilla.
WORKFLOW_TEMPLATE_INVALID_CHANNEL_ACCOUNT
HTTPHTTP 400
Las claves de «plantilla por número» no son ids de número emisor.
WORKFLOW_TEMPLATE_NOT_SELECTED
HTTPHTTP 400
Selecciona un template. Si la entidad tiene varios numeros, configura el template de cada numero: una plantilla pertenece a la WABA de un solo numero.
WORKFLOW_TEMPLATE_PARAM_COUNT_MISMATCH
HTTPHTTP 400
La plantilla espera otro número de variables que las configuradas.
WORKFLOW_TEMPLATE_VARIANT_WITHOUT_TEMPLATE
HTTPHTTP 400
Una variante por número no tiene plantilla elegida.
WORKFLOW_TERMINAL_ACTION_NOT_LAST
HTTPHTTP 400
Hay actions después de una que corta el flujo (sale por sus ramas): nunca se ejecutarían.
WORKFLOW_TEST_PHONE_NUMBERS_LIMIT
HTTPHTTP 400
«Avisar a un número (pruebas)» tiene más números de los permitidos.
WORKFLOW_TIME_TRAVEL_TARGET_REQUIRED
HTTPHTTP 400
«Volver» no tiene a dónde volver, o tiene paso y punto de regreso a la vez.
WORKFLOW_WEB_PAGE_ORDER_DISCOUNT_INVALID
HTTPHTTP 400
El descuento de «Página web» en modo orden no es válido.
WORKFLOW_WEB_PAGE_RESULT_MISSING_BRANCH
HTTPHTTP 400
«Esperar resultado de la página web» necesita sus cinco ramas fijas.
Texto generado desde el catálogo de errores de BoostAPI. Para corregirlo, se cambia allá y se sincroniza: verMantener esta documentación. También enMarkdown.