Etapa anterior
El robot «Etapa anterior» devuelve, dentro de un proceso de negocio de Bitrix24 (Alaio), la etapa desde la que una negociación, un prospecto o un elemento de proceso inteligente llegó a la actual: el código para las condiciones, el nombre para el texto, además del embudo, el momento de salida y el tiempo permanecido.
El robot devuelve la etapa anterior dentro del propio proceso de negocio de Bitrix24 (Alaio): sin campos personalizados y sin esperas, el historial se lee en tiempo de ejecución con una sola consulta. Admite negociaciones, prospectos y elementos de procesos inteligentes; por defecto usa el elemento sobre el que se ejecuta el proceso, de modo que el caso habitual no necesita configuración, mientras que los modos «por ID» cubren los procesos que se ejecutan sobre otro elemento. Devuelve el código de la etapa (para condiciones), el nombre de la etapa (para un correo o un comentario), la semántica P/S/F, el ID del embudo, el momento en que el elemento salió de la etapa y el tiempo allí en segundos. Un indicador «encontrada» distingue «el elemento nunca se ha movido» de un error real, por lo que el camino normal no necesita gestión de errores. Mover un elemento entre embudos cuenta como cambio de etapa.
¿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 | — |
¿Qué devuelve el robot?
| Parámetro | Tipo |
|---|---|
| Código de la etapa anterior | string |
| Nombre de la etapa anterior | string |
| Semántica de la etapa: P — en curso, S — éxito, F — fracaso | string |
| ID del embudo de la etapa anterior | string |
| Cuándo salió de la etapa anterior | string |
| Tiempo en la etapa anterior, en segundos | int |
| Etapa anterior 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.
- 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 retrocede en el embudo
- El robot se ejecuta en la etapa «Negociación»
- Si la etapa anterior es «Factura enviada», la negociación ha retrocedido
- Se crea una tarea para el responsable y en el comentario se registra cuánto tiempo estuvo en la etapa anterior