EntrarTeste grátis

Builder · Atualizado em 06/10/2026

Como configurar ações de um bloco

Adicione ações que o Pipe executa antes ou depois de um bloco: ordem, condições, copiar, colar e testar.

Neste artigo
  1. Quando usar
  2. Pré-requisitos
  3. Passo a passo
  4. O cartão da ação
  5. Copiar, colar e excluir várias ações
  6. Exemplo na Loja Girassol
  7. Resultado esperado
  8. Boas práticas
  9. Limitações
  10. Problemas comuns
  11. Próximos passos
  12. Perguntas frequentes

Ações são tarefas que o Pipe executa sem que o contato perceba: guardar um dado, chamar um serviço, registrar um evento. Em cada bloco você escolhe se a ação roda antes ou depois do conteúdo.

Quando usar

Use uma ação quando o bloco precisa fazer algo além de conversar. Exemplos comuns: guardar a escolha do contato em uma variável, consultar o status de um pedido em um serviço externo ou registrar que o contato passou por uma etapa. Se a tarefa vale para o fluxo inteiro, prefira as ações globais.

Pré-requisitos

  • Permissão para editar o fluxo no Builder.
  • Um bloco criado. O bloco do tipo Humano não tem a aba Ações: nele, o Pipe avisa que o fluxo não deve interferir nas ações de entrada e saída.
  • Para ações que usam variáveis, saiba os nomes que pretende usar. Veja variáveis no Builder.

Passo a passo

  1. Abra o fluxo na aba Builder e clique no bloco.
  2. No painel do bloco, abra a aba Ações.
  3. Escolha a lista. Ações de Entrada executa antes do envio do primeiro conteúdo; Ações de Saída executa depois do último conteúdo ou da resposta do usuário.
  4. Clique em Adicionar ação de entrada (ou Adicionar ação de saída).
  5. No menu ADICIONAR FERRAMENTAS, escolha a ação. As opções estão em dois grupos: Executar e Manipular.
  6. Preencha os campos da ação. Os campos obrigatórios têm asterisco e ficam destacados enquanto estiverem vazios. Os campos de cada ação estão em ações disponíveis.
  7. Se quiser, dê um Nome da ação para reconhecê-la na lista.
  8. Para executar a ação só em certos casos, role até Condição para executar a ação e clique em + Adicionar condição de execução.
  9. Para mudar a ordem, use as setas Subir e Descer do cartão ou arraste o cartão. As ações rodam na ordem da lista.
  10. Teste o fluxo. No painel de teste, a seção Ações executadas mostra cada ação do bloco e o erro, se houver.
Painel de ações de um bloco no Builder

O cartão da ação

Cada ação aparece como um cartão na lista. Os sinais do cartão ajudam a revisar o bloco antes de publicar.

Sinal ou controleSignificado
Etiqueta ErroHá campo obrigatório vazio ou valor inválido na ação.
Etiqueta Não executada no PipeA ação depende de um serviço externo e não deve ser usada sem validação.
Opções da açãoAbre o menu com Detalhes da ação, Copiar ação e Excluir ação.
Subir e DescerMudam a posição da ação na lista.
Contador no título da listaMostra quantas ações existem, de 15 possíveis.

Copiar, colar e excluir várias ações

  1. Marque a caixa de cada ação desejada, ou Selecionar todos.
  2. Clique em Copiar selecionados para guardar as ações, ou em Deletar selecionados para removê-las.
  3. Abra outro bloco e clique em Colar ação. A colagem cria cópias independentes das originais.

Se a colagem passar de 15 ações na lista, nada é colado e o Pipe mostra o aviso de limite.

Exemplo na Loja Girassol

No bloco Pedidos, a Loja Girassol quer guardar o assunto e registrar a consulta.

  1. Em Ações de Entrada, adicione Definir variável com Nome da variável assunto e Valor pedido.
  2. Em Ações de Saída, adicione Registrar eventos com Categoria atendimento e Ação pedido_consultado.
  3. Nos detalhes da ação de saída, adicione a condição de execução: fonte Variável assunto, comparação Igual a, valor pedido.

Assim o evento só é registrado quando o assunto foi mesmo pedido.

Resultado esperado

As ações aparecem nas listas do bloco, sem a etiqueta Erro. No teste, a seção Ações executadas mostra cada uma na ordem configurada, e as variáveis definidas aparecem em Variáveis.

Boas práticas

  • Use ações de entrada para preparar dados que o conteúdo do bloco vai usar. Use ações de saída para registrar o que aconteceu.
  • Mantenha poucas ações por bloco. Cada ação que chama um serviço externo aumenta o tempo da resposta ao contato.
  • Revise o tempo limite das ações em Configuração, aba Variáveis, seção TEMPO LIMITE DE AÇÕES. Sem valor definido, cada ação tem 30 segundos, e o processamento de uma mensagem inteira é limitado a 60 segundos.

Limitações

  • Cada lista aceita até 15 ações.
  • Ações marcadas como Não executada no Pipe não são garantidas em um fluxo publicado.
  • Em subfluxos, as ações Redirecionar para serviço e Consultar Assistente de conteúdo não aparecem no menu.

Problemas comuns

  • A etiqueta Erro aparece no cartão: abra os detalhes e preencha os campos com asterisco. Para variáveis, use apenas letras, números e pontos no nome.
  • A ação não parece ter efeito: confira o momento (entrada ou saída), se o caminho do teste passa pelo bloco e se a condição de execução foi cumprida.
  • Limite de 15 ações atingidos: remova ações que não são mais necessárias ou mova parte da lógica para outro bloco.
  • Não consigo colar: não há ações copiadas, ou a colagem ultrapassaria o limite da lista.

Próximos passos

Perguntas frequentes

Qual a diferença entre ação de entrada e de saída?

A ação de entrada roda antes do envio do primeiro conteúdo do bloco. A ação de saída roda depois do envio do último conteúdo ou da resposta do usuário.

Quantas ações cabem em um bloco?

Até 15 em cada lista, a de entrada e a de saída. Ao tentar passar disso, o Pipe mostra o aviso Limite de 15 ações atingidos.

Posso executar uma ação só em certos casos?

Sim. Dentro dos detalhes da ação, use Condição para executar a ação e Adicionar condição de execução.

Posso reaproveitar ações em outro bloco?

Sim. Selecione as ações, clique em Copiar selecionados, abra o outro bloco e use Colar ação.