Variável global em fluxos

A Variável global e compartilhada entre todos os fluxos da conta. Diferente de um campo personalizado (que e por lead), a variavel global e unica para a empresa.

Para que serve no dia a dia: o uso mais comum e medir etapas do funil — quantos leads passaram pelo comeco, meio e fim de uma jornada. Cada ponto-chave do fluxo incrementa um contador, e em qualquer momento voce ve onde os leads estao caindo.

Para criar variaveis, va em Configurações > Variável global.

Como usar no Flowbuilder

No editor de fluxo, ha um bloco chamado Variável global. Ele recebe uma variavel ja criada e executa uma acao sobre ela.

Acoes disponiveis (tipo Numero)

• Somar — incrementa o valor (+1, +50.5, etc).
• Subtrair — decrementa.
• Setar — substitui o valor atual.

Acoes disponiveis (tipo Texto)

• Setar — substitui o texto.

Se a variavel ainda nao foi criada em Configurações > Variável global, ela nao aparece no combobox do bloco. Crie primeiro, depois volte ao fluxo.

Caso de uso principal: medir etapas do funil

Voce monta um fluxo de venda em varias etapas (entrada → qualificacao → proposta → fechamento). Sem variavel global, voce nao tem como saber onde os leads estao caindo — quantos chegaram, quantos passaram da qualificacao, quantos foram ate a proposta.

Solucao: uma variavel global por etapa. Cada bloco Variável global em um ponto-chave do fluxo soma +1.

1. Em Configurações > Variável global, crie:

   • funil_entrada (Numero, valor inicial 0)
   • funil_qualificou (Numero, valor inicial 0)
   • funil_proposta (Numero, valor inicial 0)
   • funil_fechou (Numero, valor inicial 0)

2. No fluxo de venda, adicione bloco Variável global em cada etapa:

   • Logo no inicio (apos saudacao): funil_entrada + 1
   • Depois das 5 perguntas de qualificacao: funil_qualificou + 1
   • Quando o cliente recebe a proposta: funil_proposta + 1
   • Quando o cliente confirma fechamento: funil_fechou + 1

3. A qualquer momento, abra Configurações > Variável global e veja os contadores em tempo real. Se funil_entrada=180 e funil_qualificou=24, voce sabe que 87% dos leads desistem antes de qualificar.

Esse e o uso para o qual variavel global foi mais desenhada — funciona como um painel de funil rudimentar dentro do Sagazchat.

Outros casos de uso (menos comuns)

• Limite finito (cupons_disponiveis decrementa a cada uso, Condição verifica se > 0) — escassez real.
• Flag operacional (promo_ativa texto: "sim"/"nao") — admin liga/desliga em um lugar, fluxos consultam.
• Estado compartilhado entre fluxos diferentes — contador que e somado em Fluxo A e lido em Fluxo B.

Para rotacionar atendentes entre Bruna e Dayane, use o bloco Distribuidor, nao variavel global. E o que ele foi desenhado para fazer.

Diferenca entre variavel global, campo personalizado e campo do sistema

Tipo	Escopo	Onde criar	Editavel?	Exemplo
Variável global	Empresa	Configurações > Variável global	Apagar e recriar	total_vendas_mes = 47
Campo personalizado	Lead	Bate Papo OU bloco Salvar/Manipulador	Sim (valor por lead)	cidade_lead = “São Paulo”
Campo do sistema	Lead	Ja existe — pre-definido	Nao (do produto)	nome, email, saudacao

Atencao: variavel deve existir antes do fluxo rodar

Erro comum: configurar o bloco Variável global referenciando uma variavel que ainda nao existe. O combobox do bloco lista so as variaveis ja criadas. Sem variavel cadastrada, voce nao consegue selecionar.

Fluxo correto:

1. Pensa o nome da variavel.
2. Cria em Configurações > Variável global com tipo e valor inicial.
3. Abre o fluxo, adiciona bloco Variável global, seleciona a variavel.
4. Configura acao (Somar, Subtrair, Setar) e valor.
5. Salva o fluxo.

Boas praticas em fluxos

• Inicialize com 0 variaveis numericas para evitar null em soma/subtracao.
• Use Condicao antes de operar se a variavel for crítica (ex: nao subtrair cupons_disponiveis se ja for 0).
• Documente o uso na descricao da variavel — daqui um ano voce nao vai lembrar pra que serve var_x.
• Nao crie variavel por lead — para isso, use campo personalizado.

Onde gerenciar

A criacao e exclusao de variaveis ficam em Configurações > Variável global.