Una automatización puede fallar por algo tan pequeño como un dato que ya no llega donde se esperaba. La dificultad aparece después: alguien recibe un aviso, abre un flujo con varios pasos y descubre que no sabe qué información necesitaba cada uno, qué tareas llegaron a completarse o si es seguro volver a ejecutarlo.
Documentar una automatización no consiste en hacer capturas de todas sus pantallas. Consiste en conservar la información que permite tomar una decisión cuando el proceso cambia o se detiene: qué debía ocurrir, de dónde proceden los datos, qué parte se ejecutó y cómo comprobar una corrección sin repetir acciones sobre clientes.
Para verlo con claridad, tomemos una consulta ficticia que pasa por un filtro antes de registrarse. A partir de ella construiremos un mapa de dependencias y una ficha que facilite el diagnóstico, sea cual sea la herramienta utilizada.
Tabla de contenidos
Primero: qué debería hacer el proceso
Imagina una empresa que recibe solicitudes desde su web. Una automatización recoge la consulta, comprueba si contiene un tipo de servicio y, si cumple una condición, la envía a una bandeja de revisión. Una persona del equipo se encarga después de responder.
La descripción parece sencilla, pero deja varias decisiones sin resolver. ¿El proceso acepta una consulta sin tipo de servicio? ¿La clasificación la elige el cliente o la añade alguien después? ¿Qué ocurre si la bandeja no está disponible? ¿Quién recibe un aviso si no se crea el registro?
Antes de investigar una incidencia, conviene responder a esas preguntas sobre el comportamiento esperado. Sin esa referencia es fácil confundir un resultado extraño con un fallo y también dar por correcto un proceso que está dejando solicitudes sin atender.
Una ficha breve podría recoger el origen, la finalidad, las personas responsables, la frecuencia esperada y los destinos. Para este ejemplo: «Recibir una consulta de servicios, identificar si está completa y ponerla a disposición del equipo comercial». El detalle concreto de cada aplicación debe mantenerse en un lugar apropiado y con acceso limitado.
Dibuja las dependencias, no solo las herramientas
En el flujo ficticio, la cadena mínima es:
Formulario → dato de servicio → filtro → registro para revisión → responsable.
La flecha entre el dato y el filtro importa tanto como las cajas. El filtro necesita saber qué valor recibe y qué condición aplica. Si el nombre del campo cambia, si una etapa anterior deja de producirlo o si el valor llega vacío, el comportamiento puede cambiar aunque ninguna de las aplicaciones esté caída.
Anota qué componente produce cada dato necesario y cuál lo utiliza. No hace falta publicar la estructura interna ni copiar identificadores privados en una guía compartida. Una tabla sin datos personales puede expresar la relación:
| Elemento | Qué necesita o produce | Pregunta para revisarlo |
|---|---|---|
| Formulario | Datos que la persona decide enviar | ¿El campo necesario existe y está definido como obligatorio cuando corresponde? |
| Paso de lectura | Valores recibidos del formulario | ¿El dato aparece con el formato que espera el siguiente paso? |
| Filtro | Una condición sobre el dato recibido | ¿Consulta el dato correcto y contempla un valor ausente? |
| Registro de revisión | Una solicitud apta para ser atendida | ¿Se creó una sola vez y con la información necesaria? |
| Responsable | Acceso al registro o aviso | ¿Sabe que debe revisarlo y qué hacer después? |
Un mapa así ayuda incluso cuando el problema no está en el filtro. Si la consulta llega sin el campo, la investigación empieza antes. Si el registro se crea correctamente pero nadie lo revisa, el problema puede estar en el aviso o en la asignación de responsabilidades.
Separa el aviso, la causa y la decisión
Supongamos que aparece un mensaje que indica que un filtro hace referencia a un dato no disponible. Ese mensaje es una observación sobre lo que la herramienta informa. No demuestra, por sí solo, que una persona borrara un campo, que una actualización rompiera el proceso o que se perdieran solicitudes.
Un registro útil distingue tres niveles:
- Observado: qué mensaje se mostró, en qué paso y cuándo se detectó.
- Por comprobar: qué relación o dato podría explicar el aviso y qué evidencia falta para confirmarlo.
- Acción propuesta: qué cambio se considera y cómo se comprobará antes de aplicarlo al proceso real.
Por ejemplo, «el filtro apunta a un dato que no aparece en la salida examinada» no equivale a «la integración borró el dato». La segunda frase atribuye una causa que todavía no se ha demostrado. Si más adelante se confirma un cambio en la estructura del origen, el registro puede actualizarse indicando la evidencia y el momento de la comprobación.
El mismo cuidado sirve para el impacto. Un flujo detenido puede afectar a una solicitud, a varias o a ninguna, según cuándo se detectó y qué mecanismos alternativos existían. No deduzcas pérdidas comerciales a partir de un aviso técnico. Revisa qué solicitudes entraron, cuáles se atendieron y cuáles necesitan seguimiento, con las personas autorizadas y sin exponer sus datos en el informe.
Una ficha de diagnóstico que alguien pueda continuar
Esta ficha de ejemplo reúne la información que permite continuar el diagnóstico aunque cambie la persona encargada.
| Campo | Ejemplo de registro |
|---|---|
| Proceso | Envío de consultas a revisión comercial |
| Fecha de detección | Anotar fecha y zona horaria reales cuando ocurra |
| Comportamiento esperado | Una consulta válida llega a la bandeja asignada |
| Observación | El filtro informa de que una referencia no está disponible |
| Alcance conocido | Pendiente de contrastar con los registros del origen y destino |
| Hipótesis | La referencia apunta a una salida anterior que ha cambiado |
| Evidencia necesaria | Configuración del filtro y ejemplo de salida, sin datos personales |
| Siguiente paso | Revisar el dato de origen en una copia o entorno autorizado |
| Responsable | Persona encargada de la revisión, identificada internamente |
| Resultado | Pendiente; completar solo después de la comprobación |
No guardes contraseñas, claves ni copias completas de consultas en una ficha compartida. Si necesitas conservar una captura o un registro para diagnosticar, limita el acceso, elimina lo que no sea necesario y sigue las políticas de conservación de la empresa.
Tampoco utilices la ficha como sustituto del seguimiento operativo. Si existe una consulta real que necesita respuesta, asigna a alguien esa tarea. Documentar una incidencia no atiende al cliente por sí solo.
Cómo revisar una condición sin precipitarse
Empieza por identificar la condición de negocio: qué debe decidir ese filtro. Después comprueba qué dato utiliza realmente y dónde se produce. Un filtro que debe dejar pasar consultas de un servicio concreto necesita una referencia que llegue a esa etapa y un criterio que coincida con los valores posibles.
La documentación de Make sobre filtros explica cómo aplican condiciones a los datos que atraviesan una ruta. La forma exacta de revisar el mapeo dependerá de la herramienta, del diseño y de la versión disponibles. Una guía genérica no puede demostrar que una configuración concreta sea correcta.
Conviene comparar tres cosas: la estructura que espera el filtro, una salida representativa del paso anterior y el comportamiento deseado si falta el dato. El resultado puede revelar que el campo ha cambiado de nombre, que el valor aparece en otra posición o que la condición nunca contempló una respuesta vacía. Son posibilidades, no un diagnóstico de este ejemplo.
Si falta una decisión de negocio —por ejemplo, qué hacer con una consulta sin clasificación—, no la resuelvas solo desde el editor técnico. Puede que corresponda enviar el caso a revisión manual en vez de descartarlo. La opción depende de la importancia del dato y de la capacidad del equipo para atender excepciones.
Prepara una prueba mínima antes de tocar producción
Una prueba útil no necesita reproducir todo el negocio. Debe comprobar la relación que se quiere corregir y evitar efectos secundarios. Una posibilidad es preparar un flujo aislado o una copia autorizada con datos ficticios, un destino de prueba y avisos dirigidos únicamente a quienes participan en la comprobación.
Diseña al menos tres entradas: una con el valor que debería pasar, otra con un valor que no debería pasar y otra sin el dato. Para cada una escribe de antemano qué esperas observar. Así no decidirás después que cualquier resultado era válido.
| Entrada ficticia | Resultado esperado que debe acordarse |
|---|---|
| Servicio incluido en la condición | Continúa hacia el destino de prueba |
| Servicio distinto | Sigue la ruta alternativa definida o se detiene según el diseño |
| Servicio ausente | Se trata según una regla explícita, por ejemplo revisión manual |
Después registra el resultado real de cada entrada, la versión o configuración que se ha examinado y quién hizo la revisión. Si no puedes ejecutar la prueba con seguridad, deja la casilla como pendiente. Una tabla de resultados previstos no es evidencia de que el sistema haya funcionado.
Repetir una ejecución puede repetir sus consecuencias
Antes de volver a ejecutar un proceso, identifica qué acciones ya llegaron a completarse. Si la automatización envía correos, crea registros o actualiza datos externos, una repetición podría producir un segundo aviso o una entrada duplicada. No todas las plataformas ofrecen los mismos controles para evitarlo.
Make explica que una repetición de ejecución utiliza la versión actual del escenario y puede volver a recorrer módulos que ya habían funcionado. También señala que estas ejecuciones consumen créditos y que los datos disponibles dependen del tipo de ejecución. Es una razón para revisar el alcance y los costes de cada prueba, no para asumir que repetir sea siempre la solución.
Si necesitas recuperar consultas pendientes, prepara una lista con el estado conocido de cada una y determina quién debe validar el siguiente paso. En algunos casos será más seguro completar una acción manualmente; en otros, una repetición controlada puede ser adecuada. La decisión depende de los registros disponibles, los permisos y la posibilidad de comprobar duplicados.
Qué dejar documentado después de una corrección
Cuando se haya realizado una intervención real, actualiza la ficha con el cambio exacto, la fecha, el entorno y el resultado observado. Conserva la diferencia entre «el ejemplo de prueba llegó al destino» y «todas las solicitudes afectadas se han recuperado»: la primera comprobación no demuestra la segunda.
Revisa también si el procedimiento necesita una protección adicional. Puede ser un aviso cuando falte un dato, una revisión periódica de ejecuciones fallidas o una instrucción clara para el equipo. No todo necesita otra automatización: a veces basta con que una persona sepa dónde mirar y quién tiene la responsabilidad de responder.
Por último, actualiza el mapa de dependencias si ha cambiado el origen, el destino o la función de una etapa. Una documentación desactualizada puede ser peor que una ficha breve: transmite seguridad justo cuando el equipo necesita contrastar información.
Una automatización bien mantenida no es la que nunca muestra un error, sino aquella cuyo responsable puede entender qué ha ocurrido, limitar el impacto y comprobar el siguiente paso con evidencia. Si estás valorando qué procesos merece la pena conectar, nuestra guía sobre automatización e integración de sistemas ayuda a empezar por el trabajo que realmente necesita el equipo.
