EntrarTeste grátis

Builder · Atualizado em 06/10/2026

Como usar a Biblioteca de funções no Builder

Crie funções reutilizáveis em código, gerencie-as pela aba Ações globais e chame uma delas em qualquer fluxo com a ação Função da biblioteca.

Neste artigo
  1. Quando usar
  2. Pré-requisitos
  3. Campos da função
  4. Passo a passo: criar uma função
  5. Passo a passo: gerenciar as funções
  6. Passo a passo: chamar a função em um bloco
  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

A Biblioteca de funções guarda trechos de código com nome, escritos uma vez e usados em vários fluxos. Ela evita copiar o mesmo script em cada bloco e permite corrigir a lógica em um lugar só.

Quando usar

  • Você faz o mesmo cálculo em vários blocos, como montar um código de rastreio ou formatar um valor.
  • Mais de um fluxo da conta precisa da mesma regra, como validar um CPF de teste ou normalizar um telefone.
  • Você quer que a lógica fique fora do bloco, para quem monta o fluxo só escolher a função pelo nome.

Pré-requisitos

  • Acesso ao Builder de um fluxo da conta.
  • Noção básica de JavaScript, porque a função é escrita em código.

Campos da função

CampoO que informarRegra verificada
NomeO nome com que a função é chamadaIdentificador JavaScript válido e único na biblioteca da conta
DescriçãoUma frase sobre o que a função fazOpcional. Também é usada na busca
ParâmetrosOs valores que a função recebeCada um é um identificador válido, sem repetir. Use + Adicionar parâmetro
Código-fonteO código da funçãoObrigatório, até 65.536 caracteres

O código novo já vem com um modelo, function minhaFuncao() { return; }. Troque o nome do modelo pelo mesmo nome informado no campo Nome, porque é essa função que o Pipe executa.

Passo a passo: criar uma função

  1. No Builder, clique em Configuração na barra lateral esquerda.
  2. Abra a aba Ações globais.
  3. Na seção BIBLIOTECA DE FUNÇÕES, clique em Criar função.
  4. Preencha Nome e, se quiser, Descrição.
  5. Em Parâmetros, clique em + Adicionar parâmetro e digite o nome de cada um, em Nome do parâmetro.
  6. Em Código-fonte, escreva a função. Ela deve devolver o valor com return.
  7. Clique em Salvar. O aviso "Função criada." confirma.

Se algum campo estiver inválido, o Pipe mostra a mensagem acima do botão, como "O nome precisa ser um identificador JavaScript válido." ou "Já existe uma função com esse nome na biblioteca da conta.".

Passo a passo: gerenciar as funções

  1. Na aba Ações globais, clique em Gerenciar funções.
  2. Use o campo Pesquisar função para filtrar por nome ou descrição.
  3. Para alterar, clique no ícone Editar da função e depois em Salvar. O aviso "Função salva." confirma.
  4. Para apagar, clique em Excluir e confirme em Excluir função. O aviso "Função excluída." confirma.

Antes de editar ou excluir, o Pipe verifica se outros fluxos da conta usam a função. Se usarem, aparece um aviso com os nomes (até três, depois "e mais" a quantidade restante). Alterar vale para todos eles. Excluir faz as ações que a chamam deixarem de funcionar nesses fluxos.

Passo a passo: chamar a função em um bloco

  1. Abra o bloco e vá para a aba Ações.
  2. Em AÇÕES DE ENTRADA ou AÇÕES DE SAÍDA, clique em Adicionar ação de entrada (ou de saída).
  3. Escolha Função da biblioteca, no grupo Executar.
  4. Em Definição da função, escolha a função da lista ou clique em + Criar função.
  5. Em Variáveis de entrada, informe uma variável para cada parâmetro, na mesma ordem.
  6. Em Variável para o valor de retorno, informe o nome da variável que vai guardar o resultado.
  7. Use a variável nas mensagens ou nas condições de saída, como {{context.nomeDaVariavel}}.

Em ações de script, o campo de código tem o botão Inserir função da biblioteca. Ele escolhe uma função e escreve a chamada, nome(parametro1, parametro2), no início da função principal do script. Parâmetros que ainda não existiam nela são acrescentados à assinatura.

Exemplo na Loja Girassol

A Loja Girassol quer mostrar o prazo de entrega em texto. Marcela cria a função prazoEmTexto, com o parâmetro dias, que devolve "1 dia útil" ou "3 dias úteis". Em Ações de entrada do bloco "Número do pedido", ela adiciona Função da biblioteca, escolhe prazoEmTexto, informa a variável de entrada com o número de dias e guarda o resultado em prazoTexto. A mensagem do bloco passa a dizer "Seu pedido chega em {{context.prazoTexto}}.". Outro fluxo da conta reaproveita a mesma função.

Resultado esperado

A função aparece em Gerenciar funções e pode ser escolhida em Definição da função. Ao testar o fluxo, a variável de retorno recebe o valor devolvido. Veja como testar um fluxo.

Boas práticas

  • Dê um nome claro e escreva a descrição, para que a busca ache a função.
  • Mantenha a função curta, com uma única responsabilidade.
  • Teste depois de editar, porque a mudança vale para todos os fluxos que a usam.
  • Evite excluir uma função em uso. Crie outra e troque as ações antes.

Limitações

  • O retorno é guardado como texto na variável de saída.
  • A biblioteca pertence à conta e não é separada por fluxo.
  • A tela carrega até 100 funções por vez. Use a busca para achar uma específica.

Problemas comuns

  • "O nome precisa ser um identificador JavaScript válido.": retire espaços, acentos e símbolos do nome.
  • "Já existe uma função com esse nome na biblioteca da conta.": escolha outro nome ou edite a função existente.
  • "A função esperava N parâmetro(s).": o número de variáveis de entrada não bate com o de parâmetros. Ajuste a lista.
  • A função não está na biblioteca da conta: o fluxo foi importado e a ação aponta para um identificador que não existe aqui. Crie a função de novo pelo botão + Criar função na própria ação.
  • A função demora e falha: simplifique o código. O limite é de 10 segundos.

Próximos passos

Perguntas frequentes

A função vale só para o fluxo que estou editando?

Não. A biblioteca pertence à conta. Todos os fluxos veem as mesmas funções, e alterar uma função muda o comportamento em todos eles.

Que nome posso dar à função?

Um identificador JavaScript válido: sem espaços e sem começar por número. Cada nome só pode existir uma vez na biblioteca da conta.

Posso excluir uma função que está em uso?

Pode, mas as ações que a chamam deixam de funcionar. O Pipe mostra um aviso com os fluxos que a usam antes de você confirmar.

Quanto tempo a função pode demorar?

A execução tem limite de 10 segundos por chamada.

O que acontece se eu passar a quantidade errada de variáveis de entrada?

A ação falha com a mensagem de que a função esperava determinada quantidade de parâmetros. Informe uma variável para cada parâmetro.