Data de entrada na etapa
O robô «Data de entrada na etapa» retorna, dentro de um processo de negócios do Bitrix24 (Alaio), a data em que um negócio, lead ou item de processo inteligente entrou em determinada etapa, junto com o número de entradas. A etapa é informada por código ou por nome, e escolhe-se a primeira ou a última entrada.
O robô retorna a data de entrada na etapa indicada dentro do próprio processo de negócios do Bitrix24 (Alaio), lendo o histórico em tempo de execução. A etapa pode ser 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, ao contrário de soluções que dependem apenas do nome. Se o item voltou à etapa várias vezes, escolhe-se a primeira ou a última entrada, e o número de entradas é retornado separadamente, mostrando com que frequência o item recuou no funil. São suportados negócios, leads e itens de processos inteligentes; por padrão é usado o item em que o processo está sendo executado. Uma etapa que não existe no portal é tratada como erro de configuração e informada explicitamente, enquanto uma etapa em que o item simplesmente não esteve é uma resposta comum de «não encontrado». Os funis entre os quais o item foi movido são considerados.
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 | |
| Qual entrada | select | — | last |
O que o robô retorna?
| Parâmetro | Tipo |
|---|---|
| Data de entrada na etapa | string |
| Código da etapa | string |
| Nome da etapa | string |
| Número de entradas na etapa | int |
| Entrada na 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: controle de negócios parados
- Um processo recorrente executa o robô sobre um negócio
- Ele pega a data da última entrada na etapa «Fatura enviada»
- Se passaram mais de sete dias, uma tarefa é criada para o responsável, e o número de entradas mostra quantas vezes o negócio já recuou