Cómo usar BPMN en Confluence para documentar procesos de negocio

Todos los equipos tienen esa reunión. Alguien intenta explicar cómo funciona el proceso de renovación, cómo pasa una solicitud por tres departamentos o qué ocurre realmente desde que un cliente firma un contrato hasta que sale la primera factura. Las voces se pisan. Alguien dibuja en una pizarra. La mitad de la sala asiente. Nadie lo apunta. Una semana después surgen las mismas preguntas en otra sala con otro grupo de personas.

Ilustración abstracta en azul claro de formas de diagrama de flujo (rectángulos, un óvalo y un rombo) unidas por cintas onduladas

Todos los equipos tienen esa reunión. Alguien intenta explicar cómo funciona el proceso de renovación, cómo pasa una solicitud por tres departamentos o qué ocurre realmente desde que un cliente firma un contrato hasta que sale la primera factura. Las voces se pisan. Alguien dibuja en una pizarra. La mitad de la sala asiente. Nadie lo apunta. Una semana después surgen las mismas preguntas en otra sala con otro grupo de personas.

Los equipos de operaciones, finanzas, soporte e ingeniería se topan con esto. El trabajo es real, los pasos son reales, los traspasos son reales, pero la documentación suele quedarse en un muro de párrafos en una página de Confluence que nadie logra visualizar del todo. Una lista de pasos se lee como una receta. Un proceso es otra cosa: tiene decisiones, caminos paralelos, plazos, excepciones y personas que esperan unas a otras. Este es el vacío que Business Process Model and Notation, o BPMN, se diseñó para cubrir. Y dentro de Confluence, Capable Diagrams hace que su uso sea práctico.

Por qué BPMN y por qué ahora

BPMN es una notación visual que usa un vocabulario reducido y coherente para describir cómo fluye el trabajo. Las tareas son rectángulos redondeados. Los eventos son círculos. Las compuertas, los rombos que muestran decisiones o bifurcaciones, indican cuándo se ramifica un proceso. Los pools y los carriles agrupan las actividades por equipo o sistema, para que veas de un vistazo quién es responsable de qué. La notación existe desde hace dos décadas y sus símbolos se han perfeccionado hasta el punto de que un modelador de procesos de una empresa puede leer un diagrama de otra y entenderlo sin necesidad de glosario.

La notación existe desde hace tanto tiempo, pero ha sido difícil de usar en la empresa media. Las herramientas de modelado especializadas viven fuera del sistema de documentación, los diagramas se exportan como PNG estáticos y, en un trimestre, la imagen ya está desactualizada. Así que los equipos se rinden y vuelven a las viñetas, aunque ya saben que no bastan. Lo que cambia cuando BPMN vive directamente en Confluence es que el diagrama pasa a formar parte de la página que la gente ya lee. El proceso de renovación, la checklist de incorporación, la ruta de escalado de incidentes: están junto al texto de la política, las incidencias de Jira vinculadas y los comentarios de la retrospectiva del trimestre pasado. Un diagrama que vive donde se documenta el trabajo es un diagrama que la gente mantiene.

Diagrama BPMN de un proceso de tickets de soporte, desde la recepción del ticket, pasando por la resolución o el escalado, hasta el cierre

Dibujar un proceso real de principio a fin

Capable Diagrams admite BPMN como uno de sus más de veinte lenguajes de diagramas, y puedes elegir entre un editor visual para quienes prefieren arrastrar formas y un editor de texto para quienes prefieren describir los diagramas en código. Ambos producen el mismo resultado y ambos viven en la misma macro de Confluence, así que el responsable de un proceso puede esbozar la primera versión de forma visual y un revisor más técnico puede refinarla en texto sin perder fidelidad. Elegir entre los dos deja de ser una decisión de herramientas y pasa a ser una cuestión de preferencia de quien esté editando en ese momento.

Imagina un proceso de incorporación de clientes. El desencadenante es un contrato firmado. A partir de ahí, el camino pasa por el aprovisionamiento, la configuración de la cuenta, la primera llamada de arranque y un seguimiento a los treinta días. Por el camino hay decisiones: ¿es un cliente enterprise o una cuenta de autoservicio? ¿Se programó la llamada de arranque en un plazo de cinco días hábiles? Si no, el proceso vuelve al customer success manager con un recordatorio automático. En un párrafo esto cuesta seguirlo. En BPMN se entiende de un vistazo. El pool muestra que hay tres equipos implicados. Las compuertas muestran dónde puede ramificarse el camino. El evento intermedio de temporizador hace visible el SLA de cinco días en lugar de dejarlo enterrado en el texto de la política. Como el diagrama está incrustado directamente en la página de Confluence, cualquiera que abra la página ve la versión actual y no una captura de hace seis meses que alguien pegó y olvidó.

