Integrar ferramentas externas ao seu ambiente de rastreamento é um dos grandes diferenciais do Server Side. Com o uso de Webhooks, você consegue enviar dados diretamente de plataformas, sistemas e automações para o seu container, sem depender do navegador do usuário. Isso abre portas para integrações mais confiáveis, rastreamento avançado e maior controle sobre seus dados.
Hoje, você vai aprender como receber Webhooks no seu GTM Server Side usando o Data Client.
O que é o Data Client?
O Data Client é um cliente responsável por receber requisições externas dentro do container Server Side do Google Tag Manager. Na prática, ele funciona como uma porta de entrada para os Webhooks.
Quando uma ferramenta envia dados para o seu endpoint, é o Data Client que recebe essas informações e disponibiliza dentro do GTM Server Side para processamento.
Importante: O Data Client não vem instalado por padrão. Você precisa importá-lo manualmente.
Pré requisitos
Antes de começar, você precisa ter:
• Um container Server Side criado no GTM
• Container publicado e funcionando
• Hospedagem configurada (recomendado usar a Stape)
• Arquivo do modelo Data Client
Você pode baixar o modelo no link abaixo:
https://github.com/stape-io/data-client
Importando o Data Client no GTM Server Side
Dentro do GTM, acesse: Modelos → Novo
Clique nos três pontos no canto superior direito e selecione: Importar
Após importar, o modelo estará disponível no container.
Criando o cliente Data Client
Agora vamos criar o cliente que irá receber os Webhooks.
Clientes → Novo
Configuração do Cliente → Data Client
Configurando o Data Client
Na configuração:
Response Settings → Ative a opção: Send Response Body for GET Request
Isso permite que o endpoint responda automaticamente quando receber uma requisição.
Accepted Path Settings (configuração obrigatória) → Aqui você define o caminho do seu Webhook.
Exemplo: /webhook
Esse nome será usado na URL que receberá os dados.
Exemplo final da URL: seudominio.com/webhook
Copie exatamente o nome que você definiu e salve. Esse nome fará parte da URL que receberá o Webhook.
Feito isso, precisaremos do domínio personalizado para conseguir fazer os testes. Vá em:
Administrador → Configurações do Container
Copie a URL do domínio personalizado do seu container Server Side.
Testando o endpoint do Webhook
Para testar, basta acessar no navegador: DOMÍNIO PERSONALIZADO + NOME DEFINIDO NO ACCEPTED PATH
Exemplo: seudominio.com/webhook
Se seu container estiver hospedado na Stape, será necessário configurar o Preview corretamente para visualizar os Webhooks recebidos.
Vá na Stape → Power Ups
Ative: SGTM Preview Header Config
No GTM Server Side vamos fazer o DEBUG
Vá em tags → Visualizar
Após abrir o preview, clique nos três pontos no canto superior direito → Escolha a opção enviar solicitação manualmente
Copie o cabeçalho.
Volte na Stape, na opção SGTM Preview Header, cole o valor copiado no campo Preview Token. Isso libera a visualização de todos os Webhooks recebidos no modo Preview.
Agora, cole novamente no navegador:
DOMÍNIO PERSONALIZADO + NOME DO ACCEPTED PATH → Pressione ENTER → Volte ao modo Preview do GTM → Clique na aba Data
Verifique se os dados estão chegando corretamente. Se estiver aparecendo no Preview, está tudo configurado corretamente.
Qual URL enviar para quem dispara o Webhook?
A URL que você deve enviar para a ferramenta que irá disparar o Webhook é:
DOMÍNIO PERSONALIZADO + NOME DEFINIDO NO ACCEPTED PATH
Exemplo: seudominio.com/webhook
Essa será a URL oficial de recebimento.
Conclusão
Ao configurar o Data Client no seu GTM Server Side, você transforma seu container em um ponto central de recebimento de dados externos. Isso permite que qualquer sistema, automação ou plataforma envie informações diretamente para o seu ambiente de rastreamento, com muito mais controle e flexibilidade.
Com essa estrutura implementada, você não depende mais exclusivamente do navegador para capturar eventos. Agora, é possível receber dados de diferentes fontes, processá-los dentro do Server Side e direcioná-los estrategicamente para as ferramentas que fazem sentido para o seu ecossistema.
Também siga o Mundo do Traqueamento em outras redes sociais:
Inscreva-se no https://www.youtube.com/channel/UC6mX6bbcEmQoaznI0D7Aw5Q
Siga e curta no https://www.instagram.com/mundodotraqueamento/
Siga e comente no https://twitter.com/traqueamento
Siga também no https://www.linkedin.com/company/mundo-do-traqueamento
