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
Como formatar o campo de Nome Próprio;
Como usar o módulo HTTP - Make a request;

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: 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, insira 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;