Webhooks
Como configurar as integrações via Webhook dos seus Projetos para receber dados automaticamente.
Os webhooks permitem que seu Projeto receba notificações em tempo real sobre eventos importantes, como vendas de produtos digitais. O The Tracker suporta integração com diferentes provedores de webhook.
Como Funcionam os Webhooks
Quando um evento ocorre no provedor (por exemplo, uma venda na Hotmart), ele envia uma requisição HTTP POST para a URL do webhook configurada em seu projeto. O The Tracker processa essa notificação e atualiza automaticamente os dados de vendas.
ActiveCampaign
A integração com o ActiveCampaign permite receber automaticamente as informações dos seus leads.
Necessário ter configurado a Credencial de API do ActiveCampaign para que a opção de Webhook esteja disponível.
Gerar endpoint do Webhook
- Acesse Fontes de Dados no menu lateral
- Acesse ActiveCampaign
- Clique no botão Ativar para gerar um novo endpoint de webhook
A URL do webhook contém um token de segurança único. Mantenha esta URL segura e não a compartilhe publicamente.
Configurar Webhook
- Faça login na sua conta do ActiveCampaign
- Acesse Configurações > Desenvolvedor e busque por Gerenciar Webhooks
- Clique em Adicionar um webhook
- Selecione o tipo de webhook Padrão
- Informe um nome para o webhook
- Em URL para envio de dados, cole a URL que foi gerada
- Em Eventos, selecione os eventos Contact Added e Contact Updated
- Em Iniciar a partir de (origem), selecione todas as opções disponíveis
- Clique em Salvar
Feito estes passos, o ActiveCampaign irá passar a enviar automaticamente as informações dos seus leads para o The Tracker.
Para mais informações sobre como opera o nosso endpoint de webhook consulte nossa documentação do ActiveCampaign
Hotmart
A integração com a Hotmart permite receber automaticamente as vendas dos seus produtos digitais.
Necessário ter configurado a Credencial de API da Hotmart para que a opção de Webhook esteja disponível.
Gerar endpoint do Webhook
- Acesse Fontes de Dados no menu lateral
- Acesse Hotmart
- Clique no botão Ativar para gerar um novo endpoint de webhook
A URL do webhook contém um token de segurança único. Mantenha esta URL segura e não a compartilhe publicamente.
Configurar Webhook
- Faça login na sua conta da Hotmart
- Acesse Ferramentas > Ver todas e busque por Webhook
- Ou vá diretamente para Webhook
- Clique em Cadastrar Webhook
- Selecione o Produto que deseja receber as vendas
- Em URL para envio de dados, cole a URL que foi gerada
- Em Eventos, selecione o evento Compra Aprovada
- Clique em Salvar
Feito estes passos, a Hotmart irá passar a enviar automaticamente as informações das suas vendas para o The Tracker.
Para mais informações sobre como opera o nosso endpoint de webhook consulte nossa documentação da Hotmart
Solução de Problemas
Webhook não está recebendo dados
- Verifique a URL: Certifique-se de que a URL foi copiada corretamente
- Teste a conectividade: A URL deve estar acessível publicamente
- Verifique os eventos: Confirme que os eventos corretos estão selecionados na Hotmart
- Aguarde alguns minutos: Pode haver um delay na propagação das configurações
Vendas não aparecem no dashboard
- Verifique o status do webhook: Certifique-se de que está ativo
- Confirme o produto: O produto deve estar associado ao projeto correto
- Verifique os logs: Consulte os logs de requisições para identificar erros
Erro de autenticação
- Token inválido: Gere um novo token de webhook
- URL incorreta: Verifique se a URL está completa e correta
- Permissões: Confirme que o projeto tem as permissões necessárias
Segurança
- Os tokens de webhook são únicos e seguros
- Cada projeto possui seus próprios tokens
- Tokens podem ser regenerados a qualquer momento
- URLs de webhook contêm informações sensíveis - não compartilhe