# Executar código JavaScript

> Rode um código JavaScript curto no fluxo para calcular, juntar ou tratar dados do contato e salve o que ele devolve num campo.

Endereço: https://help.nextags.com.br/tutoriais/fluxos/javascript-no-fluxo/
Tipo: Tutorial · Avançado

Atualizado em: 24/10/2026

> **Resposta rápida**
>
> Numa etapa **Ações**, clique em **Adicionar Conteúdo** › **Ações** › **Ferramentas** › **Executar código JavaScript**. Escreva o código com `return` no fim, escolha o campo que guarda o resultado e clique em **Continuar**.

**Antes de começar**

- Um campo para guardar o resultado, do tipo certo (texto, número, data…). Veja [Criar campos personalizados](https://help.nextags.com.br/tutoriais/fluxos/campos-personalizados/).
- Uma etapa **Ações** no ponto do fluxo em que os dados já existem. Veja [Etapa Ações](https://help.nextags.com.br/tutoriais/fluxos/etapa-acoes/).

## Passo a passo

### Passo 1: Abra as Ferramentas

Na etapa **Ações**, clique em **Adicionar Conteúdo** › **Ações** e depois em **Ferramentas**, no fim da lista.

![Menu Ações › Ferramentas aberto: Obter dados de JSON, Executar código JavaScript, Formatar Data e Hora, Gerar Número Aleatório e Contador de Caracteres.](https://help.nextags.com.br/_img/fluxos-acoes/menu-ferramentas.webp)
*1. Ferramentas. 2. As ferramentas de dados.*

1. **Ferramentas**: o grupo das ferramentas de dados.
2. Clique em **Executar código JavaScript**. O cartão entra na etapa; clique nele para abrir a janela.

### Passo 2: Escreva o código

Na janela **Executar código JavaScript**:

![Janela Executar código JavaScript com um código que calcula 10% de desconto sobre o valor do orçamento e o campo onde salvar o resultado.](https://help.nextags.com.br/_img/fluxos-acoes/js.webp)
*O código tira 10% do valor do orçamento.*

1. **Código JavaScript**: o código. Use os campos do contato entre chaves duplas, como `{{Valor do orçamento}}`; digite `{` para escolher na lista. O valor que o `return` devolve é o resultado.
2. **Salve a resposta em um campo personalizado.**: o campo que recebe o resultado. **Adicionar Novo** cria um campo na hora.

O próprio campo traz um exemplo: `let age = {{user_age}}; return age + 2;`. Clique em **Continuar**.

### Passo 3: Ligue as saídas e publique

No quadro, a ação ganha as saídas **Sucesso** e **Falhado**. Ligue cada uma à próxima etapa e clique em **Publicar**, no topo do editor.

![Topo do editor de fluxo com os botões Testar, Salvar e Publicar.](https://help.nextags.com.br/_img/fluxos-acoes/publicar.webp)
*1. Publicar.*

1. **Publicar**: o contato só passa pela versão publicada.

## Exemplos

O campo de texto entra no código como texto: ponha entre aspas.

```javascript
// juntar nome e cidade numa frase
return "{{first_name}}, de {{Cidade}}";
```

```javascript
// valor com 10% de desconto, a partir de um campo de número
let valor = Number({{Valor do orçamento}});
return valor - valor * 0.1;
```

```javascript
// só os números do telefone
return "{{phone}}".replace(/\D/g, "");
```

> **Teste o código antes:**
> Troque as variáveis por valores de exemplo e rode o código no console do navegador (**F12** › Console). Se funcionar lá, cole no fluxo com as variáveis de volta.

## Pronto: como conferir

- Clique em **Testar**, no topo do editor, e passe pela etapa no seu celular. Veja [Testar o fluxo](https://help.nextags.com.br/tutoriais/fluxos/testar-fluxo/).
- Na **Caixa de Entrada**, abra a sua conversa e confira o campo no painel do contato.

## Se não funcionou

### O campo ficou vazio

Confira se o código termina com `return` e devolve um valor.

### O contato foi pela saída Falhado

O código pode ter um erro, como aspas faltando num texto ou um campo vazio. Teste o código no console do navegador com os valores do contato.

### O resultado não cabe no campo

Escolha um campo do mesmo tipo do resultado: número para contas, texto para frases.

### Faça com a IA

Cole este pedido no ChatGPT ou no Claude:

```text
Preciso de um código JavaScript para a ação Executar código JavaScript de um fluxo da NexTags. Leia este tutorial: https://help.nextags.com.br/tutoriais/fluxos/javascript-no-fluxo.md

Os campos que tenho são: [liste os campos e um valor de exemplo de cada]. Quero que o código [descreva o cálculo ou o tratamento]. Escreva um código curto, que use os campos como {{Nome do campo}} (com aspas quando for texto) e termine com return, e me diga de que tipo deve ser o campo que vai guardar o resultado.
```