Variável global

A Variável global e um valor unico para toda a empresa — diferente de campos personalizados, que tem um valor por lead.

Uso mais comum: medir etapas do funil — quantos leads passaram pelo comeco, meio e fim. Voce cria uma variavel por etapa, incrementa em pontos-chave do fluxo, e ve onde os clientes estao caindo. Veja Variável global em fluxos para o passo a passo.

Tambem funciona para flags da empresa (promo_ativa), escassez finita (cupons_disponiveis) e estado compartilhado entre fluxos.

Onde encontrar

Acesse Configurações > Variável global na barra lateral. A tela lista todas as variaveis criadas com:

Coluna	O que mostra
Nome	Identificador da variavel (snake_case).
Descrição	Para que ela serve.
Valor	Valor atual (atualizado em tempo real conforme fluxos rodam).
Ações	Menu ⋮ com opcao de excluir.

Criar uma variavel global

1. Clique em Variável no canto superior direito.

2. No modal Crie uma variável global, preencha:

   

   Campo	Obrigatorio	Detalhes
   Nome	Sim	snake_case, sem espaco (ex: contador_leads, total_vendas).
   Tipo	Sim	Número (default) ou Texto.
   Descrição	Sim	Explica o que a variavel armazena. Sem descricao, o botao Criar nao funciona.
   Valor inicial	Opcional	Para tipo Número, use ponto para decimais. Deixe vazio para comecar zerado.

   

3. Clique em Criar.

A variavel passa a existir e pode ser usada em qualquer fluxo da conta.

Editar uma variavel? Nao da

Atencao: variaveis globais nao tem opcao de editar. O menu ⋮ da linha tem so Excluir.

Para alterar o valor, use o bloco Variável global dentro de um fluxo (acoes como Somar, Subtrair, Setar).

Para alterar nome ou descricao, voce precisa excluir e recriar. Atencao: se houver fluxos usando a variavel antiga, eles ficarao orfaos.

Excluir uma variavel

1. Clique no menu ⋮ da linha da variavel.
2. Selecione Excluir.
3. O Sagazchat pede confirmacao: “Apagar Variável global? Deseja realmente excluir essa Variável?”
4. Clique em Deletar.

Se a variavel estiver sendo usada em fluxos, os fluxos quebram. Verifique antes de excluir.

Usar em fluxos

Variáveis globais aparecem no bloco Variável global do Flowbuilder. Veja Variável global em fluxos para os detalhes de uso, acoes (Somar/Subtrair/Setar) e exemplos.

Boas praticas

• Nomenclatura snake_case: contador_leads, cupons_disponiveis, meta_mes.
• Prefixo por contexto: contador_*, meta_*, flag_*.
• Descricao clara: como a variavel e usada e o que o valor significa. Como nao da pra editar, escrever bem agora vale ouro depois.
• Defina valor inicial: para tipo Numero, comecar em 0 evita ifs no fluxo.
• Tipo Texto para flags (promo_ativa: "sim", modo_atendimento: "ferias") ou rotacao (proximo_atendente: "bruna").

Diferenca entre variavel global e campo personalizado

Recurso	Escopo	Exemplo
Variável global	Empresa — um valor para toda a conta.	”Total de vendas hoje” = 47 (mesmo para todos).
Campo personalizado	Lead — cada cliente tem o seu.	”valor_orcamento” do lead X = 1500, do lead Y = 3200.

Veja Campos para entender campos personalizados.