# Webhooks

> Receba dados de outros sistemas num link da NexTags e avise outros sistemas quando algo acontece na conta, com os webhooks de entrada e de saída.

Endereço: https://help.nextags.com.br/integracoes/webhooks/
Tipo: Integração

Atualizado em: 25/10/2026

Webhook é um aviso automático que um sistema manda para o endereço (URL) de outro. A NexTags tem os dois lados, em **Ferramentas**. O webhook de entrada recebe os dados que outro sistema manda, como uma venda ou um formulário: a NexTags acha ou cria o contato, guarda os dados e inicia um fluxo. O webhook de saída avisa o endereço do seu sistema quando um evento acontece na conta, como uma etiqueta aplicada. Para chamar outro sistema num ponto do fluxo, use a requisição externa.

## O que dá para fazer

- Receber os dados de uma loja, de um formulário ou de outra ferramenta e iniciar um fluxo. Veja [Webhooks de entrada: receber dados de outro sistema](https://help.nextags.com.br/tutoriais/ferramentas/webhook-de-entrada/).
- Avisar o seu sistema quando um evento acontece na conta, como uma etiqueta aplicada. Veja [Webhooks de saída: avisar outro sistema](https://help.nextags.com.br/tutoriais/ferramentas/webhooks-de-saida/).
- Chamar outro sistema num ponto do fluxo e guardar a resposta em campos. Veja [Requisição externa: enviar e receber dados de outro sistema](https://help.nextags.com.br/tutoriais/fluxos/requisicao-externa/).
- Ver exemplos prontos de plataformas. Veja [Exemplos: Hotmart, Kiwify, Shopify e formulários](https://docs.nextags.com.br/webhooks/exemplos-de-plataformas/).

## Como conectar

### Passo 1: Para receber: crie o webhook de entrada

No menu da esquerda, clique em **Ferramentas** e depois em **Webhooks de entrada**. Clique em **Adicionar Novo**, dê um nome e clique em **Continuar**. No topo do editor, clique no ícone de link (**Obter Link**) e cole o link no outro sistema, no campo do webhook.

![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.

### Passo 2: Diga como achar o contato e o que guardar

Cole em **Sample JSON** um exemplo do que o outro sistema envia e clique em **Load sample JSON**. Em **Find or create contact**, escreva o caminho do telefone ou do e-mail no JSON.

![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.

Em **Save incoming data**, ligue cada dado a um campo do contato. Em **Após salvar os dados**, escolha o fluxo em **Enviar Fluxo** e clique em **Salvar**, no topo do editor.

### Passo 3: Para avisar outro sistema: crie o webhook de saída

Em **Ferramentas**, clique em **Webhooks de saída** e em **Adicionar**. Dê um nome e clique em **Continuar**. Clique em **+ Acionadores** e escolha os eventos.

![Webhook de saída recém-criado, com o menu + Acionadores aberto e o evento Etiqueta Aplicada em destaque.](https://help.nextags.com.br/_img/ferr-automacao/saida-eventos.webp)
*O menu + Acionadores aberto num webhook novo.*

1. **+ Acionadores**: abre a lista de eventos.
2. **Etiqueta Aplicada**: o evento do exemplo.

### Passo 4: Informe o endereço e salve

Em **Notificar este URL**, cole o endereço do seu sistema, começando com `https://`. Clique em **Salvar**, no topo do editor, e confira na lista se o **Estado** está ligado.

![Webhook de saída com o evento Etiqueta Aplicada (Lead quente) e o endereço do seu sistema em Notificar este URL.](https://help.nextags.com.br/_img/ferr-automacao/saida-url.webp)
*O webhook com o evento e o endereço.*

1. O evento: **Etiqueta Aplicada**, com a etiqueta Lead quente.
2. **Notificar este URL**: o endereço que recebe o aviso.

O passo a passo completo está em [Webhooks de entrada: receber dados de outro sistema](https://help.nextags.com.br/tutoriais/ferramentas/webhook-de-entrada/) e em [Webhooks de saída: avisar outro sistema](https://help.nextags.com.br/tutoriais/ferramentas/webhooks-de-saida/). O lado técnico está em [Webhooks na NexTags](https://docs.nextags.com.br/webhooks/visao-geral/).

## Se não funcionou

### O outro sistema enviou, mas nada aconteceu na NexTags

Confira se o webhook de entrada está **Ativo** e se o link colado no outro sistema é o dele. Veja [Meu webhook de entrada não recebe os dados](https://help.nextags.com.br/perguntas/integracoes/webhook-nao-recebe/).

### Apareceu "The URL must start with https"

O endereço do webhook de saída precisa começar com `https://`. Endereços com `http://` não são aceitos.

### O aviso do webhook de saída não chegou

Confira se o **Estado** está ligado, se o endereço está certo e se o evento que aconteceu é o escolhido. Veja [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 ligar a NexTags a [nome do sistema] por webhook. Leia esta página: https://help.nextags.com.br/integracoes/webhooks.md

O que eu quero: [receber os dados do sistema e iniciar um fluxo / avisar o sistema quando algo acontecer na NexTags]. Me diga se uso o webhook de entrada, o de saída ou a requisição externa e, se eu colar um exemplo do JSON, quais caminhos (JSONPath) usar.
```