As variáveis nos processos de negócios do Bitrix24 são células onde o processo guarda valores intermediários: o resultado de uma ação, uma data calculada, a resposta de um sistema externo. Junto com os parâmetros de início e as constantes, elas transformam o modelo de um roteiro rígido em algo configurável. Na prática, a maioria dos "o processo não funciona" são erros justamente nas variáveis: tipo errado, valor vazio, substituição torta. Vamos ver o funcionamento e as técnicas típicas de tratamento.

Qual a diferença entre variável, parâmetro e constante?

São três entidades nas configurações do modelo. Os parâmetros são preenchidos no momento do início — por quem dispara o processo (por exemplo, "motivo do desconto"); dentro do processo eles são apenas lidos. As variáveis vivem internamente: o processo as escreve e relê ao longo do caminho — é aqui que se guardam os resultados das ações. As constantes são definidas uma única vez no modelo (limite de valor, ID do setor) e mudam sem alterar a lógica. Regra prática: tudo que você pergunta a uma pessoa é parâmetro; tudo que você calcula no caminho é variável; todos os "números mágicos" são constantes, senão, ao mudar o limite, você terá de procurá-lo por todas as condições.

Como inserir valores nas ações?

Em qualquer campo de ação funciona o "Inserir valor" — uma seleção em árvore: campos do documento (negócio, lead), parâmetros, variáveis, constantes, resultados de ações anteriores e valores de sistema. Por baixo dos panos, são modelos do tipo {=Document:TITLE} ou {=Variable:total}. Duas pegadinhas: campos múltiplos são inseridos como uma lista separada por vírgula — para trabalhar item a item é preciso primeiro decompô-los; e um valor vazio é inserido como string vazia, não como "nada" — a condição "igual a vazio" e "igual a """ no Bitrix24 nem sempre são a mesma coisa, verifique num registro de teste.

Como tratar strings e escolher valores por condição?

Há poucas funções de string nativas no designer, e aqui ajudam os robôs de uma linha. Escolha por condição sem a ramificação "Condição" em dois blocos: o operador ternário devolve um de dois valores conforme uma comparação — "se o desconto estiver vazio, usar 0" se resolve numa única ação. Extrair um trecho de um texto — o telefone de um comentário, o número de uma fatura de um e-mail: «Extrair por expressão regular». Decompor uma lista em itens — tags separadas por vírgula, o nome completo em partes: «Dividir string por separador» devolve um array e a quantidade de partes, e daí os itens ficam acessíveis por índice.

Como extrair um valor de uma resposta JSON?

Se o processo acessa sistemas externos por requisição HTTP, a resposta chega como uma string JSON — mas você precisa de um único campo de uma estrutura aninhada. O robô «Extrair valor de JSON por caminho» recebe a string e um caminho do tipo data.items.0.price e devolve o valor para uma variável. A combinação "requisição HTTP → JSON por caminho → gravar no campo" é o padrão de integração sem código: cotação de uma API externa, status do pedido de um sistema de gestão, estoque do depósito.

Por que a variável está vazia: checklist

São quatro as causas frequentes. A ação que deveria preencher a variável não foi executada — veja o histórico do processo, uma ramificação pode tê-la contornado. O tipo não bateu: numa variável do tipo "número" foi gravada uma string com espaço — o valor se perdeu em silêncio. O resultado da ação foi pego do bloco errado: ao copiar blocos, a substituição continua apontando para o antigo. Um valor múltiplo é lido como único: em vez do item, foi inserida a lista inteira. Regra de depuração: depois de cada ação importante, grave temporariamente a variável num comentário do card — você verá o valor real em cada passo.

Conclusão

As variáveis são a memória do processo, e disciplina com elas compensa: parâmetros para a entrada, constantes para os limites, variáveis para os resultados. E o tratamento de valores — escolha por condição, decomposição de strings e JSON — é resolvido pelos robôs de uma linha do catálogo da Roboteka, para não montar ramificações à toa.