---
title: JavaScript Fácil na FiqOn — Guia Prático e Completo sobre JavaScript na FiqOn
date: 2025-09-03T14:12:54+00:00
modified: 2025-09-03T23:31:40+00:00
author: empresa2p
categories:
  - FiqOn
url: https://empresa1p.com.br/javascript-facil-na-fiqon-guia-pratico-e-completo-sobre-javascript-na-fiqon/
---

Sou a [Empresa 1P](https://empresa1p.com.br/) - Automação e I.A e, nesta aula do [Curso Completo](https://empresa1p.com.br/caminhos-da-automacao/) [FiqOn](http://empresa1p.com.br/fiqon-especial), eu mostro por que o JavaScript na FiqOn é o verdadeiro super-herói dos seus fluxos de automação. Se você já se frustrou porque um fluxo não retorna exatamente como esperado, grande chance de que **JavaScript na FiqOn** resolva o seu problema em poucos segundos. 

https://youtu.be/k-q7OaK2nd4

Aqui eu vou ensinar como criar variáveis, transformar dados, validar números, filtrar informações e usar a inteligência artificial para gerar códigos prontos — tudo pensado para quem está começando e também para quem já tem experiência.

![Aba de componentes na FiqOn com opção JavaScript](https://empresa1p.com.br/wp-content/uploads/2025/09/image-27-1024x576.webp)

## **🚀 Por que o JavaScript na FiqOn é o super-herói dos seus fluxos?**

O JavaScript na [FiqOn](https://empresa1p.com.br/fiqon-vale-a-pena-plataforma-de-automacao/) chega para preencher lacunas onde os módulos padrões não conseguem entregar a lógica específica que você precisa. Em 90% dos casos em que o fluxo “não sai do jeito esperado”, uma pequena função em JavaScript resolve o problema. Isso porque, dentro da FiqOn, o JavaScript é a ferramenta de manipulação de dados: ele cria novas variáveis, transforma variáveis existentes e garante que os dados estejam exatamente no formato que você precisa para os módulos subsequentes.

## **🧩 Como o JavaScript na FiqOn cria e retorna variáveis**

O comportamento principal do JavaScript na FiqOn é bem simples: o código JS deve terminar com um **return**. O valor retornado vira uma nova variável que pode ser usada nos módulos seguintes do seu fluxo. Por exemplo, se você escrever **return minhaPalavra;**, o módulo JavaScript vai gerar a variável “minhaPalavra” com o conteúdo que você retornou.

![Exemplo de uso do return em um código JavaScript na FiqOn](https://empresa1p.com.br/wp-content/uploads/2025/09/image-26-1024x576.webp)

Você pode tanto criar uma variável totalmente nova quanto receber uma variável de um módulo anterior e transformá-la. Exemplo prático: adicionar um módulo “Definir Variável” antes do JavaScript, inserir um texto qualquer (por exemplo, "oi gente, tem cupom da FiqOn na descrição") e, no JavaScript, referenciar essa variável para transformá-la. Quando o JS retornar algo, esse retorno vira uma nova variável que segue no fluxo.

Esse padrão — pegar uma variável de entrada, processar e retornar uma nova variável — é essencial para o entendimento do JavaScript na FiqOn. Com isso, você ganha controle total sobre como os dados serão lidos e exibidos em mensagens, filtros e integrações.

## **✨ Transformações comuns: maiúsculas, minúsculas e formatação de data**

Transformações de texto são das aplicações mais comuns do **JavaScript na FiqOn**. Exemplos rápidos e úteis:

- Converter todo texto para maiúsculas (útil para padronizar respostas ou “gritar” uma chamada).

- Converter texto para minúsculas.

- Capitalizar (deixar apenas a primeira letra em maiúscula).

- Formatar datas para o padrão brasileiro (dd/mm/aaaa).

![Exemplo de código gerado pelo GPT para transformar texto em maiúsculas](https://empresa1p.com.br/wp-content/uploads/2025/09/image-25-1024x576.webp)

Na aula eu mostro como usar um espaço com um assistente GPT dentro do ecossistema para gerar rapidamente esse código. Você pode colar a variável de entrada e pedir: “capitalize(variável) — deixe todas as letras maiúsculas e retorne o texto”. O GPT fornece um snippet de JavaScript que você cola no módulo e testa. Em poucos segundos o texto que vinha com letras indevidas fica no formato desejado.

Um exemplo de fluxo prático: você recebe uma mensagem via webhook do WhatsApp com um texto em caixa aleatória. Antes de enviar uma resposta automática, você processa o texto com **JavaScript na FiqOn** para garantir que esteja padronizado. Ou recebe uma data em formato ISO e precisa transformá-la em dd/mm/aaaa para enviar em uma mensagem para clientes — tudo isso é feito via JavaScript.

## **🔍 Usando JavaScript na FiqOn como filtro: arrays e condições**

Além de transformar dados, o **JavaScript na FiqOn** é ótimo para criar filtros condicionais avançados. Um padrão muito usado é trabalhar com arrays: você recebe uma lista de nomes ou dados, e quer seguir o fluxo apenas se um determinado nome existir.

![Exemplo de filtro com array para verificar se](https://empresa1p.com.br/wp-content/uploads/2025/09/image-24-1024x576.webp)

Exemplo prático apresentado:

- Defina um array com nomes: ["Ana","Paulo","Lucas","Gustavo"]

- Verifique se o array inclui "Paulo". Se incluir, retorne "existe" (ou true); se não, retorne "não existe" (ou false).

let nomes = ["ana", "paulo", "lucas", "gustavo"];
let existe = nomes.includes("guilherme");

return existe;
```
let nomes = ["ana", "paulo", "lucas", "gustavo"];
let existe = nomes.includes("guilherme");

return existe;

```

Depois do JavaScript retornar esse valor (booleano ou texto), você usa um módulo de filtro na FiqOn que verifica se o resultado é igual a "existe" (ou true) para decidir se o fluxo segue adiante. Esse padrão é excelente para lógica de negócios: somente determinados clientes entram em segmentos ou recebem ofertas especiais.

## **🎲 Números aleatórios e filtros probabilísticos**

Outra dica poderosa que eu mostro é gerar números aleatórios com **JavaScript na FiqOn**. Pode parecer simples, mas é extremamente útil em várias situações:

- Enviar ofertas apenas para uma pequena porcentagem de usuários (teste A/B).

- Evitar sobrecarga em uma base de dados, limitando quantas vezes uma operação é executada.

- Criar sorteios ou distribuições aleatórias entre usuários.

Você pode gerar um número inteiro de 0 a 100 e, em seguida, usar filtros numéricos na FiqOn para tomar decisões (por exemplo: se número >= 3 e número < 10 então executar X). Isso cria comportamentos probabilísticos no fluxo sem complicação.

## **📞 Boas práticas: extrair primeiro nome e validar números para WhatsApp**

Em automações que enviam mensagens pelo WhatsApp é comum você receber um nome completo e o telefone em formatos variados. Enviar “Olá, João Ribeiro Neto da Silva Cruz” soa estranho; é muito melhor usar apenas o primeiro nome: “Olá, João”. O **JavaScript na FiqOn** faz isso facilmente.

Método prático: pegue a variável de nome completo, aplique um split(' ') e retorne a primeira posição do array. Assim, "Gustavo Hermont" vira "Gustavo".

let nomeCompleto = "{{$IN.BODY.attributes.NOME}}";

let primeiroNome = nomeCompleto.split(" ");

return primeiroNome;```
let nomeCompleto = "{{$IN.BODY.attributes.NOME}}";

let primeiroNome = nomeCompleto.split(" ");

return primeiroNome;
```

Outra aplicação essencial é a validação e formatação de números para envio via WhatsApp. Muitos sistemas recebem números com espaços, parênteses, sinais de “+” ou sem o DDI. Um código simples em JavaScript pode:

- Remover caracteres não-numéricos.

- Verificar se o DDI (por exemplo, 55 para Brasil) está presente; se não estiver, adicioná-lo.

- Checar o comprimento do número para identificar números inválidos (por exemplo, menos de 10 dígitos pode ser inválido).

let raw = String($IN.BODY.attributes.SMS || '').replace(/\D/g, '');

// Remove zero depois do DDD se houver (ex: 031099531212 -> 3199531212)
if (raw.length >= 12 && raw[4] === '0') {
  raw = raw.slice(0, 4) + raw.slice(5);
}

// Corrige número SEM código de país (ex: 3199531212 -> 553199531212)
if (raw.length === 11) { // Com DDD e número (geralmente celular)
  raw = '55' + raw;
}
if (raw.length === 10) { // Telefone fixo
  raw = '55' + raw;
}

// Se tiver só o número SEM DDD (8 ou 9 dígitos), não converte (considera inválido)
if (raw.length < 12) {
  return '';
}

// Remove zeros extras depois do código do país, caso existam (ex: 5503199531212 -> 553199531212)
if (raw.startsWith('550')) {
  raw = '55' + raw.slice(3);
}

return raw;
```
let raw = String($IN.BODY.attributes.SMS || '').replace(/\D/g, '');

// Remove zero depois do DDD se houver (ex: 031099531212 -> 3199531212)
if (raw.length >= 12 && raw[4] === '0') {
  raw = raw.slice(0, 4) + raw.slice(5);
}

// Corrige número SEM código de país (ex: 3199531212 -> 553199531212)
if (raw.length === 11) { // Com DDD e número (geralmente celular)
  raw = '55' + raw;
}
if (raw.length === 10) { // Telefone fixo
  raw = '55' + raw;
}

// Se tiver só o número SEM DDD (8 ou 9 dígitos), não converte (considera inválido)
if (raw.length < 12) {
  return '';
}

// Remove zeros extras depois do código do país, caso existam (ex: 5503199531212 -> 553199531212)
if (raw.startsWith('550')) {
  raw = '55' + raw.slice(3);
}

return raw;

```

Se o número for inválido, o retorno do JavaScript pode sinalizar esse estado (por exemplo, retornar false ou "inválido") e o fluxo pode ser interrompido ou enviar um alerta. Isso evita tentativas de envio que falhariam e reduz custos com operações desnecessárias.

## **🤖 Como usar a inteligência artificial para gerar código JavaScript na FiqOn**

Se você não quer escrever código do zero, pode usar a inteligência artificial para gerar snippets. Eu descrevo um prompt simples que funciona muito bem no espaço configurado dentro da FiqOn ou em ferramentas como o ChatGPT:

Prompt base sugerido (exemplo): "Gere código JavaScript que receba a variável X e retorne X em letras maiúsculas. O código deve terminar com return." — a IA retorna o snippet pronto e você cola no módulo JavaScript.

No espaço que eu configurei dentro do ambiente, eu deixei como padrão pedir sempre que o código tenha um **return** no final. Assim, qualquer código gerado já está pronto para virar uma variável que vai para os módulos seguintes. Para configurar isso na sua conta, vá no canto superior direito do espaço, nos três pontinhos, em "Configurações" e ative a convenção de retorno — isso padroniza a geração de código.

Você pode usar o ChatGPT também: crie um GPT personalizado com instruções para gerar códigos JS compatíveis com a FiqOn e cole os snippets diretamente no módulo JavaScript. Eu deixarei exemplos prontos na descrição do curso e no espaço de [materiais](https://empresa1p.com.br/comunidade-1p/) para agilizar sua vida.

## **🛠️ Exemplos práticos e passo a passo com JavaScript na FiqOn**

Aqui estão alguns passos práticos que você pode seguir agora para aplicar o que aprendeu. Cada exemplo inclui o objetivo, a lógica em palavras e o que retornar.

### 1) Converter texto para MAIÚSCULAS

Objetivo: padronizar um texto recebido por webhook.

Lógica: receber variável texto, aplicar .toUpperCase(), retornar o resultado.

Uso: ajuda em análises, respostas automáticas, chamadas de promoção.

### 2) Filtrar se um nome existe em uma lista

Objetivo: decidir se o fluxo prossegue com base na presença de um nome.

Lógica: criar array de nomes, usar .includes("Nome"), retornar booleano ou etiqueta ("existe" / "não existe").

Uso: segmentação para campanhas, autorizações, gatilhos de fluxo.

### 3) Gerar número aleatório e criar um filtro probabilístico

Objetivo: executar uma ação apenas X% das vezes.

Lógica: gerar Math.floor(Math.random() * 100), retornar número, usar filtro numérico da FiqOn (ex: menor que 10 representa 10% de probabilidade).

Uso: testes A/B, limitar operações, sorteios.

### 4) Extrair primeiro nome

Objetivo: deixar mensagens mais humanas.

Lógica: split(' ')[0] na variável nome completo; retornar primeiro nome.

Uso: personalização de mensagens, evitar formalidade excessiva.

### 5) Validar e formatar número para WhatsApp

Objetivo: garantir que mensagens cheguem corretamente.

Lógica: remover caracteres não numéricos, verificar se começa com "55" (ou adicioná-lo), checar comprimento mínimo para considerar válido; retornar número formatado ou sinal de erro.

Uso: evitar falhas no envio, reduzir custo de tentativas inválidas.

Esses exemplos ilustram o poder do **JavaScript na FiqOn**: soluções simples que resolvem problemas reais do dia a dia em automação e comunicação com clientes.

## **🧑‍💻 Exemplos avançados de código JavaScript na FiqOn**

Além das transformações básicas de texto, filtros e aleatoriedade, o **JavaScript na FiqOn** também pode resolver desafios cotidianos de automação. Aqui estão alguns exemplos com código pronto para você adaptar.

### 1) Verificar se um texto contém determinada palavra-chave

**Objetivo:** identificar se uma mensagem recebida menciona determinada palavra, como "promoção" ou "desconto".

let mensagem = input.mensagem; // variável recebida do fluxo
let palavraChave = "promoção";

// Verifica se a palavra está presente (case insensitive)
let existe = mensagem.toLowerCase().includes(palavraChave.toLowerCase());

return existe; // retorna true ou false```
let mensagem = input.mensagem; // variável recebida do fluxo
let palavraChave = "promoção";

// Verifica se a palavra está presente (case insensitive)
let existe = mensagem.toLowerCase().includes(palavraChave.toLowerCase());

return existe; // retorna true ou false
```

👉 Útil para acionar fluxos apenas quando o cliente mencionar algo específico.

### 2) Formatar valor monetário em Real (R$)

**Objetivo:** transformar números crus em valores no formato brasileiro.

let valor = input.total; // exemplo: 1500.5

let formatado = valor.toLocaleString('pt-BR', {
style: 'currency',
currency: 'BRL'
});

return formatado; // Exemplo: "R$ 1.500,50"```
let valor = input.total; // exemplo: 1500.5

let formatado = valor.toLocaleString('pt-BR', {
style: 'currency',
currency: 'BRL'
});

return formatado; // Exemplo: "R$ 1.500,50"
```

let valor = input.total; // exemplo: 1500.5

👉 Ajuda a padronizar mensagens financeiras em propostas, pagamentos ou faturas automáticas.

### 3) Mascarar dados sensíveis (ex: CPF ou cartão)

**Objetivo:** esconder parte de um número para segurança em mensagens.

let cpf = input.cpf; // exemplo: "12345678909"

// Mantém apenas os 2 primeiros e os 2 últimos dígitos visíveis
let cpfMascara = cpf.slice(0,2) + "*" + cpf.slice(-2);

return cpfMascara; // Exemplo: "12*09"```
let cpf = input.cpf; // exemplo: "12345678909"

// Mantém apenas os 2 primeiros e os 2 últimos dígitos visíveis
let cpfMascara = cpf.slice(0,2) + "*" + cpf.slice(-2);

return cpfMascara; // Exemplo: "12*09"
```

text

👉 Prático para confirmar dados do cliente sem expor informações pessoais completas.

### 4) Calcular diferença de dias entre duas datas

**Objetivo:** verificar quantos dias faltam até um prazo ou evento.

let dataInicio = new Date(input.dataInicio); // Ex: "2025-09-03"
let dataFim = new Date(input.dataFim); // Ex: "2025-09-10"

let diffMs = dataFim - dataInicio;
let diffDias = Math.ceil(diffMs / (1000 * 60 * 60 * 24));

return diffDias; // Exemplo: 7```
let dataInicio = new Date(input.dataInicio); // Ex: "2025-09-03"
let dataFim = new Date(input.dataFim); // Ex: "2025-09-10"

let diffMs = dataFim - dataInicio;
let diffDias = Math.ceil(diffMs / (1000 * 60 * 60 * 24));

return diffDias; // Exemplo: 7
```

👉 Ótimo para fluxos que precisam calcular atrasos, prazos ou lembretes automáticos.

### 5) Escolher mensagem aleatória de uma lista (respostas dinâmicas)

**Objetivo:** deixar a automação mais natural alternando mensagens pré-definidas.

let respostas = [
"Oi! Como posso te ajudar hoje?",
"Olá! O que deseja saber?",
"Seja bem-vindo(a)! Me diga como posso ajudar."
];

let indice = Math.floor(Math.random() * respostas.length);

return respostas[indice];```
let respostas = [
"Oi! Como posso te ajudar hoje?",
"Olá! O que deseja saber?",
"Seja bem-vindo(a)! Me diga como posso ajudar."
];

let indice = Math.floor(Math.random() * respostas.length);

return respostas[indice];
```

👉 Garante variedade em mensagens automáticas, evitando repetição e tornando a comunicação mais amigável.

> 
> 💡 **Dica prática:** sempre finalize o código com `return`, pois o valor retornado é o que segue para os módulos seguintes na **FiqOn**.

> 

## **📚 Recursos, cursos e leituras complementares**

Se quer aprender mais sobre automação e complementar o uso do JavaScript na FiqOn, confira nossos [materiais](https://empresa1p.com.br/comunidade-1p) e cursos relacionados:

- Guia completo da FiqOn: https://empresa1p.com.br/fiqon-vale-a-pena-plataforma-de-automacao/

- Cupom de desconto para testar a FiqOn: https://empresa1p.com.br/cupom-de-30-off-na-fiqon-automacao/

- Curso gratuito de Make.com (ótimo para quem usa várias plataformas): https://empresa1p.com.br/curso-de-make-com-gratuito-aprenda-a-automatizar-seu-trabalho/

- Comparativo de plataformas de automação: https://empresa1p.com.br/zapier-make-com-ou-n8n-qual-a-melhor-plataforma-de-automacao/

- Integração com Google Drive (útil em fluxos que precisam armazenar arquivos): https://empresa1p.com.br/como-integrar-o-google-drive-no-make-com-um-guia-passo-a-passo/

- Automação de redes sociais: https://empresa1p.com.br/automacao-completa-de-redes-sociais-criando-um-perfil-de-noticias/

## **❓ FAQ — Perguntas frequentes sobre JavaScript na FiqOn**

### Preciso ser programador para usar JavaScript na FiqOn?

Não. É muito comum começar sem conhecimento de código. Com exemplos básicos (retorno de variáveis, .split, .toUpperCase, validação) e com a ajuda da IA para gerar snippets, qualquer pessoa consegue aplicar JavaScript na FiqOn de forma prática.

### O que o código JavaScript precisa ter obrigatoriamente?

Terminar com **return**. O valor retornado vira uma nova variável que pode ser usada nos módulos seguintes. Esse é o padrão que garante a integração entre o módulo JS e o restante do fluxo.

### Onde pego as variáveis dos módulos anteriores?

Você referencia as variáveis do módulo anterior no editor de código do JavaScript. A FiqOn expõe essas variáveis e você pode colar o nome da variável dentro do seu snippet para manipulação.

### Posso usar AI para gerar código JavaScript?

Sim. Use o espaço configurado na FiqOn ou o ChatGPT com prompts específicos (padrão: “gere código JavaScript que receba a variável X e retorne Y”). Eu recomendo configurar o espaço para exigir **return** ao final do código e salvar prompts úteis.

### Como faço testes do meu código antes de colocar no fluxo ao vivo?

Use a função de “Testar” do módulo JavaScript na FiqOn. Insira valores de exemplo, execute o teste e verifique o resultado que será retornado. Ajuste até que o retorno seja o esperado e então conecte ao restante do fluxo.

### Existe alguma limitação no uso do JavaScript na FiqOn?

Como em qualquer plataforma, evite funções síncronas que dependam de chamadas externas sem tratamento e scripts muito pesados que possam impactar performance. Para integrações externas, prefira módulos específicos da plataforma quando disponíveis.

## **✅ Conclusão: transforme seus fluxos com JavaScript na FiqOn**

O **JavaScript na FiqOn** é a ferramenta que abre possibilidades quase infinitas para personalizar e controlar seus fluxos de automação. Ele permite criar variáveis, padronizar textos, validar números, aplicar filtros lógicos, gerar aleatoriedade e muito mais. Mesmo que você seja iniciante, com exemplos práticos, testes e a ajuda da inteligência artificial, você consegue implementar soluções robustas e eficientes.

Se quiser começar agora, siga estes passos rápidos:

1. Crie um fluxo simples com um módulo que receba dados (webhook ou definição de variável).

2. Adicione o módulo JavaScript e cole um snippet que termine com return.

3. Use a função de testar para validar o retorno.

4. Conecte o resultado aos módulos subsequentes e use filtros para controlar o fluxo.

Quer mais material prático? Acesse nosso [Curso Completo](https://empresa1p.com.br/caminhos-da-automacao) FiqOn e os recursos recomendados acima para acelerar seu aprendizado. Links úteis novamente:

- Guia FiqOn: https://empresa1p.com.br/fiqon-vale-a-pena-plataforma-de-automacao/

- Curso Make.com gratuito: https://empresa1p.com.br/curso-de-make-com-gratuito-aprenda-a-automatizar-seu-trabalho/

- Comparativo de plataformas: https://empresa1p.com.br/zapier-make-com-ou-n8n-qual-a-melhor-plataforma-de-automacao/

Se você gostou dessa aula sobre **JavaScript na FiqOn**, continue testando e criando. Estou preparando mais projetos práticos e estamos chegando perto das aulas de projeto — lá você vai colocar tudo em prática. Abraço e nos vemos na próxima aula!

![Teste de variável no módulo JavaScript mostrando entrada e saída](https://empresa1p.com.br/wp-content/uploads/2025/09/image-23-1024x576.webp)