Editor BPMN de Capable Diagrams creando una plantilla de aprobación de órdenes de compra con el menú de cambio de elemento abierto

Mantener el diagrama alineado con el trabajo

El problema más difícil de la documentación de procesos no es dibujar la primera versión. Es mantener el diagrama alineado con la realidad a medida que el proceso evoluciona. Aquí es donde más importa la integración con el resto de Confluence. Capable Diagrams indexa todos los diagramas de tu instancia de Confluence, de modo que, cuando cambia el proceso de incorporación, puedes encontrar todas las páginas que hacen referencia a él antes de publicar la actualización. Los diagramas se pueden buscar con la búsqueda unificada de Capable, así que una persona recién incorporada puede escribir "onboarding" y encontrar el flujo real del proceso en lugar del tercer párrafo de la séptima página que haya abierto por casualidad. Y como los diagramas están dentro del modelo de permisos existente de Confluence, los mismos controles de acceso que protegen una página de políticas confidencial protegen el diagrama incrustado en ella.

Para los equipos que trabajan con documentación sensible a las versiones, esto importa más de lo que parece. Un equipo de finanzas que documenta un flujo de trabajo de cierre trimestral no quiere una imagen congelada. Quiere un diagrama vivo que refleje la cadena de firmas actual, que muestre cuándo se produce la aprobación relevante para SOX y que pueda actualizar sin salir de Confluence y sin perder el registro de auditoría. Lo mismo vale para los equipos de soporte que documentan rutas de escalado, los equipos de seguridad que documentan la respuesta a incidentes y los equipos de producto que documentan checklists de lanzamiento. El diagrama y el texto de la política tienen que evolucionar juntos o acabarán distanciándose.

Un pequeño hábito que cambia cómo piensan los equipos

Dibujar los procesos así tiene una ventaja más discreta, y se nota en las reuniones más que en la documentación. Cuando un equipo se compromete a mantener un diagrama BPMN de un proceso real, la conversación sobre ese proceso se vuelve más precisa. La gente deja de discutir cuáles son los pasos y empieza a discutir si los pasos son los correctos. El diagrama se convierte en el objeto compartido en el que se apoya la discusión y, una vez que existe, cambiarlo cuesta tan poco que los desacuerdos se convierten en ediciones en lugar de largas cadenas de correos.

Los ingenieros lo saben desde hace años gracias a los diagramas de secuencia y de arquitectura. El mismo patrón funciona para operaciones, soporte, sales ops, finanzas y cualquier función que realice trabajo repetible. Una imagen no sustituye a la explicación escrita. Es lo que hace que la explicación escrita tenga sentido.

Galería de plantillas de Capable Diagrams con ejemplos BPMN como la incorporación de empleados y la aprobación de órdenes de compra

Por dónde empezar

Elige un proceso que tu equipo explique en voz alta más de una vez al mes. El flujo de renovación, la ruta de triaje de bugs, el pipeline de la solicitud al despliegue, la cadena de escalado de incidentes. Dibuja la primera versión en Capable Diagrams con BPMN, incrústala en la página de Confluence que ya documenta el proceso y actualízala la próxima vez que algo cambie. El objetivo no es una notación perfecta. El objetivo es una imagen a la que puedas señalar. Si quieres ver cómo son las piezas básicas en la práctica, la documentación de Capable Diagrams explica los editores visual y de texto y muestra cómo interactúan los diagramas con el resto de la experiencia de Confluence.

La reunión de la pizarra seguirá ocurriendo. Pero la próxima vez, alguien podrá abrir la página, señalar la compuerta en cuestión y zanjar la conversación en cinco minutos.

Capable Diagrams forma parte de la suite de apps de Capable para Confluence Cloud, que ayuda a los equipos a planificar, documentar y colaborar sin salir de las herramientas que ya usan.

Configuración de cookies

Cuidamos de ti y de tus datos. Aquí puedes leer más sobre cómo usamos las cookies y qué terceros las instalan, y actualizar tu configuración de cookies.