Builder · Atualizado em 06/10/2026
Como configurar ações globais do fluxo
Configure ações que valem para o fluxo inteiro, como preparar dados no começo de cada mensagem, e saiba como testá-las.
Ações globais são as mesmas ações de um bloco, mas valem para o fluxo todo. Elas ficam em um lugar só, em vez de repetidas em cada bloco.
Quando usar
Use ações globais quando a mesma tarefa precisa acontecer em qualquer ponto da conversa. Exemplos: guardar uma informação fixa da loja em uma variável logo no começo, ou registrar um evento a cada mensagem processada. Se a tarefa só importa em um bloco, use as ações de bloco.
Pré-requisitos
- Permissão para editar o fluxo no Builder.
- Conhecimento do que a ação faz. Como ela atinge o fluxo inteiro, um erro aqui afeta todas as conversas. Leia o catálogo de ações.
Passo a passo
- Abra o fluxo na aba Builder.
- Clique em Configuração na barra de ferramentas. O painel se chama Configurações gerais.
- Abra a aba Ações globais.
- Em Ações de Entrada, clique em Adicionar ação de entrada para incluir uma ação que roda no começo do processamento de cada mensagem. Em Ações de Saída, clique em Adicionar ação de saída para uma ação que roda no fim.
- No menu ADICIONAR FERRAMENTAS, escolha a ação e preencha os campos obrigatórios.
- Se a ação só deve rodar em certos casos, adicione uma condição em Condição para executar a ação.
- Feche o painel e abra Testar fluxo em construção para conferir. Na seção Ações executadas, procure o item Ações globais.
Como funcionam
A aba usa o mesmo painel das ações de bloco. Por isso valem as mesmas regras: limite de 15 ações em cada lista, ordem de execução pela lista, condição de execução opcional, copiar, colar e excluir várias ações de uma vez. A diferença é o momento. As ações globais de entrada rodam uma vez no começo do processamento de cada mensagem do contato, antes dos blocos. As globais de saída rodam no fim, depois que o fluxo termina de processar a mensagem. Veja o detalhe das listas em ações de um bloco.
Exemplo na Loja Girassol
A Loja Girassol quer que todo bloco consiga usar o nome da loja.
- Em Configuração, aba Ações globais, clique em Adicionar ação de entrada.
- Escolha Definir variável. Em Nome da variável, digite
lojaNome. Em Valor, digiteLoja Girassol. - Em qualquer bloco, use
{{context.lojaNome}}nas mensagens.
Se o valor mudar no futuro, você altera em um só lugar.
Resultado esperado
A ação aparece na lista da aba Ações globais, sem a etiqueta Erro. No teste, o item Ações globais lista a ação executada, e as variáveis que ela define aparecem em Variáveis.
Boas práticas
- Dê um Nome da ação descritivo, porque o nome aparece na lista e ajuda quem edita depois.
- Prefira poucas ações globais e simples. Cada uma roda em toda mensagem.
- Antes de publicar, teste um caminho curto e confirme que a ação global sozinha entrega o dado que os blocos esperam.
Limitações
- Até 15 ações em cada lista.
- Ações marcadas como Não executada no Pipe dependem de serviço externo e não devem ser usadas sem validação.
- Uma ação global muda dados e executa tarefas, mas não escolhe o caminho da conversa: isso continua sendo feito pelas condições de saída dos blocos.
Problemas comuns
- A variável fica vazia em um bloco: confirme que a ação global está em Ações de Entrada e que o nome da variável é o mesmo usado na mensagem, inclusive maiúsculas e minúsculas.
- O item Ações globais não aparece no teste: envie uma mensagem de teste e role a seção Ações executadas até o final.
- O Builder mostra aviso de limite: a lista chegou a 15 ações. Remova as que não usa mais.
- A etiqueta Erro aparece: abra a ação e preencha os campos obrigatórios.
Próximos passos
Perguntas frequentes
Onde ficam as ações globais?
No Builder, em Configuração, aba Ações globais.
Ação global é diferente de ação de bloco?
A tela e os campos são os mesmos. A diferença é o alcance: a ação global vale para o fluxo inteiro, e a ação de bloco só para aquele bloco.
Existe limite de ações globais?
Sim, até 15 em cada lista, como nos blocos.
Como confiro se a ação global rodou?
No painel de teste, a seção Ações executadas mostra um item chamado Ações globais com as ações que rodaram.
Esse artigo foi útil?
Obrigado pelo retorno!