Integração Hotmart
Passo a Passo Prático (Resumo Inicial)
Na Hotmart: acesse sua conta, localize o ID do produto (abaixo do título do produto), copie também o HOTTOK da sua conta e crie um webhook de “Compra Aprovada” direcionado para o endpoint mencionado nas imagens abaixo.
Link para cadastrar um Webhook na Hotmart: https://app.hotmart.com/tools/webhook
Endpoint para você cadastrar o webhook na sua conta da Hotmart (conforme imagem abaixo): https://webhook-hotmart.torelyze.workers.dev
Link para copiar o ID do produto:
https://app.hotmart.com/products/producer
Link para copiar o HOTTOK: https://app.hotmart.com/tools/webhook/auth
No Torelyze: crie a integração, inserindo o HOTTOK copiado na Hotmart durante o cadastro da nova integração. Apps -> Nova Integração
Ainda no Torelyze: cadastre o produto, informando o código do produto que você pegou na Hotmart (o mesmo ID já mencionado).
Dentro do novo produto (no Torelyze): vincule o produto à integração que você criou no passo anterior (passo 2).
Este é o resumo das etapas de forma direta. A seguir, vamos mergulhar em cada ponto com mais detalhes, orientações de segurança e dicas para que a integração entre Hotmart e Torelyze seja bem-sucedida.
Integração Hotmart + Torelyze: Guia Completo
Integrar a Hotmart com o Torelyze pode trazer inúmeros benefícios para quem atua no marketing digital. Afinal, a Hotmart é uma das maiores plataformas de pagamentos e distribuição de produtos digitais no Brasil, enquanto o Torelyze se apresenta como uma ferramenta de gestão robusta, capaz de centralizar suas vendas, seus lançamentos, suas tarefas e muito mais. A seguir, veremos como cada passo do resumo inicial funciona na prática, com todos os detalhes que você precisa para não ter dúvidas na hora de configurar.
1. Acessando a Hotmart para Obter o ID do Produto, HOTTOK e Criar o Webhook
1.1. Localizando o ID do Produto na Hotmart
Onde encontrar o ID: Geralmente, para conseguir o ID de um produto na Hotmart, você acessa o menu “Produtos” e seleciona aquele que deseja integrar. Cada produto possui um identificador único, que pode estar na URL da página ou em uma seção de detalhes do produto.
Por que preciso desse ID?: Esse código permite que, do lado do Torelyze, você consiga relacionar as vendas que chegam via Hotmart diretamente a um produto específico dentro da sua conta, facilitando relatórios e automações.
1.2. Obtendo o HOTTOK na Hotmart
O que é o HOTTOK: É uma chave de autenticação disponibilizada pela Hotmart para que outras plataformas possam validar dados e verificar a origem das notificações. Sem ele, não é possível garantir a comunicação segura entre as duas ferramentas.
Como encontrar: Vá até a área de “Ferramentas” ou “Integrações” dentro da Hotmart. Em algumas versões do painel, você também pode localizar a chave em “Configurações” > “Webhooks”. O HOTTOK costuma estar presente nessa página ou em um submenu específico de integrações.
Dica de segurança: Evite compartilhar publicamente o seu HOTTOK, pois quem tiver essa informação poderá enviar notificações falsas ao seu endpoint. Guarde-o sempre em lugar seguro.
1.3. Criando o Webhook de Compra Aprovada
O que é um webhook?: É um mecanismo pelo qual a Hotmart “avisa” a ferramenta de terceiros (neste caso, o Torelyze) sempre que acontece um evento relevante — no nosso contexto, uma venda aprovada (ou “compra aprovada”).
Como criar:
Dentro do produto na Hotmart, procure a seção de “Ferramentas”, “Configurações avançadas” ou “Webhooks”.
Selecione a opção para adicionar um novo webhook.
Defina o tipo de evento que deseja monitorar, por exemplo, “Compra aprovada”.
No campo de URL do webhook, insira o endpoint https://webhook-hotmart.torelyze.workers.dev
Salve as configurações.
Teste inicial: Algumas vezes, a Hotmart permite que você teste o envio do webhook. Se essa função estiver disponível, faça um teste para garantir que o Torelyze irá receber as informações adequadamente.
2. Criando a Integração no Torelyze com o HOTTOK
Depois de conseguir o HOTTOK na Hotmart, o próximo passo é acessar o seu painel do Torelyze:
2.1. Navegando até o Painel de Integrações
Onde encontrar: No menu lateral esquerdo, procure pelo item "Apps". Cada versão pode trazer nomes ligeiramente diferentes, mas a ideia é que você procure algo como “Adicionar Integração” ou “Nova Integração”.
Inserindo o HOTTOK: Ao criar a integração com a Hotmart, será solicitado algum token ou chave de autenticação. Esse é o momento de colar o HOTTOK que você copiou da Hotmart.
Atenção: Tenha certeza de que o token copiado está completo e sem espaços extras. Caso contrário, a comunicação irá falhar.
2.2. Definindo Nome e Parâmetros da Integração
Nome da Integração: Dê um nome que faça sentido para você e para sua equipe, como “Hotmart - Curso de [Seu Produto]” ou simplesmente “Hotmart Geral”, caso vá integrar vários produtos dentro da mesma conta.
2.3. Salvando e Testando
Confirmação: Depois de salvar a integração, o Torelyze normalmente exibirá uma mensagem de sucesso ou um status de que a integração foi concluída.
Teste: Se possível, gere uma venda de teste (ou uma compra real, caso você já esteja em campanha). Se a configuração estiver correta, e você já tiver o produto cadastrado no Torelyze (com ID da Hotmart), a venda deve aparecer no seu painel do Torelyze.
3. Cadastrando o Produto no Torelyze com o Código (ID) da Hotmart
Esta etapa é fundamental para que o Torelyze entenda a qual produto correspondem as vendas recebidas via webhook:
3.1. Localizando o Módulo de Produtos
Como achar: Procure no menu do Torelyze a seção de “Produtos” ou “Catalogar Produtos”. Essa área é onde você organiza tudo o que é vendido por meio da sua estrutura digital, sejam infoprodutos, cursos, mentorias ou assinaturas.
3.2. Criando um Novo Produto
Cadastro Básico: Clique em “Criar Produto” ou “Adicionar Novo Produto”.
Nome: Insira o nome do produto, exatamente (ou de forma muito próxima) como você o chama na Hotmart.
Código/ID: Haverá um campo para inserir o código obtido na Hotmart. Copie e cole aqui o ID obtido na tela de Produtos da Hotmart, garantindo que o Torelyze vai conseguir relacionar as vendas.
Outras Informações (opcionais): Em muitas plataformas, você pode registrar descrição, preço e outras especificidades. Preencha conforme a sua necessidade e a forma como você organiza esse produto.
3.3. Salvando o Cadastro do Produto
Validação: Após salvar, verifique se o produto foi criado corretamente. O Torelyze normalmente exibirá o produto na lista, com o ID da Hotmart associado.
4. Vinculando o Produto à Integração
Uma vez que você criou a integração (passo 2) e cadastrou o produto (passo 3), o último passo é dizer ao Torelyze que determinado produto está atrelado à integração da Hotmart que você configurou.
4.1. Acessando as Configurações do Produto
Onde Fica: Normalmente, após cadastrar o produto, você pode editar suas configurações ou preferências. Procure algo como “Opções Avançadas” ou “Integrações” dentro do cadastro do produto.
4.2. Selecionando a Integração Hotmart
Escolha da Integração: Haverá um campo ou lista de integrações disponíveis. Se você só tem uma integração Hotmart, selecione-a. Caso tenha múltiplas, selecione a correspondente.
4.3. Salvando as Configurações
Conclusão: Ao salvar, o Torelyze passa a saber que as vendas vindas via webhook daquela integração correspondem a esse produto. Assim, toda vez que a Hotmart notificar a compra aprovada, o sistema conseguirá apresentar as vendas no seu painel e executar automações (caso existam).
Entendendo em Profundidade: Hotmart, Torelyze e Boas Práticas
Até aqui, abordamos o passo a passo básico. Agora, vamos nos aprofundar em cada detalhe para chegar, ao final, a um artigo realmente completo e que contemple as melhores práticas.
Por que Integrar Hotmart e Torelyze?
A Hotmart é uma solução que, por si só, já oferece ferramentas de pagamento, área de membros (para alguns produtos) e relatórios de vendas. No entanto, se você usa o Torelyze para organizar tarefas, gerenciar lançamentos, centralizar dados de produtos, conversas de equipe, senhas, links úteis e até anúncios, faz todo sentido integrar também a parte de vendas. Assim, você não precisará verificar manualmente quantas vendas foram realizadas: elas serão automaticamente atualizadas no seu painel do Torelyze.
Essa centralização facilita:
Análise de Desempenho: Você consegue cruzar dados de vendas com tarefas de lançamento, anúncios rodando e muito mais, tudo em um único painel.
Automação de Fluxos: Se o Torelyze permitir, é possível disparar notificações internas ou até criar tarefas automáticas quando um cliente faz uma compra aprovada.
Visão Estratégica: Ao reunir métricas de vendas com dados de produtividade e organização, você tem uma visão ampla e embasada para tomadas de decisão.
Webhooks: Conceito e Funcionamento
Um “webhook” é, em termos simples, um aviso automático enviado de um sistema para outro quando algum evento ocorre. Aqui, esse evento é “compra aprovada” na Hotmart. Assim que alguém compra e o pagamento é confirmado, a Hotmart dispara uma requisição (HTTP POST, geralmente) para a URL que você configurou no webhook.
Cabeçalhos e Dados: Junto com essa requisição, vem um conjunto de dados que descreve a compra (valor, dados do comprador, status da transação, ID do produto, etc.).
Validação: O Torelyze recebe essa informação e valida usando o HOTTOK. Se estiver tudo certo, registra a venda no painel.
Importância do Endpoint Correto: Se você errar o endpoint ou inserir um token incorreto, o Torelyze não vai conseguir processar os dados corretamente, e as vendas não aparecerão.
Segurança na Transmissão
A Hotmart costuma usar HTTPS para enviar os dados ao webhook, garantindo criptografia na transmissão. Já a chave HOTTOK serve como camada adicional de verificação. No Torelyze, há mecanismos que checam se o HOTTOK recebido corresponde ao que está configurado, evitando disparos de origem duvidosa. Ainda assim, algumas boas práticas incluem:
Não Compartilhar Publicamente o HOTTOK: Ele deve ficar restrito aos responsáveis pela configuração.
Usar Senhas Fortes no Torelyze: A segurança do seu painel Torelyze é tão importante quanto a segurança do webhook.
Monitorar Logs: Sempre que possível, verifique se houve tentativas de envio suspeitas, principalmente se notar discrepâncias nos registros de vendas.
Possíveis Erros e Como Evitá-los
Erro de Endpoint Inválido: Se a URL de webhook estiver incorreta ou se houver um problema com SSL, a Hotmart poderá não conseguir entregar os dados. Verifique se o endpoint funciona (responde 200 OK, por exemplo) e se o certificado SSL está válido.
Produto não Cadastrado: A notificação chegou ao Torelyze, mas você esqueceu de cadastrar o produto ou de vincular a integração. Resultado: a venda não vai aparecer. Cumpra rigorosamente os passos 3 e 4 descritos.
Incompatibilidade de ID: Às vezes, as pessoas confundem o “ID do produto” com outros códigos da Hotmart. Verifique com atenção qual é o ID correto. Se você usar um código errado, não haverá correspondência com o produto no Torelyze.
Atraso na Notificação: Embora geralmente seja quase em tempo real, pode haver atrasos na notificação dependendo de instabilidades na internet ou na própria Hotmart. Se isso ocorrer, aguarde alguns minutos e verifique se o problema se resolve sozinho.
Explorando Funcionalidades Avançadas
A integração em si é relativamente simples, mas talvez você queira expandir o uso de dados que chegam da Hotmart. Eis alguns recursos adicionais que podem enriquecer sua gestão no Torelyze:
1. Automação de Tarefas Pós-Venda
Se o seu objetivo é oferecer um onboarding ao cliente ou acionar sua equipe de suporte, você pode configurar o Torelyze para criar tarefas assim que uma venda é registrada. Por exemplo:
Criar tarefa de “Envio de Boas-Vindas” para o time de suporte.
Automaticamente adicionar um comentário na área de anotações com os dados do comprador (quando permitido legalmente).
Isso reduz a chance de qualquer novo comprador ficar sem atenção e ajuda a construir um relacionamento melhor logo após a compra.
2. Segmentação de Produtos
Se você vende mais de um curso ou serviço, pode aproveitar a capacidade do Torelyze para segmentar produtos e gerar relatórios específicos. Assim, é possível verificar quantas vendas cada produto obteve em determinado período, comparar conversões, analisar resultados de lançamentos e cruzar dados com as campanhas de anúncios.
3. Integração com Outros Gateways
Dependendo do plano contratado ou das funcionalidades que você precisa, o Torelyze pode integrar também com outras plataformas de pagamento (por exemplo, Kiwify ou Eduzz). Ter todas essas integrações unificadas num único local potencializa a análise de desempenho do seu negócio como um todo.
4. Registro de Upsells e Bumps
Se você tem funis na Hotmart que incluem upsells ou “bumps” de última hora, o webhook pode notificar cada nova compra aprovada. No Torelyze, essas vendas adicionais podem ser registradas como produtos separados ou como variações do produto principal, dependendo de como você estruturou tudo. Isso oferece uma visão detalhada de quais upsells estão performando melhor.
Benefícios Concretos da Integração
Pode parecer que integrar “só” serve para ver vendas consolidadas. Porém, há benefícios tangíveis que impactam diretamente na organização e no faturamento:
Redução de Retrabalho: Sem a necessidade de ficar verificando a Hotmart manualmente, você evita lapsos de informação e consegue focar em estratégias para aumentar vendas.
Rapidez na Tomada de Decisão: Ao ter dados atualizados em tempo real no Torelyze, é mais fácil identificar se o desempenho de um lançamento está abaixo do esperado e tomar ações corretivas.
Organização Centralizada: Quando suas vendas, suas tarefas e sua gestão de equipe estão em um único painel, a sinergia das informações faz com que o trabalho flua de forma mais natural.
Perguntas Frequentes (FAQ)
1. Posso ter vários produtos vinculados ao mesmo HOTTOK e à mesma integração? Sim, se você vende diversos produtos na mesma conta Hotmart, eles usarão a mesma chave de autenticação (HOTTOK). A distinção é feita pelo ID de cada produto. Portanto, no Torelyze, você pode ter vários produtos, cada um com seu respectivo ID, mas vinculados à mesma integração Hotmart.
2. E se eu tiver múltiplas contas Hotmart? Nesse caso, você pode criar integrações separadas no Torelyze, cada uma com o respectivo HOTTOK. Assim, dá para gerenciar várias contas Hotmart dentro do mesmo ambiente.
3. O que acontece com os reembolsos ou cancelamentos? Depende de como você configurar o webhook na Hotmart. Se quiser que o Torelyze receba informações de reembolsos ou cancelamentos, você pode criar um webhook para esses eventos também. Assim, o sistema poderá registrar a mudança de status nos relatórios.
4. Preciso de um plano específico no Torelyze para ter acesso a integrações? Pode acontecer dos planos evoluírem, e este artigo não acompanhar na mesma velocidade. Portanto, o ideal é checar os detalhes de cada modalidade no site de Pricing do Torelyze. Porém, sim. Precisa ter um plano mínimo para ter acesso às integrações.
5. É necessário conhecimento técnico ou de programação? A configuração de webhooks geralmente não exige habilidades avançadas de programação. Basta entender onde pegar o HOTTOK na Hotmart, onde colar a URL de webhook e como cadastrar o produto no Torelyze. De modo geral, as interfaces são intuitivas, e o processo se resume a copiar e colar códigos e URLs.
6. A Hotmart cobra algo adicional por usar webhooks? Até o momento, não há cobrança extra da Hotmart para utilização dos webhooks. É um recurso nativo para quem vende produtos na plataforma. Porém, as políticas podem mudar; vale confirmar diretamente na documentação oficial.
7. Consigo ver o nome do comprador, e-mail ou detalhes pessoais no Torelyze? Depende das informações que a Hotmart envia via webhook. Normalmente, ao menos o e-mail vêm no payload, mas há dados sensíveis que podem ou não estar disponíveis. Além disso, é sempre bom respeitar a LGPD (Lei Geral de Proteção de Dados), garantindo que haja consentimento do usuário.
8. Posso configurar notificações de vendas na mesma hora em que acontecem? Sim. Em geral, o webhook é disparado quase em tempo real, permitindo que o Torelyze receba a informação em segundos ou poucos minutos após a aprovação da compra.
Checklist Interno de Validação
Para garantir que você não se perca em nenhum detalhe, aqui vai um checklist rápido para verificar a configuração:
Tenho a URL do Webhook configurada na Hotmart?
Copiei e colei corretamente o HOTTOK no Torelyze?
Criei o produto na Hotmart e anotei seu ID de forma exata?
Cadastrei esse produto no Torelyze, com o mesmo ID da Hotmart?
Vinculei o produto no Torelyze à integração da Hotmart?
Realizei um teste de compra (real ou de teste) para verificar se os dados aparecem no Torelyze?
Verifiquei os logs de eventos (se existirem) no Torelyze para confirmar que a notificação chegou?
Responder “sim” a todos esses pontos indica que a configuração provavelmente está correta.
Exemplos Práticos de Uso
Caso 1: Lançamento de Curso Online (Fórmula Completa de “X”)
Imagine que você tem um curso que ensina “X” (pode ser marketing digital, culinária, finanças, etc.). Todo mês, você faz uma campanha de anúncios. Quando as vendas acontecem via Hotmart, você quer ver instantaneamente no Torelyze quantas vendas ocorreram, emitir alertas para a equipe e ainda disparar e-mails de boas-vindas.
Como se Beneficiar:
Assim que uma compra é aprovada, Torelyze registra a venda e aciona uma notificação interna.
Você consegue, em tempo real, acompanhar se a meta diária de vendas está sendo atingida.
Em caso de qualquer anomalia (por exemplo, se em um dia não ocorrer nenhuma venda ou se o volume de vendas cair drasticamente), você identifica rapidamente e faz ajustes na estratégia de anúncios.
Caso 2: Afiliados que Promovem Seu Produto
Se você tem afiliados promovendo seu produto na Hotmart, pode configurar para que todas as vendas entrem no Torelyze. Embora a distinção de qual afiliado vendeu possa ainda ficar na Hotmart, você terá a consolidação de quantas vendas totais ocorreram em cada dia. Depois, pode ir à Hotmart para detalhes de comissionamento.
Caso 3: Prestação de Serviços Digitais + Pagamentos via Hotmart
Alguns profissionais vendem consultoria ou serviços digitais, usando a Hotmart como meio de pagamento. Se esse é o seu caso, ao integrar com o Torelyze, cada nova contratação notificada pela Hotmart gera tarefas e checklists de atendimento no seu painel, assegurando que você não esqueça de iniciar o projeto de cada cliente.
Reflexões Finais e Próximos Passos
Entramos em detalhes sobre cada fase do processo, contemplamos as vantagens e as questões de segurança, além de analisarmos cenários práticos de aplicação. Agora, vamos consolidar esse conhecimento de modo que você se sinta seguro a dar o próximo passo.
Reveja as Configurações: Mesmo que o passo a passo seja simples, um pequeno erro de digitação ou a cópia de um HOTTOK incompleto podem comprometer toda a integração. Vale a pena investir alguns minutos conferindo tudo minuciosamente.
Documente Internamente: Se você tem equipe, crie um pequeno manual interno (ou use a Base de Conhecimento do próprio Torelyze) para instruir seus colaboradores sobre como manter e monitorar essa integração.
Expanda Suas Integrações: Caso goste do processo, explore outras integrações do Torelyze, como plataformas de anúncios ou de e-mail marketing. Quanto mais informações você centraliza, maior a clareza estratégica.
Analise o ROI: Pergunte a si mesmo quanto tempo você gastava antes para controlar as vendas na Hotmart e compará-las com suas campanhas e tarefas. Agora que tudo está centralizado, esse tempo deve cair bastante, aumentando sua produtividade e impactando positivamente o ROI.
Conclusão
Integrar a Hotmart ao Torelyze é um processo relativamente simples, mas extremamente poderoso para quem vende infoprodutos, cursos, mentorias e serviços digitais. Ao seguir o resumo prático logo no início e, depois, mergulhar em cada etapa de forma detalhada, você consegue:
Garantir que as vendas aprovadas na Hotmart sejam registradas em tempo real no seu painel do Torelyze.
Vincular cada venda a um produto específico, facilitando a identificação de qual estratégia de lançamento ou qual campanha gerou melhores resultados.
Automatizar processos internos no Torelyze, como criação de tarefas de suporte ou disparo de avisos para a equipe, gerando mais profissionalismo na entrega do seu produto ou serviço.
Ganhar uma visão clara e integrada de todos os aspectos do seu negócio: equipe, tarefas, eventos, vendas e anúncios, tudo em um só lugar.
Para quem leva a sério o crescimento e a organização de um negócio digital, essa é uma das integrações mais importantes a se fazer. Afinal, tempo é dinheiro, e ao centralizar as informações você reduz retrabalhos, melhora a comunicação interna e toma decisões mais inteligentes, baseadas em dados reais.
Se você ainda tem dúvidas, vale a pena conferir a documentação oficial do Torelyze e da Hotmart, ou mesmo contactar o suporte de ambas as plataformas para esclarecimentos adicionais. No mais, mãos à obra! Siga o passo a passo descrito, teste com uma venda inicial (real ou de teste) e, em poucos minutos, você terá a confirmação de que tudo está fluindo corretamente.
Com isso, esperamos que este artigo sirva como um guia definitivo para a integração entre Hotmart e Torelyze, contribuindo não só para a implementação, mas também para o entendimento do potencial que essa integração oferece para o crescimento do seu negócio digital.
Last updated