Funções personalizadas

Funções personalizadas ampliam as transformações de dados no editor de cenários. Elas são escritas em JavaScript e pertencem a uma equipe.

A documentação de funções personalizadas, consultada em 26 de setembro de 2026, apresenta o recurso como disponível para clientes Enterprise. Essa condição de acesso vem antes das permissões de equipe: Team Member pode visualizar e usar funções, enquanto Team Admin é necessário para criar e editar. O Make oferece suporte à infraestrutura, mas não à escrita e depuração do código personalizado.

Criar uma função

1. Abra Functions na barra lateral ou em três pontos > Functions.
2. Clique em + Add a function.
3. Preencha Name e Description e salve.
4. Escreva a função com nome, parâmetros, corpo entre chaves e retorno.
5. Salve novamente.

Depois do primeiro salvamento, a função fica disponível no editor de cenários, com um ícone que a distingue das funções nativas.

Estrutura e exemplo

A referência pede cabeçalho, corpo e uma instrução de retorno. Este exemplo vem do próprio guia:

function helloWorld() {
  return "Hello world!";
}

Ambiente de execução

A documentação consultada em 26 de setembro de 2026 descreve JavaScript ES6 executado no backend do Make, não no navegador. Não oferece bibliotecas de terceiros nem recursos próprios do ambiente de navegador.

A referência exige código síncrono e não admite requisições HTTP, chamadas de outras funções personalizadas ou recursão dentro da função. Há também um limite de tempo por execução e um limite de caracteres no código. Antes de salvar, confira os valores em Limitations of custom functions: são restrições do ambiente de execução, não condições inferidas do preço ou do papel de administrador. Não reproduzimos os números aqui; prevalece essa documentação técnica.

Para usar um valor calculado com um Iterator, a fonte orienta calculá-lo primeiro em Set Variable e mapear a saída desse módulo no Iterator.

Validação e depuração

Salvar não comprova que o código funciona. Segundo a documentação, erros na função aparecem na execução dos cenários que a utilizam e podem fazer essas execuções falharem.

Use a console de depuração abaixo do editor para executar o código. Confira os argumentos e o valor retornado antes de depender da função em um cenário.

Usar funções nativas

As funções nativas ficam disponíveis como métodos do objeto iml. O exemplo oficial usa length:

function useBuiltInFunction(text) {
  return iml.length(text);
}

Datas

A documentação informa que o processamento de datas considera o fuso horário definido para a organização. Tenha esse contexto em mente ao comparar datas e horários.

O exemplo abaixo, também da fonte, calcula a diferença absoluta entre dois instantes em dias:

function numberOfDays(start, end) {
  const startDate = new Date(start);
  const endDate = new Date(end);
  return Math.abs(
    (startDate.getTime() - endDate.getTime()) / (1000 * 60 * 60 * 24)
  );
}

Nota editorial: esse cálculo mede duração; não é uma contagem de dias úteis ou feriados. Datas e horários diferentes podem produzir uma fração de dia.

Escolher um item de uma lista

A fonte apresenta o seguinte exemplo para retornar uma saudação aleatória:

function randomGreeting(greetings) {
  const index = Math.floor(Math.random() * greetings.length);
  return greetings[index];
}

Nota editorial: forneça uma lista não vazia. Este guia não relata execução desses exemplos dentro de uma conta Make.

Histórico e restauração

Cada salvamento cria uma versão. Abra a função e a aba History para comparar uma versão com a anterior. Restore this version restaura o conteúdo selecionado criando uma nova versão; não apaga o histórico anterior.

Excluir sem ignorar dependências

1. Abra Functions.
2. Antes de excluir, use três pontos > Edit e consulte a aba Scenarios.
3. Identifique os cenários que utilizam a função.
4. Só depois use três pontos > Delete.

Excluir uma função ainda usada faz o cenário falhar na próxima execução. O erro pode indicar Function not found no campo mapeado. Ajuste as dependências antes de remover a função.

Fonte

Documentação oficial do Make, consultada em 26 de setembro de 2026.