Como criar expressões para execução condicional de integrações

Este guia ajudará você a compreender e aplicar fórmulas dinâmicas para controlar quando as suas integrações devem (ou não) ser executadas no nosso sistema.

Através dessas fórmulas, você pode criar condições lógicas baseadas nas respostas e dados dos seus usuários, garantindo que a integração só seja disparada no momento certo.

1. Como funcionam as expressões?

As expressões são criadas combinando Placeholders (que representam os dados que você coletou) com Operadores (que criam as regras e comparações).

🏷️ Placeholders (Dados)

Os placeholders são os identificadores dos seus dados. Eles sempre começam com o símbolo @. Alguns exemplos comuns incluem:

@campo1 Perguntas do formulário. Onde "campo1" é só um exemplo, o que na prática exibiria o título de uma de suas questões.

@hiddenfield Campos ocultos. Pode ser qualquer um dos campos ocultos criados na aba "Compartilhar" do formulário.

@utm_source Parâmetros de rastreamento UTM. Pode ser qualquer um dos parâmetros UTM, caso você tenha habilitado o rastreamento de parâmetros UTM na aba "Compartilhar" do formulário.

@variable_name Variáveis do sistema. Qualquer uma das variáveis criadas na aba "Lógica" da tela de edição do formulário. Por padrão, todos os formulários incluem a variável "score" que você pode usar para lead scoring por exemplo.

💡 Dica de Ouro: Na hora de montar sua expressão na plataforma, você só precisa digitar o símbolo @. Imediatamente, um menu suspenso aparecerá listando todos os campos, parâmetros e variáveis disponíveis para você selecionar facilmente.

2. Componentes da Fórmula

Para criar as suas regras, você utilizará os seguintes elementos:

Operadores de Comparação

Servem para comparar o seu placeholder com um valor específico:

EQUALS Exatamente igual a.
CONTAINS Contém o texto especificado.
> Maior que.
< Menor que.
>= Maior ou igual a.
<= Menor ou igual a.
ISEMPTY(@SeuCampo) O campo está vazio.
ISNOTEMPTY(@SeuCampo) O campo não está vazio (foi preenchido).

Operadores Lógicos

Servem para combinar múltiplas regras:

AND E (Todas as condições precisam ser verdadeiras).
OR OU (Apenas uma das condições precisa ser verdadeira).
NOT NÃO (Inverte a regra, negando uma condição).

Valores Booleanos

TRUE Verdadeiro.
FALSE Falso.

Parênteses ( )

Assim como na matemática, os parênteses servem para agrupar condições e definir a prioridade. O que está dentro dos parênteses é avaliado primeiro pelo sistema.

3. Exemplos Práticos

Abaixo, veja como combinar esses elementos em cenários reais:

ISNOTEMPTY(@campo1) AND ISNOTEMPTY(@campo2)
A integração só roda se o campo1 E o campo2 foram preenchidos (não estão vazios).

@campo1 EQUALS "Yes"
A integração só roda se a resposta do campo1 for exatamente "Yes". Em campos do tipo Sim/Não, você poderia usar essa condição.

@campo1 CONTAINS "Mais que"
A integração só roda se a resposta do campo1 contém "Mais que". Ou seja, se o usuário marcar a opção "Mais que 5.000", por exemplo, essa condição será satisfeita.

@hidden_field EQUALS "iniciante"
A integração roda se o campo oculto capturar o valor "iniciante".

@utm_source EQUALS "google"
A integração roda se o usuário veio de uma campanha onde a origem é "google".

NOT (@utm_source EQUALS "google")
A integração roda se o usuário veio de uma campanha onde a origem NÃO é "google".

@score >= "10"
A integração roda se a variável de pontuação atingir 10 ou mais.

(@campo1 > 20 AND @campo2 < 30) OR (@utm_campaign EQUALS "launch")
A integração roda SE o campo1 for maior que 20 E o campo2 for menor que 30. Ela também roda SE a campanha UTM for "launch", independente dos campos anteriores.

Conclusão

Utilize este guia sempre que precisar estruturar suas regras de integração. Lembre-se de que o uso correto dos operadores e, principalmente, dos parênteses para agrupar regras complexas, é o segredo para criar fluxos eficientes e à prova de falhas.a