EntrarTeste grátis

Builder · Atualizado em 06/10/2026

Como ajustar as configurações gerais de um fluxo

Defina a expiração da sessão, o tempo limite das ações, a confiabilidade de intenções e as variáveis de configuração na aba Variáveis do Builder.

Neste artigo
  1. Quando usar
  2. Pré-requisitos
  3. Passo a passo: abrir as configurações
  4. Seções da aba Variáveis
  5. Passo a passo: expiração da sessão
  6. Passo a passo: tempo limite de ações
  7. Passo a passo: confiabilidade de IA
  8. Passo a passo: variáveis de configuração
  9. Exemplo na Loja Girassol
  10. Resultado esperado
  11. Boas práticas
  12. Limitações
  13. Problemas comuns
  14. Próximos passos
  15. Perguntas frequentes

A aba Variáveis da Configuração reúne os ajustes que valem para o fluxo inteiro, e não para um bloco só. Aqui você controla por quanto tempo a conversa é lembrada, quanto uma ação pode demorar e quais valores fixos o fluxo pode usar nas mensagens.

Quando usar

  • A conversa precisa recomeçar do início se o contato sumir por um tempo.
  • Uma ação, como uma requisição, costuma demorar mais do que o padrão.
  • Um valor se repete em várias mensagens e muda de vez em quando, como o link da loja ou o horário de funcionamento.
  • Você quer ajustar o quanto o fluxo confia ao reconhecer a intenção de uma mensagem.

Pré-requisitos

  • Acesso ao Builder do fluxo, com permissão para editar o rascunho.

Passo a passo: abrir as configurações

  1. No Builder, clique em Configuração na barra lateral esquerda.
  2. O painel Configurações gerais abre com três abas: Variáveis, Versões e Ações globais.
  3. Fique na aba Variáveis.
  4. Clique no título de uma seção para abri-la ou fechá-la.

Seções da aba Variáveis

SeçãoO que fazDisponível
CONFIABILIDADE DE IAPercentual mínimo de confiança para uma intenção ser aceita como resposta válidaSim
TRACKING AUTOMÁTICORegistrar um evento a cada blocoNão disponível no Pipe
UTILIZAR CONTEXTO DO ROTEADORUsar dados do roteador nas açõesNão disponível no Pipe
EXPIRAÇÃO DA SESSÃOTempo de inatividade até a conversa voltar ao inícioSim
TEMPO LIMITE DE AÇÕESTempo máximo de cada açãoSim
IDENTIFICADOR DO FLUXOMostra o identificador do fluxoSomente leitura
VARIÁVEIS DE CONFIGURAÇÃOValores fixos usados como {{config.Nome}}Sim
VARIÁVEIS SENSÍVEISSegredos usados como {{secret.Nome}}Sim

As seções marcadas com a etiqueta Não disponível no Pipe aparecem na tela, mas o controle fica desabilitado. Elas não têm efeito no fluxo.

Passo a passo: expiração da sessão

  1. Abra a seção EXPIRAÇÃO DA SESSÃO.
  2. No campo Expiração da sessão, digite o tempo em segundos, por exemplo 3600 para uma hora.
  3. O Pipe guarda o valor no rascunho.

O tempo conta a inatividade do contato, e não o tempo parado em um bloco: cada mensagem renova a sessão. Quando ela expira, o contato volta ao estado inicial do fluxo. Se o campo ficar vazio, a sessão não expira.

Passo a passo: tempo limite de ações

  1. Abra a seção TEMPO LIMITE DE AÇÕES.
  2. No campo Tempo limite de ações, digite os segundos.
  3. Apague o valor para voltar ao padrão.

O padrão é 30 segundos por ação. O tempo total para processar uma mensagem é limitado a 60 segundos, então valores acima disso não ampliam o limite global.

Passo a passo: confiabilidade de IA

  1. Abra a seção CONFIABILIDADE DE IA.
  2. Arraste o controle deslizante. O valor aparece em porcentagem, de 0% a 100%. O padrão é 50%.

O motor só considera uma intenção quando a pontuação é igual ou maior que esse percentual. Valores altos exigem mais certeza. Valores baixos aceitam intenções com menos certeza. Esse ajuste importa quando as condições de saída usam Intenção identificada.

Passo a passo: variáveis de configuração

  1. Abra a seção VARIÁVEIS DE CONFIGURAÇÃO.
  2. Clique em + Adicionar informações extras.
  3. No campo Variável, digite o nome. Use só letras e números, sem espaços, acentos ou símbolos. Nomes inválidos ficam destacados e não são salvos.
  4. No campo Valor, digite o conteúdo.
  5. Para mudar o valor depois, edite o campo Valor da linha. Para apagar, use o botão de remover da linha.
  6. Nas mensagens e nas ações, escreva {{config.NomeDaVariavel}}.

Para segredos, como senhas e chaves, use VARIÁVEIS SENSÍVEIS, que guarda o valor sem exibi-lo. Veja variáveis sensíveis.

Exemplo na Loja Girassol

A Loja Girassol quer que a conversa recomece depois de duas horas sem resposta. Marcela abre EXPIRAÇÃO DA SESSÃO e digita 7200. Em VARIÁVEIS DE CONFIGURAÇÃO, cria LinkLoja com o endereço do site fictício e passa a escrever "Veja nossos produtos em {{config.LinkLoja}}" nas mensagens. Quando o endereço mudar, ela altera o valor uma vez.

Resultado esperado

As seções ficam com os valores definidos no rascunho. Ao testar, as mensagens mostram o valor das variáveis de configuração. Veja como testar um fluxo.

Boas práticas

  • Defina a expiração da sessão de acordo com o seu atendimento. Fluxos de vendas costumam pedir tempos mais curtos que os de suporte.
  • Mantenha o tempo limite de ações no padrão, a menos que uma ação realmente demore.
  • Use nomes de variáveis de configuração claros, como LinkLoja.
  • Teste depois de mudar o tempo de sessão.

Limitações

  • As seções TRACKING AUTOMÁTICO e UTILIZAR CONTEXTO DO ROTEADOR aparecem como Não disponível no Pipe e não funcionam.
  • IDENTIFICADOR DO FLUXO é somente leitura, e o botão Redefinir identificador do fluxo está desabilitado.
  • Os nomes das variáveis de configuração aceitam apenas letras e números.
  • O tempo total de uma mensagem não passa de 60 segundos.

Problemas comuns

  • O nome da variável fica vermelho: há espaço, acento ou símbolo. Deixe só letras e números.
  • A mensagem mostra {{config.Nome}} literalmente: o nome está diferente do cadastrado. Confira maiúsculas e minúsculas.
  • A sessão não expira: o campo está vazio. Digite os segundos.
  • A mudança não aparece para os contatos: o rascunho ainda não foi publicado.

Próximos passos

Perguntas frequentes

Onde ficam as configurações do fluxo?

No Builder, em Configuração, na aba Variáveis. Cada assunto é uma seção que abre e fecha.

O que acontece quando a sessão expira?

O contato volta ao estado inicial do fluxo na próxima mensagem. Se o campo ficar vazio, a sessão não expira.

Qual o tempo limite padrão de uma ação?

30 segundos. O tempo total de processar uma mensagem continua limitado a 60 segundos, mesmo que você coloque um valor maior.

Como uso uma variável de configuração numa mensagem?

Escreva {{config.NomeDaVariavel}}. O nome aceita só letras e números, sem espaço, acento ou símbolo.

Preciso publicar depois de mudar?

Sim. A mudança entra no rascunho do fluxo e só vale para os contatos depois de publicar.