EntrarTeste grátis

Builder · Atualizado em 06/10/2026

Ações disponíveis no Builder do Pipe

Consulte cada ação do Builder, para que serve, quais campos exige e quais dependem de serviço externo.

Neste artigo
  1. Quando usar
  2. Pré-requisitos
  3. Como escolher e configurar
  4. Ações do grupo Executar
  5. Ações do grupo Manipular
  6. Ações que dependem de serviço externo
  7. Exemplo na Loja Girassol
  8. Resultado esperado
  9. Boas práticas
  10. Limitações
  11. Problemas comuns
  12. Próximos passos
  13. Perguntas frequentes

Este guia lista as ações que o menu ADICIONAR FERRAMENTAS oferece, o que cada uma faz e quais campos exige. Para aprender a adicionar ações a um bloco, veja como configurar ações de um bloco.

Quando usar

Consulte este catálogo antes de escolher uma ação. Ele ajuda a decidir qual ação resolve a tarefa, quais campos preencher e quais ações exigem cuidado por depender de um serviço fora do Pipe.

Pré-requisitos

  • Permissão para editar um fluxo no Builder.
  • Um bloco aberto, para ações locais, ou a aba Ações globais em Configuração, para ações do fluxo inteiro.

Como escolher e configurar

  1. Abra o fluxo na aba Builder e clique em um bloco.
  2. Na aba Ações, clique em Adicionar ação de entrada ou Adicionar ação de saída.
  3. No menu ADICIONAR FERRAMENTAS, escolha uma ação do grupo Executar ou Manipular.
  4. Preencha os campos. Os que têm asterisco são obrigatórios.
  5. Teste um caminho que passe pelo bloco antes de publicar.
Painel de um bloco Agente de IA, com as abas Instruções, Condições de saída e Ações

Ações do grupo Executar

AçãoCampos obrigatóriosPara que serve
AI AnswersAssistente, Pergunta do usuário, Identidade do contatoEnvia a pergunta do contato a um assistente de IA e guarda a resposta. Os campos vêm preenchidos com a mensagem do contato e a identidade dele.
Redirecionar para serviçoServiçoPassa a conversa a outro serviço. Só funciona em projeto roteador.
Requisição HTTPMétodo HTTP, URLChama um endereço externo. Opcionais: Cabeçalhos, Corpo, Tempo limite (segundos), Variável do status e Variável do corpo.
Enviar mensagem via HTTPURL, Tipo de conteúdo (MIME)Busca um conteúdo por GET e o envia ao contato como mensagem do tipo informado.
Executar scriptCódigo-fonte, Variável para o valor de retornoRoda um trecho de código e guarda o resultado. Tempo máximo de 5 segundos.
Executar script 2.0Código-fonte, Variável para o valor de retornoComo o anterior, com limite de 10 segundos.
Executar templateTemplate, Salvar retornoMonta um texto a partir de um modelo, usando as variáveis de entrada. Não executa código.
Função da bibliotecaDefinição da função, Variável para o valor de retornoExecuta uma função da Biblioteca de funções do fluxo.
Base de conhecimentoNenhumBusca trechos nos documentos da conta. Opcionais: Texto da consulta, Bases, Documentos, Tags, Quantidade de trechos, Confiança mínima e a variável de retorno.

Notas sobre campos:

  • Método HTTP aceita GET, POST, PUT, PATCH e DELETE.
  • Cabeçalhos são pares de chave e valor. Para credenciais, use {{secret.nome}} dentro da requisição HTTP.
  • Variáveis de entrada (scripts, template e função) listam os nomes das variáveis que a ação vai ler.
  • Base de conhecimento: se nada for encontrado, a variável de retorno é removida. Use as comparações Existe e Não existe nas condições de saída para tratar esse caso.

Ações do grupo Manipular

AçãoCampos obrigatóriosPara que serve
Definir contatoNenhumAtualiza dados do contato da conversa: Nome, E-mail, Cidade, Gênero, Documento, Telefone e Extras.
Definir variávelNome da variávelCria ou muda uma variável do fluxo. Campos opcionais: Valor e Expiração (segundos). Use depois como {{context.nome}}.
Excluir variávelNome da variávelRemove uma variável do fluxo.
Registrar eventosCategoria, AçãoRegistra um evento para acompanhamento. Opcionais: Rótulo, Valor, Extras e Continuar sem aguardar. Os eventos são agrupados por categoria, ação e dia.

