Mapear o corpo recebido para campos do contato

Passo 1: Pegue um exemplo real do JSON

Monte os caminhos sobre um JSON de verdade, e não sobre a documentação de memória: um nome de chave diferente basta para o campo ficar vazio.

• Webhook de entrada: o histórico de envios da outra plataforma, como o Payload da Hotmart ou o Ver logs da Kiwify, ou um envio de teste para o Test URL do n8n. Veja Exemplos de plataformas.
• Requisição externa: o Corpo da resposta, no Testar Agora da ação.
• Obter dados de JSON: o conteúdo do campo. Para ver, mostre o campo numa mensagem de teste.

O exemplo deste guia, um pedido:

{
  "cliente": {
    "nome": "Ana Souza",
    "email": "ana@exemplo.com.br",
    "telefone": "5511988776655",
    "vip": true
  },
  "pedido": {
    "id": "PED-1001",
    "numero": "000123",
    "total": 249.9,
    "pago_em": 1793030400,
    "itens": [
      { "produto": "Curso de Confeitaria", "preco": 199.9 },
      { "produto": "Apostila impressa", "preco": 50 }
    ]
  },
  "utm": { "utm_source": "instagram" },
  "dados-do-cupom": { "código": "BEMVINDO10" }
}

Passo 2: Ache o caminho de cada valor

O caminho começa com $, o JSON inteiro, e desce um nível a cada ponto. Item de lista vai entre colchetes, contando do zero. Chave com hífen, espaço ou acento vai entre aspas e colchetes.

$.cliente.email
$.pedido.itens[0].produto
$["dados-do-cupom"]["código"]

O caminho precisa chegar num valor: um texto, um número, true ou false. $.pedido e $.pedido.itens apontam para um grupo de dados, e não para um valor. Para listas de tamanho que muda, só dá para pegar posições fixas, como [0] e [1]: se precisar de todos os itens num texto só, monte esse texto no sistema que manda o JSON.

Passo 3: Escolha o tipo de campo

O tipo do campo personalizado decide o que dá para fazer com o valor depois, nas condições e nas mensagens.

Na API, o valor de um campo vem como texto quando o tipo é Texto (0) e como número nos outros tipos, como neste campo de número:

{ "id": 3001, "name": "Valor do pedido", "type": 1, "value": 249.9 }

Os tipos e as variáveis estão em Campos personalizados, campos do bot e variáveis.

Passo 4: Mapeie no webhook de entrada

A tela do webhook de entrada aceita só três formas: .chave, ["chave"] (ou ['chave']) e [n]. Use .chave só para chaves com letras sem acento, números e _, que não comecem com número; qualquer outra chave vai entre aspas e colchetes.

Aceitos                            Recusados
$.cliente.email                    $.pedido.itens[*].produto     (curinga)
$["dados-do-cupom"]["código"]      $..email                      (dois pontos seguidos)
$.pedido.itens[0].produto          $.pedido.itens[-1].produto    (índice negativo)
$['utm']['utm_source']             $.dados-do-cupom.código       (hífen e acento fora das aspas)

Os avisos que a tela mostra, em inglês:

Ao salvar, os avisos de Find or create contact aparecem com o nome do campo na frente, como Número de telefone: Start the path with $.. Os caminhos de Save incoming data não são conferidos ao salvar: olhe o Result: de cada um antes.

Passo 5: Mapeie no fluxo

Na requisição externa (Mapeamento de resposta) e em Obter dados de JSON, escreva o caminho do mesmo jeito: $, a chave depois de cada ponto e [n] para listas. Ao lado de JSONPath, na requisição externa, o ícone ⓘ abre um site que ajuda a achar o caminho num JSON colado.

Em Obter dados de JSON, escolha em Dados JSON o campo de texto que guarda o JSON e, embaixo, uma linha por valor, com o caminho e o campo que recebe (até 100 linhas). A ação tem duas saídas:

• Sucesso: pelo menos um campo foi preenchido.
• Falhado: o JSON é inválido ou nenhum campo foi preenchido.

Dados JSON: o campo Resposta do pedido
$.pedido.id       → ID do pedido
$.pedido.total    → Valor do pedido
$.cliente.vip     → Cliente VIP

O passo a passo de tela está em Obter dados de JSON e em Requisição externa.