Tempo na etapa
O robô «Tempo na etapa» retorna, dentro de um processo de negócios do Bitrix24 (Alaio), quanto tempo um negócio, lead ou item de processo inteligente passou em determinada etapa, em segundos e dias completos, para a última permanência ou para todas somadas.
O robô mede o tempo em uma etapa dentro do próprio processo de negócios do Bitrix24 (Alaio), lendo o histórico de transições em tempo de execução. A etapa é informada por código ou por nome, com prioridade para o código, de modo que renomear uma etapa do funil não quebra nada. Se o item está na etapa agora, o relógio corre até o momento atual: esse é o caso principal, «está parado há N dias». Quando o item voltou à etapa várias vezes, pode-se tomar a última permanência ou a soma de todas; o número de permanências é retornado separadamente e mostra os recuos no funil. O resultado vem em segundos e em dias completos, mais um indicador de se o item está agora nessa etapa. São suportados negócios, leads e itens de processos inteligentes; por padrão é usado o item em que o processo está sendo executado. É medido o tempo de calendário.
Quais parâmetros de entrada o robô aceita?
| Parâmetro | Tipo | Obrigatório? | Padrão |
|---|---|---|---|
| Item | select | — | auto |
| ID do item (para os modos «por ID») | string | — | |
| ID do tipo de processo inteligente (apenas para o modo de processo inteligente) | string | — | |
| Etapa — código ou nome | string | sim | |
| O que é medido | select | — | last |
O que o robô retorna?
| Parâmetro | Tipo |
|---|---|
| Tempo na etapa, segundos | int |
| Tempo na etapa, dias completos | int |
| Número de permanências na etapa | int |
| Atualmente nesta etapa (Y/N) | string |
| Código da etapa | string |
| Nome da etapa | string |
| Etapa encontrada (Y/N) | bool |
| Sucesso | bool |
Quais erros o robô pode retornar?
O robô grava essas mensagens no histórico do processo de negócios quando não consegue concluir uma etapa. O texto mostra o que corrigir nas configurações ou nos dados.
- A etapa «{stage}» não foi encontrada no portal. Informe o código da etapa ou seu nome exato.
- Este tipo de item não tem etapas. O robô funciona com negócios, leads e processos inteligentes; para os modos «por ID» informe um ID válido.
- Erro de API ao ler o histórico de etapas.
Cenário: um negócio parado na aprovação
- Um processo recorrente executa o robô sobre um negócio
- Ele mede o tempo na etapa atual «Aprovação»
- Se passar de sete dias completos, uma tarefa é criada para o responsável, e o número de permanências mostra quantas vezes o negócio já recuou