O nome de variável aceita letras, números e pontos.

Ações que dependem de serviço externo

As ações abaixo aparecem no menu com a etiqueta Não executada no Pipe no cartão. Elas representam recursos que dependem de um serviço fora do Pipe. Este guia explica o que cada uma faz, sem instruções de configuração, porque ainda não há exemplos testados.

  • Enviar comando: envia um comando a um serviço, sem esperar resposta.
  • Processar comando: envia um comando e guarda a resposta em uma variável.
  • Gerenciar lista de distribuição: adiciona ou remove o contato de uma lista de distribuição.
  • Definir memória: guarda um documento associado ao contato, com expiração opcional.
  • Consultar Assistente de conteúdo: procura uma resposta em uma base de conhecimento e guarda o texto em uma variável.

Exemplo na Loja Girassol

A Loja Girassol consulta o status de um pedido em um sistema próprio.

  1. Em Ações de Entrada do bloco Pedidos, adicione Requisição HTTP.
  2. Em Método HTTP, escolha GET. Em URL, informe https://api.lojagirassol.example/pedidos/{{context.numeroPedido}}.
  3. Em Variável do status, digite statusHttp. Em Variável do corpo, digite respostaPedido.
  4. Na mensagem do bloco, use {{context.respostaPedido}}.
  5. Em Condições de saída, envie para o atendimento humano quem tiver statusHttp diferente de 200.

Resultado esperado

A ação aparece na lista do momento escolhido, sem a etiqueta Erro. No teste, a seção Ações executadas lista a ação na ordem certa, e as variáveis de retorno aparecem em Variáveis.

Boas práticas

  • Dê um nome de variável de retorno que diga o que ela contém, como respostaPedido.
  • Trate o caso de falha: use o status de uma requisição em uma condição de saída.
  • Guarde chaves em variáveis sensíveis. Veja variáveis sensíveis.

Limitações

  • Cada lista de ações aceita até 15 ações.
  • Segredos {{secret.nome}} só têm valor dentro de ações de requisição HTTP. Em outros lugares, o valor lido é vazio.
  • A requisição HTTP e os scripts têm tempo limite. Sem configuração, uma ação tem 30 segundos.
  • Ações com a etiqueta Não executada no Pipe não têm execução garantida.

Problemas comuns

  • Campo obrigatório vazio: volte ao cartão da ação e preencha os campos com asterisco.
  • Variável de retorno vazia: confira se o nome digitado é igual ao usado depois, e veja a resposta do serviço no teste.
  • A requisição não responde a tempo: reduza o trabalho do serviço ou aumente o limite em Configuração, seção TEMPO LIMITE DE AÇÕES, respeitando o limite de 60 segundos por mensagem.
  • O script retorna erro: revise o código e as variáveis de entrada; o erro aparece ao lado da ação no painel de teste.

Próximos passos

Perguntas frequentes

Posso colocar qualquer ação em qualquer bloco?

Sim, em qualquer bloco que tenha a aba Ações, nas listas de entrada e de saída. Em subfluxos, Redirecionar para serviço e Consultar Assistente de conteúdo não aparecem no menu.

O que significa a etiqueta Não executada no Pipe?

A ação depende de um serviço externo. O Pipe sinaliza a dependência no cartão e a execução não é garantida sem validar a integração.

Como uso o resultado de uma ação em outro bloco?

Informe um nome de variável no campo de retorno da ação e use esse nome entre chaves duplas, como {{context.nome}}, no restante do fluxo.

Onde coloco senhas e chaves usadas em uma requisição HTTP?

Em variáveis sensíveis. Use o nome da variável como {{secret.nome}} dentro da requisição HTTP, nunca o valor escrito no fluxo.

Qual é o tempo máximo de uma ação?

Sem configuração, 30 segundos por ação, dentro de um limite de 60 segundos para processar uma mensagem. O valor padrão pode ser mudado em Configuração, seção TEMPO LIMITE DE AÇÕES.