Como Criar Expressões para Execução Condicional de Integrações

Introdução

Este documento serve para ajudar você a compreender e aplicar fórmulas dinâmicas para controlar a execução de integrações em nosso sistema. As fórmulas possibilitam definir condições lógicas baseadas em dados de entrada, que determinam se uma integração será executada ou não.

Padrões de Expressão

As expressões são escritas usando placeholders para dados e operadores lógicos ou de comparação para formular condições. Abaixo estão os componentes que você pode usar:

Placeholders: Representados por {{}} , identificam dados específicos. Exemplos incluem {{id_da_pergunta}} , {{hidden_field_name}} , {{utm_source}} , e {{variable_name}} . Neste link pode encontrar em [](//suporte.yayforms.com/article/181-guia-de-placeholders-para-personalizacao-de-emails-e-mensagens)Guia para Placeholders*** que pode oferecer mais detalhes sobre como personalizar e-mails e mensagens usando placeholders específicos.
Valores Booleanos:
TRUE : Representa um valor verdadeiro.
FALSE : Representa um valor falso.
Operadores Lógicos:
AND : Conjunção (e).
OR : Disjunção (ou).
NOT : Negação.
Operadores de Comparação:
EQUALS : Igualdade.
CONTAINS : Contém texto.
> : Maior que.
< : Menor que.
>= : Maior ou igual.
<= : Menor ou igual.
Parênteses: Usados para alterar a precedência padrão das operações, garantindo que expressões específicas sejam avaliadas primeiro.

Exemplos de Expressões

Expressão Simples
Fórmula: {{629gf8238a124a052r02b98}} EQUALS "sim"
Descrição: A integração é executada se o campo 629gf8238a124a052r02b98 é igual a "value".
Uso de Campo Oculto
Fórmula: {{hidden_field}} EQUALS "iniciante"
Descrição: A integração é executada se um campo oculto contém o valor "secret".
Tracking com UTM
Fórmula: {{utm_source}} EQUALS "google"
Descrição: A integração é executada se o parâmetro UTM de origem é "google".
Condição com Variável
Fórmula: {{score}} EQUALS "10"
Descrição: A integração é executada se uma variável específica está definida como "active".
Expressão Composta com Parênteses
Fórmula: ({{629gf8238a124a052r02b81}} > 20 AND {{629gf8238a124a052r02b98}} < 30) OR ({{utm_campaign}} EQUALS "launch" AND NOT {{email}} CONTAINS "@gmail.com")
Descrição: A integração é executada se a pergunta 629gf8238a124a052r02b81 é maior que 20 e a pergunta 629gf8238a124a052r02b98 é menor que 30, ou se o parâmetro UTM da campanha é "launch" e um campo oculto não contém "@gmail.com".

OBS: Você pode encontrar o ID de uma pergunta na tela de edição do formulário acessando as configurações do próprio campo. Basta selecionar o campo desejado e localizar o ID na seção de configurações, conforme mostrado na imagem abaixo.



Aqui está um exemplo de como enviar uma conversão personalizada para a Meta:

Conclusão

Utilize este guia como uma referência ao definir condições para execução de suas integrações. A compreensão e o uso correto dos operadores, especialmente dos parênteses, são essenciais para criar lógicas de controle eficazes e seguras.

Atualizado em: 24/02/2025