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.
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.
- Avisar o seu sistema quando um evento acontece na conta, como uma etiqueta aplicada. Veja Webhooks de saída: avisar outro sistema.
- Chamar outro sistema num ponto do fluxo e guardar a resposta em campos. Veja Requisição externa: enviar e receber dados de outro sistema.
- Ver exemplos prontos de plataformas. Veja Exemplos: Hotmart, Kiwify, Shopify e formulários.
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.
- 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.
- Número de telefone: o caminho do telefone, como
$.cliente.telefone. - Endereço de e-mail: o caminho do e-mail.
- Nome completo: opcional, o caminho do nome.
- 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.
- + Acionadores: abre a lista de eventos.
- 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.
- O evento: Etiqueta Aplicada, com a etiqueta Lead quente.
- 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 e em Webhooks de saída: avisar outro sistema. O lado técnico está em Webhooks na NexTags.
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.
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.
Faça com a IA
Copie o pedido e cole no ChatGPT ou no Claude.
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.
Relacionados
Este conteúdo ajudou?
Obrigado! Sua resposta ajuda a melhorar a central.