Automação - ação Calcular campo (fórmula)
Como gravar em um campo do negócio o resultado de uma conta, de um texto montado ou de uma escolha com condição, usando uma fórmula na automação - como se escreve, os campos que a fórmula lê, a lista de funções, exemplos prontos e os erros mais comuns.
Quando usar
Use quando um campo do negócio deve ser preenchido sozinho com o resultado de uma conta, de um texto montado ou de uma escolha com condição.
Antes de começar
- Poder criar e editar automações do CRM
- O campo que vai receber o resultado (os campos adicionais são criados antes, em Campos extras)
- Saber de quais campos do negócio a conta depende
Para que serve e quando usar
A ação Calcular campo grava em um campo do negócio o resultado de uma fórmula. Serve para fazer contas, montar um texto com dados do negócio e escolher entre valores com uma condição.
É o que o CRM oferece no lugar de um "bloco de código". A fórmula só enxerga os campos do próprio negócio e só usa as funções da lista. Ela não executa programa.
Antes de começar
| O que | Detalhe |
|---|---|
| Onde fica | CRM > Painel de controle > grupo Automação > cartão Automações, no cartão Então de uma automação |
| Campo de destino | O campo que vai receber o resultado. Campo adicional é criado antes, em CRM > Painel de controle > grupo Configuração e integrações > cartão Campos extras |
| Campos de origem | Os campos do negócio que entram na conta. Se um deles pode estar vazio, a fórmula precisa tratar isso |
Exemplo - valor anual a partir da mensalidade
- 1
Abra a automação e clique em Adicionar ação. No cartão Então, em "Tipo de ação", escolha "Calcular campo (fórmula)".
- 2
Em "Campo que recebe o resultado", escolha Valor do negócio. Pode ser também um campo adicional.
- 3
Em "Fórmula", escreva ARREDONDAR({{campo.mensalidade}} * 12; 2).
- 4
Veja o selo abaixo da fórmula. A tela confere enquanto você escreve: "Certo", com "Fórmula válida.", ou "Corrigir", com o motivo.
- 5
Em "Ver o resultado com um negócio", clique em Escolher um negócio de exemplo, busque pelo nome do cliente e escolha o negócio. A tela mostra "Resultado com este negócio:" e o valor. Nada é gravado.
- 6
Em "Se a fórmula falhar", escolha entre "Continuar com as próximas ações" e "Parar o fluxo nesta ação".
- 7
Clique em Publicar automação.
Como se escreve
| Parte | Como se escreve | Exemplo |
|---|---|---|
| Número | Com vírgula na casa decimal | 10 ou 1,5 |
| Texto | Entre aspas | "Plano" |
| Campo do negócio | Entre chaves duplas | {{valor}} ou {{cliente}} |
| Campo adicional | Entre chaves duplas, com a palavra campo, um ponto e a chave do campo | {{campo.mensalidade}} |
| Conta | Com os sinais de mais, menos, vezes e dividir, e parênteses | ({{valor}} - 100) * 12 |
| Juntar texto | Com o sinal & | {{cliente}} & " - " & {{produto}} |
| Comparar | Com igual, diferente, menor, maior, menor ou igual e maior ou igual | {{valor}} >= 5000 |
| Função | O nome, e os argumentos entre parênteses, separados por ponto e vírgula | SE({{valor}} > 1000; "Sim"; "Não") |
Os sinais de comparação são =, <>, <, >, <= e >=. Compare dois valores por vez; para mais de uma condição, use as funções E e OU.
Campos que a fórmula lê
| Na fórmula | Campo | Tipo |
|---|---|---|
| {{valor}} | Valor do negócio | Número |
| {{numero}} | Número do negócio | Número |
| {{cliente}} | Nome do cliente | Texto |
| {{contato}} | Nome do contato | Texto |
| {{email}} | Texto | |
| {{telefone}} | Telefone | Texto |
| {{produto}} | Produto / serviço | Texto |
| {{origem}} | Canal de origem do cliente | Texto |
| {{proxima_acao}} | Próxima ação | Texto |
| {{data_proxima_acao}} | Data da próxima ação | Data |
| {{observacoes}} | Observações gerais | Texto |
| {{etapa}} | Etapa | Texto |
| {{funil}} | Funil | Texto |
| {{data_criacao}} | Data de criação | Data |
| {{data_ganho}} | Data do ganho | Data |
| {{campo.chave}} | Campo adicional do funil. Troque "chave" pela chave do campo | Conforme o campo |
A lista que vale é a da tela, em "Campos do negócio". Os campos adicionais dos funis aparecem lá pelo nome.
Funções aceitas
| Função | O que faz |
|---|---|
| SE(condição; se verdadeiro; se falso) | Escolhe entre dois valores |
| E(condição; condição...) | Verdadeiro quando todas as condições são verdadeiras |
| OU(condição; condição...) | Verdadeiro quando alguma condição é verdadeira |
| NAO(condição) | Inverte a condição |
| VAZIO(valor) | Verdadeiro quando o campo está vazio |
| ARREDONDAR(número; casas) | Arredonda para o número de casas decimais. Sem as casas, arredonda para inteiro |
| MAIOR(a; b...) | O maior dos números |
| MENOR(a; b...) | O menor dos números |
| ABS(número) | O número sem o sinal |
| NUMERO(valor) | Converte texto em número. Vazio vira 0 |
| TEXTO(valor; casas) | Converte em texto. Número sai com vírgula e com as casas pedidas |
| CONCATENAR(a; b...) | Junta os valores em um texto só |
| MAIUSCULA(texto) | Texto em letras maiúsculas |
| MINUSCULA(texto) | Texto em letras minúsculas |
| HOJE() | A data de hoje |
| DIAS_ENTRE(data inicial; data final) | Quantos dias da primeira data até a segunda |
| DATA_MAIS_DIAS(data; dias) | A data somada aos dias. Número negativo volta no tempo |
Os nomes das funções são escritos sem acento, como na tabela.
Mais exemplos
| Para quê | Fórmula | Onde gravar ou usar |
|---|---|---|
| Valor anual a partir da mensalidade | ARREDONDAR({{campo.mensalidade}} * 12; 2) | Valor do negócio |
| Faixa pelo valor | SE({{valor}} >= 5000; "Grande"; SE({{valor}} >= 1000; "Médio"; "Pequeno")) | Um campo adicional de texto |
| Texto com dados do negócio | CONCATENAR({{cliente}}; " - "; {{produto}}) | Um campo de texto |
| Próxima ação em 3 dias | DATA_MAIS_DIAS(HOJE(); 3) | Data da próxima ação |
| Dias desde a criação | DIAS_ENTRE({{data_criacao}}; HOJE()) | Um campo adicional numérico |
| Tratar campo vazio como zero | NUMERO({{campo.desconto}}) | Dentro de uma conta |
| Dividir sem erro de zero | SE({{campo.meses}} = 0; 0; {{valor}} / {{campo.meses}}) | Um campo numérico |
Dá para combinar com a ação Chamar API: a API grava a mensalidade em um campo adicional e a ação seguinte calcula {{campo.mensalidade}} * 12 e grava o valor do negócio.
Campos que recebem o resultado
A fórmula grava em um destes campos: Próxima ação, Data da próxima ação, Valor do negócio, Produto / serviço, Canal de origem do cliente, Observações gerais e os campos adicionais do funil. Para um campo adicional que não está na lista, escolha "Outro campo adicional (pela chave)" e digite a chave.
Responsável, etapa e cliente não são gravados por fórmula: cada um tem a sua ação própria na automação.
Como se comporta
- Campo vazio em uma conta é erro, para não gravar zero sem ninguém ver. Para tratar vazio como zero, use NUMERO. Para testar se está vazio, use VAZIO.
- O resultado é conferido antes de gravar: número em campo numérico, data em campo de data, e campo obrigatório não fica vazio. Se o campo recusar, nada é gravado e o motivo aparece nos logs.
- Valor de negócio já ganho não é alterado.
- Quando a fórmula falha, o campo fica como estava. A opção "Se a fórmula falhar" decide se as próximas ações continuam ou se o fluxo para ali.
- Fórmula com erro de escrita não é salva. A tela mostra a ação e o motivo.
- A fórmula tem até 1.000 caracteres e cada função aceita até 20 argumentos.
- ARREDONDAR e TEXTO aceitam de 0 a 10 casas decimais.
- Só valem as funções da lista. Não existe função própria nem repetição.
- O resultado de cada execução fica em CRM > Painel de controle > grupo Configuração e integrações > cartão Logs e histórico.
Problemas comuns
- Aparece "Os argumentos são separados por ponto e vírgula (;), não por vírgula" - a vírgula é a casa decimal. Separe os argumentos das funções com ponto e vírgula.
- Aparece "Divisão por zero. Use SE(...) para tratar o zero antes de dividir." - trate o zero antes da conta, como em SE({{campo.meses}} = 0; 0; {{valor}} / {{campo.meses}}).
- Aparece "Há um campo vazio em" seguido do lugar - campo vazio em uma conta é erro, para não gravar zero sem ninguém ver. Use NUMERO(campo) para tratar vazio como zero ou SE(VAZIO(campo); ...) para decidir o que fazer.
- Aparece que o campo não existe - o nome entre chaves não está na lista. Clique no campo, abaixo da fórmula, em vez de digitar. Campo adicional se escreve como {{campo.chave}}.
- Aparece que a função não existe - só valem as funções da lista "Funções aceitas". Não existe função própria.
- Aparece "A função ... se escreve assim" - falta ou sobra argumento. A própria mensagem mostra a forma certa.
- Aparece "Faltou fechar o parêntese" ou "Faltou fechar as aspas" - a mensagem diz a posição. Confira os parênteses e as aspas da fórmula.
- Aparece "Compare dois valores por vez. Para mais de uma condição use E(...) ou OU(...)." - a fórmula encadeou comparações. Junte as condições com E ou OU.
- Aparece "Resultado" seguido de "O campo não aceitaria" - o tipo do resultado não combina com o campo de destino (texto em campo numérico, por exemplo). Troque o campo ou ajuste a fórmula.
- A automação rodou e o campo não mudou - a fórmula falhou com os dados daquele negócio, ou o campo recusou o resultado. O campo fica como estava e o motivo aparece em Logs e histórico.
- Não consigo publicar a automação - fórmula com erro de escrita não é salva. A tela mostra a ação e o motivo.
- A fórmula grava no Valor do negócio e um negócio ganho não mudou - valor de negócio já ganho não é alterado.