# 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.

Endereço: https://help.nextags.com.br/tutoriais/ferramentas/webhook-de-entrada/
Tipo: Tutorial · Avançado

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](https://help.nextags.com.br/tutoriais/fluxos/campos-personalizados/).
- O fluxo que o contato vai receber, publicado. Veja [Criar um fluxo](https://help.nextags.com.br/tutoriais/fluxos/criar-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.

![Lista Webhooks de entrada com o botão Adicionar Novo e cinco webhooks, cada um com o interruptor Ativo, a data e o menu de opções.](https://help.nextags.com.br/_img/ferr-automacao/entrada-lista.webp)
*A lista Webhooks de entrada.*

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.

![Topo do editor do webhook de entrada Lead do site, com o ícone de link e a dica Obter Link.](https://help.nextags.com.br/_img/ferr-automacao/entrada-link.webp)
*O ícone Obter Link, no topo do editor.*

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.

![Quadro Sample JSON com um JSON de exemplo de um lead (nome, e-mail, telefone, empresa e origem), o botão Load sample JSON e o aviso Sample loaded.](https://help.nextags.com.br/_img/ferr-automacao/entrada-amostra.webp)
*O quadro Sample JSON com o exemplo de um lead.*

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

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

```json
{
  "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.

![Quadro Find or create contact com os caminhos do telefone, do e-mail e do nome no JSON e o resultado de cada um embaixo.](https://help.nextags.com.br/_img/ferr-automacao/entrada-contato.webp)
*O quadro Find or create contact.*

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](https://help.nextags.com.br/tutoriais/ferramentas/webhook-de-entrada/#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**.

![Quadro Save incoming data com duas associações: o campo Empresa com o caminho $.empresa e o campo Origem do lead com $.origem.utm_source.](https://help.nextags.com.br/_img/ferr-automacao/entrada-campos.webp)
*O quadro Save incoming data com dois campos.*

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.

![Quadro Após salvar os dados com o fluxo Qualificação de lead escolhido em Enviar Fluxo.](https://help.nextags.com.br/_img/ferr-automacao/entrada-fluxo.webp)
*O quadro Após salvar os dados.*

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**.

![Botões Cancelar e Salvar no topo do editor.](https://help.nextags.com.br/_img/ferr-automacao/salvar.webp)
*1. Salvar.*

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.

![Janela da lupa do Endereço de e-mail: o JSON de exemplo em árvore, com o valor email em destaque, o campo JSONPath e o botão Usar caminho.](https://help.nextags.com.br/_img/ferr-automacao/entrada-seletor.webp)
*A janela da lupa, com o JSON de exemplo em á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 JSON | Caminho |
|---|---|
| `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](https://help.nextags.com.br/perguntas/integracoes/webhook-nao-recebe/) e [Erros de requisição externa, webhook e planilha](https://help.nextags.com.br/tutoriais/erros/erros-de-requisicao-externa/).

### Faça com a IA

Cole este pedido no ChatGPT ou no Claude:

```text
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](https://docs.nextags.com.br/webhooks/webhook-de-entrada/), [Mapear o corpo recebido para campos do contato](https://docs.nextags.com.br/webhooks/mapear-campos/) e [Exemplos de plataformas](https://docs.nextags.com.br/webhooks/exemplos-de-plataformas/).