A ação Calcular valor faz uma conta ou monta um dado a partir das informações do fluxo (cliente, pedido, carrinho, gatilho e variáveis de passos anteriores) e guarda o resultado numa variável do fluxo. Nos passos seguintes, você usa esse resultado em mensagens, condições e outras ações.
Exemplos do que dá para fazer: calcular 5% de cashback sobre o pedido, montar um cupom com o nome do cliente, definir a faixa do cliente pelo valor do pedido ou calcular uma data de vencimento daqui a 30 dias.
Como adicionar
Passo 01 — Escolha a ação
No editor do fluxo, clique no + da saída do cartão e abra a aba Controle do seletor (ou busque por Calcular valor). A folha abre com os campos Código, Tipo do resultado e Salvar como.
Passo 02 — Escreva o cálculo no editor de código da ação
No campo Código, clique em Abrir editor. O editor de código da ação abre em tela grande, com três apoios:
Variáveis: lista os dados do fluxo que você pode usar. Clique num item para inseri-lo no código, na posição do cursor. Use a busca Buscar variável… para filtrar.
Exemplos: cálculos prontos para partir deles, como Cashback de 5% do pedido, Cupom com o nome do cliente, Faixa do cliente pelo valor do pedido, Data de expiração em 30 dias e Total do pedido na moeda da loja. O botão Usar coloca o exemplo no editor.
Executar: testa o cálculo com dados de exemplo (Amostras) e mostra o Resultado e o tipo do valor. Ajuste as amostras para parecerem com os dados reais da sua loja. O teste só funciona dentro do editor do fluxo e não envia nada a ninguém.
O código precisa terminar devolvendo o valor que você quer guardar. Se o código tiver um erro, o teste mostra a mensagem e o botão Ir para a linha.
Passo 03 — Escolha o tipo do resultado
No campo Tipo do resultado, escolha Automático (padrão, usa o tipo do valor que o cálculo devolve), Número, Texto, Sim ou não, Data ou Objeto (JSON). Com um tipo escolhido, se o cálculo devolver outro tipo, o passo segue pelo erro.
Passo 04 — Dê um nome em Salvar como
O campo Salvar como é obrigatório e já vem preenchido com resultado. Troque por um nome que faça sentido (por exemplo, cashback). Use só letras sem acento, números e _, sem repetir um nome já usado no fluxo.
Passo 05 — Salve e use o resultado
Clique em Salvar. Nos passos ligados depois do Calcular valor, o resultado aparece no seletor de variáveis (botão { } ou digitando {{ num campo de texto), com o nome que você deu. Escolha a variável na lista, em vez de digitá-la. Ela também pode ser usada nas condições Se o valor do atributo e Expressão avançada.
Limites e cuidados
Cálculos curtos e rápidos. O código tem tamanho máximo (10 KB) e precisa terminar em uma fração de segundo. Ele roda isolado, sem acesso à internet e sem consultar outros sistemas: para buscar dados fora da Martz, use a ação Chamar webhook.
Erro de escrita impede a ativação. Se o código tiver um erro de sintaxe, a Martz não deixa ativar ou publicar o fluxo até você corrigir.
Se o cálculo falhar ao rodar (erro no código, tempo esgotado ou tipo diferente do escolhido), o passo segue pelo erro e o caminho do cliente termina ali. A folha não tem Caminhos extras. Nos detalhes da execução aparece "O código de "Calcular valor" não pôde ser executado", com o motivo.
Sem valor. Se o cálculo não devolver nada, a variável fica vazia.
Só depois deste passo. A variável tem valor apenas nos passos ligados depois do Calcular valor.
Com o código vazio, o cartão mostra Código não escrito, com selo de pendência, e o fluxo não pode ser ativado.
Exemplo de uso
Gatilho Pedido pago → Calcular valor com o exemplo Cashback de 5% do pedido, Tipo do resultado = Número e Salvar como = cashback → Enviar WhatsApp oficial com um template que avisa o cliente, preenchendo a variável do template com o resultado escolhido no seletor de variáveis.