Tiempo en la etapa
El robot «Tiempo en la etapa» devuelve, dentro de un proceso de negocio de Bitrix24 (Alaio), cuánto tiempo estuvo una negociación, un prospecto o un elemento de proceso inteligente en una etapa determinada, en segundos y días completos, para la última estancia o para todas sumadas.
El robot mide el tiempo en una etapa dentro del propio proceso de negocio de Bitrix24 (Alaio), leyendo el historial de transiciones en tiempo de ejecución. La etapa se indica por código o por nombre, con prioridad para el código, de modo que renombrar una etapa del embudo no rompe nada. Si el elemento está en la etapa ahora mismo, el reloj corre hasta el momento actual: ese es el caso principal, «lleva N días atascado». Cuando el elemento volvió a la etapa varias veces, se puede tomar la última estancia o la suma de todas; el número de estancias se devuelve por separado y muestra los retrocesos en el embudo. El resultado se da en segundos y en días completos, más un indicador de si el elemento está ahora en esa etapa. Se admiten negociaciones, prospectos y elementos de procesos inteligentes; por defecto se usa el elemento sobre el que se ejecuta el proceso. Se mide tiempo de calendario.
¿Qué parámetros de entrada acepta el robot?
| Parámetro | Tipo | ¿Obligatorio? | Por defecto |
|---|---|---|---|
| Elemento | select | — | auto |
| ID del elemento (para los modos «por ID») | string | — | |
| ID del tipo de proceso inteligente (solo para el modo de proceso inteligente) | string | — | |
| Etapa — código o nombre | string | sí | |
| Qué se mide | select | — | last |
¿Qué devuelve el robot?
| Parámetro | Tipo |
|---|---|
| Tiempo en la etapa, segundos | int |
| Tiempo en la etapa, días completos | int |
| Número de estancias en la etapa | int |
| Actualmente en esta etapa (Y/N) | string |
| Código de la etapa | string |
| Nombre de la etapa | string |
| Etapa encontrada (Y/N) | bool |
| Correcto | bool |
¿Qué errores puede devolver el robot?
El robot escribe estos mensajes en el registro del proceso de negocio cuando no puede completar un paso. El texto indica qué corregir en la configuración o en los datos.
- La etapa «{stage}» no se encontró en el portal. Indique el código de la etapa o su nombre exacto.
- Este tipo de elemento no tiene etapas. El robot funciona con negociaciones, prospectos y procesos inteligentes; para los modos «por ID» indique un ID válido.
- Error de API al leer el historial de etapas.
Escenario: una negociación atascada en aprobación
- Un proceso periódico ejecuta el robot sobre una negociación
- Mide el tiempo en la etapa actual «Aprobación»
- Si supera los siete días completos, se crea una tarea para el responsable, y el número de estancias muestra cuántas veces ha retrocedido ya