Roboteka
Roboteka · Robôs · Valor anterior de um campo

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 Item atual, Lead por ID, Negócio por ID, Contato por ID, Empresa por ID, Item de processo inteligente por ID — 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

  1. O robô fica na etapa «Aprovação» e lê o campo opportunity
  2. Retorna o valor anterior e o novo, e o ID do colaborador que o alterou
  3. Se o valor novo for menor que o anterior, o gestor recebe um aviso com os dois números

Robôs semelhantes