Valor anterior de um campo
O robô «Valor anterior de um campo» retorna, dentro de um processo de negócios do Bitrix24 (Alaio), o valor que um campo tinha antes da última alteração: o valor anterior, o novo, o momento da alteração e o ID do usuário que a fez. Funciona com negócios, leads, contatos, empresas e processos inteligentes e precisa do histórico de alterações de campos ativado.
O robô lê o histórico de alterações que o aplicativo mantém no seu portal do Bitrix24 (Alaio) e retorna a última alteração de um campo: o valor antes, o valor depois, o momento e o ID do usuário. O histórico de alterações de campos precisa estar ativado nas configurações do aplicativo; se estiver desativado ou o campo nunca tiver mudado, o robô não falha, mas retorna o indicador «encontrado» = N, de modo que o caminho normal não exige tratamento de erros. O campo é informado pelo seu código, como a API REST do Bitrix24 o retorna: title, opportunity, ufCrm_123; telefones, e-mails, sites e mensageiros são phone, email, web, im. Por padrão é usado o item em que o processo está sendo executado; os modos «por ID» cobrem processos executados sobre outro item. Se o campo foi alterado em segundo plano, sem usuário (por exemplo, por um robô ou um processo de negócio após uma pausa), o indicador «sem usuário» é Y e o ID do usuário é 0.
Quais parâmetros de entrada o robô aceita?
| Parâmetro | Tipo | Obrigatório? | Padrão |
|---|---|---|---|
| Código do campo (por exemplo title, opportunity, ufCrm_123; para telefones, e-mails, sites e mensageiros: phone, email, web, im) | string | sim | |
| 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 |
|---|---|
| Valor do campo antes da última alteração | string |
| Valor do campo depois da última alteração | string |
| Quando o campo foi alterado pela última vez | datetime |
| ID do usuário que fez a alteração; 0 quando ela foi feita em segundo plano, sem usuário. Para uma alteração que o histórico ainda não registrou, o último editor do item | int |
| A alteração foi feita em segundo plano, sem usuário (por exemplo, um robô ou um processo de negócio após uma pausa); também Y para uma alteração que o histórico ainda não registrou (Y/N) | bool |
| Alteração encontrada (Y/N) | bool |
| Sucesso | bool |
| Mensagem do resultado | string |
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.
- O código do campo não foi informado.
- Este item não tem histórico de alterações. O robô funciona com leads, negócios, contatos, empresas e processos inteligentes; para os modos «por ID» informe um ID válido.
- Não foi possível ler o histórico de alterações. Execute a etapa novamente mais tarde; se o erro se repetir, entre em contato com o suporte.
Cenário: avisar o gestor quando o valor de um negócio é reduzido
- O robô fica na etapa «Aprovação» e lê o campo opportunity
- Retorna o valor anterior e o novo, e o ID do colaborador que o alterou
- Se o valor novo for menor que o anterior, o gestor recebe um aviso com os dois números