Como formatar dados na Make

Ao configurar um webhook através da Make para integrar seu formulário com outro serviço, é possível personalizar o mapeamento dos dados usando variáveis - o que permite ajustar as informações conforme suas necessidades.

Neste artigo vamos te ensinar a como utilizar o módulo de ferramentas (Tools) da Make e configurar algumas funções para formatar dados específicos recebidos no formulário, por exemplo:

Como formatar o campo de Telefone para remover o espaço entre o DDI e o DDD;
Como formatar o campo de Nome próprio para separar o Nome e Sobrenome;

Entendendo o módulo de Tools

Na Make, o módulo de "Tools" inclui várias ações úteis que podem melhorar o seu cenário. Entre essas ações, estão as opções de "Set variable" e "Set multiple variables".

Set variable: permite definir uma única variável por vez;
Set multiple variables: possibilita configurar várias variáveis simultaneamente em uma única ação, o que ajuda a manter o cenário mais organizado e eficiente.

Se você deseja mapear mais de um campo do formulário, utilize a ação de "Set multiple variables". Se deseja mapear apenas um campo, recomendamos a ação "Set variable"

Aplicando funções no mapeamento de campos

Ao realizar o mapeamento de campos no Make, é possível aplicar funções para formatar ou transformar dados conforme necessário. Essas funções são úteis para ajustar valores antes de enviá-los para outro módulo ou sistema. Com elas, você pode, por exemplo: converter um texto para letras maiúsculas; cortar ou limitar o tamanho de um texto; transformar uma data para um formato diferente; e várias outras modificações que tornam seu fluxo mais automatizado.

Funções de string: permitem modificar e transformar dados de texto. Por exemplo:
- A função split divide uma string em uma matriz de substrings com base em um delimitador;
- A função replace substitui uma parte da string por outro valor;
Funções gerais: permitem ajustar o mapeamento de dados em um cenário, como selecionar itens específicos ou aplicar condições. Por exemplo:
- A função get acessa um valor específico dentro de um objeto ou array. Importante lembrar que, na Make, o primeiro item de um array tem índice 1 (e não 0, como em outras linguagens).

Além disso, é possível utilizar operadores de texto junto às funções, como:

space (espaço);
newline (quebra de linha);
emptystring (string vazia);

Veja abaixo como aplicar essas funções e variáveis para resolver situações comuns em formulários:

Como formatar o campo de Telefone: removendo o espaço entre o DDI e o DDD

Ao enviar o dado do campo de Telefone do seu formulário para um webhook, o valor costuma ser retornado no formato: 55 51912345678 . No entanto, algumas plataformas de destino exigem esse dado em um formato limpo, ou seja, sem espaços, traços ou outros caracteres especiais, como: 5551912345678 .

Para isso, você pode utilizar uma função de string dentro do módulo de ferramentas (Tools) da Make para remover os espaços do número e garantir que ele seja enviado corretamente para a plataforma de destino.

Para formatar esse dado, depois de configurar seu webhook pela Make, siga os passos abaixo:

Após configurar seu webhook, clique no ícone lilás de "Tools" e selecione a opção de "Set variable";
Arraste o módulo de "Set variable" e conecte-o ao lado do módulo de "Custom webhook";
Clique em cima do módulo "Set Variable" para iniciar a formatação;

No campo "Variable name", insira o nome que deseja dar à variável, por exemplo: Telefone ;
No campo "Variable value", você deve inserir o valor capturado do campo de "Telefone" do formulário, aplicando a função necessária para formatá-lo corretamente;

Para isso, utilize a seguinte estrutura de função: replace( 1.respondent:answers: Qual é o seu telefone? ; space ; emptystring )
Essa função remove todos os espaços da resposta enviada no campo "Qual é o seu telefone?", transformando um número como 55 51912345678 em 5551912345678 .

Após configurar a função, clique em "Save" para salvar as alterações.

Com o dado já formatado no módulo "Tools - Set variable", clique em "Run once" na Make para executar o cenário a receber um dado de teste;
Em seguida, acesse o formulário integrado e preencha todas as respostas, incluindo o campo de telefone;

Esse envio do formulário acionará o webhook, que transmitirá os dados para o módulo de "Tools";

Com o dado agora disponível, adicione o módulo da plataforma que deseja integrar e faça o mapeamento dos campos necessários, utilizando a variável manipulada no módulo "Tools - Set variable";
Por fim, clique em "Save" para salvar o mapeamento dos campos;

Como formatar o campo de Nome próprio: separando o Nome e Sobrenome

Ao enviar o dado do campo de Nome próprio do seu formulário (com a opção de Sobrenome obrigatório habilitada) para um webhook, o valor costuma ser retornado como um único texto - por exemplo: Ana Santos . No entanto, algumas plataformas de destino, podem exigir que o primeiro nome e o sobrenome sejam enviados separadamente, cada um em sua coluna, por exemplo:

Coluna A: Ana

Coluna B: Santos

Para separar nome e sobrenome corretamente antes de enviá-los à plataforma de destino, siga o passo a passo abaixo:

Após configurar seu webhook, clique no ícone lilás de "Tools" e selecione a opção de "Set multiple variables";
Arraste o módulo de "Set multiple variables" e conecte-o ao lado do módulo de "Custom webhook";
Clique em cima do módulo "Set multiple variables" e em "Add item" para iniciar a formatação;

No Item 1, preencha o campo "Variable name" com o nome da variável que será utilizada no mapeamento, por exemplo, Nome ;
No campo "Variable value", adicione o valor correspondente ao campo de "Nome próprio" do formulário, aplicando a função necessária para extrair apenas o primeiro nome;

Para isso, utilize a seguinte estrutura: get( split( 1.respondent:answers: Qual é o seu nome e sobrenome? ; space ) ; 1)

No Item 2, no campo "Variable name", insira o nome da variável que será utilizada no mapeamento, por exemplo, Sobrenome ;
No campo "Variable value", use novamente o valor do campo de "Nome próprio" do formulário e aplique a função necessária para extrair apenas o segundo nome;

Para isso, utilize a seguinte estrutura: get( split( 1.respondent:answers: Qual é o seu nome e sobrenome? ; space ) ; 2)

Com o dado já formatado no módulo "Tools - Set multiple variables", clique em "Run once" na Make para executar o cenário a receber um dado de teste;
Em seguida, acesse o formulário integrado e preencha todas as respostas, incluindo o campo de nome próprio;

Esse envio do formulário acionará o webhook, que transmitirá os dados para o módulo de "Tools";

Com o dado agora disponível, adicione o módulo da plataforma que deseja integrar e faça o mapeamento dos campos necessários, utilizando a variável manipulada no módulo "Tools - Set multiple variables";
Por fim, clique em "Save" para salvar o mapeamento dos campos;

Módulo "HTTP - Make a request" na Make

Caso esteja integrando o formulário a uma plataforma que possui seu próprio webhook, você pode seguir o mesmo processo de formatação descrito acima e, em seguida, adicionar um passo extra na Make para enviar os dados formatados.

Para isso, basta utilizar a ação de "Make a request" no módulo "HTTP" da Make:

Adicione um novo módulo de "HTTP" e selecione a ação "Make a request";
No campo de URL, inclua a URL para qual deseja enviar estes dados (a URL de webhook da plataforma que está utilizando);
Em "Method" selecione a opção "POST";
E em "Fields", faça o mapeamento dos campos de "Key" e "Value" inserindo os dados formatados;
Clique em "Ok" para salvar e confira se a integração foi feita com sucesso;