# Obter dados de JSON

> Tire valores de um JSON guardado num campo do contato, como a resposta de outro sistema, e salve cada valor no campo certo.

Endereço: https://help.nextags.com.br/tutoriais/fluxos/dados-de-json/
Tipo: Tutorial · Avançado

Atualizado em: 24/10/2026

> **Resposta rápida**
>
> Numa etapa **Ações**, clique em **Adicionar Conteúdo** › **Ações** › **Ferramentas** › **Obter dados de JSON**. Em **Dados JSON**, escolha o campo que tem o JSON. Embaixo, escreva o caminho de cada valor (JSONPath) e escolha o campo que recebe. Clique em **Continuar**.

**Antes de começar**

- Um campo de texto com o JSON guardado, por exemplo vindo de um [webhook de entrada](https://help.nextags.com.br/tutoriais/ferramentas/webhook-de-entrada/) ou de uma pergunta do fluxo. Para chamar uma API e guardar a resposta direto em campos, veja [Requisição externa](https://help.nextags.com.br/tutoriais/fluxos/requisicao-externa/).
- Os campos que vão receber os valores. Veja [Criar campos personalizados](https://help.nextags.com.br/tutoriais/fluxos/campos-personalizados/).

## 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 **Obter dados de JSON**. O cartão entra na etapa; clique nele para abrir a janela.

### Passo 2: Diga de onde vem o JSON e para onde vai cada valor

Na janela **Obter dados de JSON**:

![Janela Obter dados de JSON: o campo com o JSON e, embaixo, cada JSONPath com o campo personalizado onde o valor fica salvo.](https://help.nextags.com.br/_img/fluxos-acoes/json.webp)
*A cidade e a empresa saem do JSON e vão para dois campos.*

1. **Dados JSON**: o campo de texto que guarda o JSON.
2. Em **Salve a resposta em um campo personalizado.**, uma linha por valor: à esquerda o caminho (JSONPath), à direita o campo que recebe. **Adicionar Novo**, embaixo, cria mais uma linha (até 100). **Adicionar Novo**, em cima, cria um campo.

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.

## Como escrever o caminho

O caminho começa com `$`, o começo do JSON, e desce de nível com um ponto. Neste JSON:

```json
{
  "cliente": { "cidade": "Campinas", "empresa": "Loja Exemplo" },
  "itens": [ { "nome": "Camiseta" }, { "nome": "Caneca" } ]
}
```

| Caminho | Valor |
|---|---|
| `$.cliente.cidade` | Campinas |
| `$.cliente.empresa` | Loja Exemplo |
| `$.itens[0].nome` | Camiseta (o primeiro item da lista) |

## 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 os campos no painel do contato.

## Se não funcionou

### O campo do JSON não aparece em Dados JSON

A lista mostra só campos de texto. Guarde o JSON num campo de texto.

### O campo ficou vazio

O caminho não bate com o JSON. Confira letra por letra, com maiúsculas e minúsculas, e o nível de cada chave. Para conferir o JSON que chegou, mostre o campo numa mensagem de teste.

### O contato foi pela saída Falhado

Confira se o campo tem mesmo um JSON quando o contato chega a esta etapa, por exemplo mostrando o campo numa mensagem de teste.

### Faça com a IA

Cole este pedido no ChatGPT ou no Claude:

```text
Tenho um JSON guardado num campo da NexTags e vou usar a ação Obter dados de JSON. Leia este tutorial: https://help.nextags.com.br/tutoriais/fluxos/dados-de-json.md

Este é um exemplo do JSON: [cole aqui]. Quero guardar: [liste os dados, como cidade, status do pedido e código de rastreio]. Para cada um, me dê o JSONPath e um nome curto para o campo personalizado que vai recebê-lo.
```