Histórico de etapas como lista
O robô «Histórico de etapas como lista» retorna, dentro de um processo de negócios do Bitrix24 (Alaio), todo o caminho de um negócio, lead ou item de processo inteligente pelas etapas: listas de códigos, nomes e datas de entrada, mais uma linha pronta para um comentário.
O robô retorna todo o histórico de etapas dentro do próprio processo de negócios do Bitrix24 (Alaio), lendo-o em tempo de execução. Voltam três listas estritamente paralelas — códigos de etapa, seus nomes e as datas de entrada: o i-ésimo elemento de cada lista descreve a mesma transição, de modo que as listas podem ser passadas aos robôs de trabalho com listas e compor qualquer relatório. Separadamente volta uma linha pronta do tipo «Nova — 01.09.2026 10:00; Fatura enviada — 03.09.2026 11:00», que se cola direto em um comentário do negócio ou em um e-mail ao gestor, junto com o número de transições. A ordem é cronológica, da primeira etapa à última. As datas vêm no fuso horário do portal, portanto coincidem com o que o cartão mostra. São suportados negócios, leads e itens de processos inteligentes; por padrão é usado o item em que o processo está sendo executado. Mover entre funis conta como uma transição comum.
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 | — |
O que o robô retorna?
| Parâmetro | Tipo |
|---|---|
| Códigos de etapa (lista) | string |
| Nomes de etapa (lista) | string |
| Datas de entrada (lista) | string |
| Histórico em uma linha | string |
| Número de transições | int |
| O histórico não está vazio (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.
- 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: o caminho do negócio como comentário no fechamento
- O negócio passa para uma etapa ganha
- O robô obtém o histórico de etapas em uma linha
- A linha é publicada como comentário na linha do tempo e toda a equipe vê o caminho percorrido e quantas transições houve