Pular para o conteúdo
Acessar conta

Webhooks de entrada: receber dados de outro sistema

Crie um link que recebe os dados de outro sistema, como a loja ou o formulário do site. A NexTags acha ou cria o contato, salva os campos e inicia um fluxo.

TutorialAvançado8 min
Atualizado em 25/10/2026

Resposta rápida

Em Ferramentas › Webhooks de entrada, clique em Adicionar Novo e dê um nome. Copie o link pelo ícone de link e cole no outro sistema. Cole um JSON de exemplo, diga onde estão o telefone ou o e-mail, escolha os campos e o fluxo e clique em Salvar.

Antes de começar

  • Um exemplo do JSON que o outro sistema envia. Ele costuma estar na documentação do sistema ou no histórico de envios do webhook de lá.
  • Os campos personalizados que vão guardar os dados. Veja Criar campos personalizados.
  • O fluxo que o contato vai receber, publicado. Veja Criar um fluxo.

Passo a passo

Passo 1: Crie o webhook

No menu da esquerda, clique em Ferramentas e depois no cartão Webhooks de entrada. Clique em Adicionar Novo, escreva um nome e clique em Continuar. O editor abre em seguida.

  1. Adicionar Novo: cria um webhook.
  2. Ativo: liga e desliga o webhook.
  3. O menu, que abre com o mouse em cima: Obter Link, que copia o link, Renomear e Excluir.

Passo 2: Copie o link

No topo do editor, clique no ícone de link (Obter Link). O link é copiado. Cole no outro sistema, no campo do webhook, às vezes chamado de URL de notificação.

  1. Obter Link: copia o link deste webhook.

Guarde o link

O link é a porta de entrada dos dados na sua conta. Não publique o link em lugares abertos.

Passo 3: Cole um JSON de exemplo

Em Sample JSON, cole um exemplo do que o outro sistema envia e clique em Load sample JSON. Quando aparece Sample loaded, o editor passa a mostrar o resultado de cada caminho.

  1. O JSON de exemplo.
  2. Load sample JSON: lê o exemplo.

O exemplo deste tutorial é o de um formulário do site:

{
  "cliente": {
    "nome": "Rafael Costa",
    "email": "rafael@exemplo.com.br",
    "telefone": "+5511900000000"
  },
  "empresa": "Costa & Filhos",
  "origem": {
    "utm_source": "google"
  }
}

O exemplo serve só para montar e conferir os caminhos, e pode ter até 1 MB.

Passo 4: Diga como achar o contato

Em Find or create contact, escreva o caminho do telefone e o do e-mail no JSON. Basta um dos dois. Se o contato não existir, a NexTags cria um novo.

  1. Número de telefone: o caminho do telefone, como $.cliente.telefone.
  2. Endereço de e-mail: o caminho do e-mail.
  3. Nome completo: opcional, o caminho do nome.
  4. A lupa: escolha o caminho clicando no JSON. Veja Como escrever o caminho.

Embaixo de cada campo, Result mostra o valor que o caminho achou no exemplo.

Passo 5: Salve os dados nos campos

Em Save incoming data, escolha o Campo Personalizado e escreva o JSONPath do valor. Para guardar mais um dado, clique em + Adicionar associação de campo.

  1. Campo Personalizado: onde o valor vai ficar. A lista também tem Endereço de e-mail, Número de telefone, Nome, Sobrenome e Nome completo.
  2. JSONPath: o caminho do valor no JSON.
  3. A lixeira: tira a associação.
  4. + Adicionar associação de campo: guarda mais um dado.

O webhook precisa de pelo menos uma associação.

Passo 6: Escolha o fluxo

Em Após salvar os dados, escolha o fluxo em Enviar Fluxo. Ele começa depois que os campos do contato forem salvos.

  1. Enviar Fluxo: o fluxo que o contato recebe.

Passo 7: Salve

Clique em Salvar, no topo do editor. Na lista, confira se o webhook está Ativo.

  1. Salvar: guarda o webhook.

Como escrever o caminho

O caminho (JSONPath) diz onde está o valor dentro do JSON. Ele sempre começa com $, que é o JSON inteiro. Para não errar, clique na lupa e escolha o valor na árvore.

  1. Um valor: clique nele para usar o caminho. Objetos e listas abrem e fecham.
  2. JSONPath: dá para escrever o caminho aqui.
  3. Usar caminho: usa o caminho escrito.
No JSONCaminho
email, dentro de cliente$.cliente.email
nome do primeiro item da lista itens$.itens[0].nome
Uma chave com hífen, como dados-cliente$["dados-cliente"]["email"]

Escolha sempre um valor, como um texto ou um número, e não um objeto ou uma lista inteira. Filtros e curingas, como *, não funcionam.

Pronto: como conferir

  • Faça um envio de teste pelo outro sistema, como um pedido ou um formulário de teste.
  • Procure o contato em Contatos ou na Caixa de Entrada. Os campos devem estar preenchidos.
  • No painel do contato, em Histórico › Fluxos/Passos Executados, confira se o fluxo aparece.

Se não funcionou

Apareceu "Configure an email or phone number to identify the contact."

Escreva o caminho do telefone ou do e-mail em Find or create contact.

Apareceu "Configure at least one field mapping."

Em Save incoming data, preencha pelo menos uma associação, com o campo e o caminho.

Apareceu "Select an available flow to trigger after the data is saved."

Escolha o fluxo em Enviar Fluxo. Se a lista está vazia, crie um fluxo e recarregue a página.

O caminho mostra um aviso em inglês

"Start the path with $." quer dizer que o caminho precisa começar com $. "Filters and wildcards are not supported." quer dizer que só valem .chave, ["chave"] e [0]. "Select a value rather than an object or array." pede um valor, e não um objeto ou uma lista. Use a lupa para escolher.

O caminho mostra "No value found in sample data."

O caminho não existe no exemplo: confira o nome das chaves. Se o dado é opcional e só falta no exemplo, você pode salvar assim.

O outro sistema enviou, mas nada aconteceu

Confira se o webhook está Ativo e se o link colado no outro sistema é o deste webhook. Veja Meu webhook de entrada não recebe os dados e Erros de requisição externa, webhook e planilha.

Faça com a IA

Copie o pedido e cole no ChatGPT ou no Claude.

Quero receber os dados de [nome do sistema, por exemplo: a minha loja] na NexTags com um webhook de entrada. Leia este tutorial: https://help.nextags.com.br/tutoriais/ferramentas/webhook-de-entrada.md

Este é um exemplo do JSON que o sistema envia: [cole aqui]. Me diga os caminhos (JSONPath) do telefone, do e-mail e do nome, quais campos personalizados criar para os outros dados e o caminho de cada um.

Para desenvolvedores

O lado técnico está na central de desenvolvedores: Webhook de entrada, Mapear o corpo recebido para campos do contato e Exemplos de plataformas.

Relacionados

Este conteúdo ajudou?

Obrigado! Sua resposta ajuda a melhorar a central.