Central de ajuda · Ligar vendas

Como ligar a Hotmart à Vozea

Cada compra aprovada na Hotmart vira um pedido de depoimento na Vozea — e um reembolso, chargeback ou cancelamento de assinatura para o pedido sozinho. A ligação é um webhook criado no painel da Hotmart, com o Hottok da sua conta colado na Vozea.

Leva uns 5 minutos · conferido na documentação oficial em 17/9/2026

O que você precisa

• Sua conta na Vozea, em Coletar › Vendas.
• Acesso de produtor à sua conta na Hotmart (app.hotmart.com).
• Duas abas abertas lado a lado: a Vozea e a Hotmart.

Passo a passo

1. 1

   Na Hotmart, copie o Hottok da sua conta

   Entre em app.hotmart.com. No menu lateral esquerdo, clique em Ferramentas, depois em Ver todas, e escolha Webhook (API e notificações) — ou digite "Webhook" na barra de busca da página. Na tela do Webhook, abra a aba Autenticação e copie o Hottok de verificação.

   Atenção: O Hottok é um só por conta (não muda por webhook). É ele que prova para a Vozea que a chamada veio da Hotmart.

2. 2

   Na Vozea, crie a conexão

   Em Coletar › Vendas, clique em Ligar no cartão da Hotmart. Cole o Hottok no campo Hottok e clique em Criar conexão. O cartão da conexão aparece com a URL do webhook — clique em Copiar.

   Atenção: Se preferir, deixe o Hottok em branco e cole depois em Gerenciar. Até lá, a Vozea recusa as chamadas (isso é proposital).

3. 3

   Na Hotmart, cadastre o webhook

   De volta à tela do Webhook, na aba Minhas configurações, clique em + Cadastrar Webhook e preencha: Nome da configuração (por exemplo, Vozea); Selecione um produto: Todos os produtos, ou só o produto de que você quer pedir depoimento; Url para envio de dados: a URL copiada da Vozea; Selecione uma versão: 2.0.0; Eventos para enviar: os eventos da lista abaixo. Clique em Salvar.

   Atenção: Escolha a versão 2.0.0 — a Vozea lê esse formato. Se a Hotmart oferecer só uma versão, é essa.

4. 4

   Confira se o Hottok está na Vozea antes de testar

   Se você deixou o Hottok em branco no passo 2, abra Gerenciar no cartão da conexão, cole o Hottok e salve. Só então teste.

   Atenção: Com o Hottok errado ou vazio a Vozea responde 401, e a Hotmart desativa sozinha uma configuração cuja URL responde erro. Por isso o Hottok entra antes do teste.

Eventos para marcar

• ✓ Compra aprovada
• ✓ Compra reembolsada
• ✓ Chargeback
• ✓ Compra cancelada
• ✓ Pedido de reembolso
• ✓ Cancelamento de assinatura

Compra aprovada é a que vira pedido. As outras cinco são as que desfazem a venda: com elas marcadas, a Vozea para o pedido pendente e não manda lembrete a quem pediu o dinheiro de volta. Os demais eventos (boleto impresso, compra completa, compra expirada, troca de plano, carrinho abandonado…) podem ficar desmarcados — se vierem, a Vozea só ignora.

Como testar

1. Na Hotmart, na aba Minhas configurações, ao lado direito da configuração da Vozea, clique no ícone de lista e execute um teste de envio.
2. Na Vozea, em Coletar › Vendas › Últimas vendas, a chamada aparece em segundos. O teste da Hotmart usa dados de exemplo — se virar um pedido agendado, pare-o em Coletar › Na fila.
3. O histórico de tudo que a Hotmart mandou fica na aba Histórico da tela do Webhook (por 60 dias), com o conteúdo e a resposta da Vozea. Dá para reenviar um evento por ali, ou em Vendas › Minhas Vendas › Ações › Detalhes › Reenviar Post.

Depois de ligar

• Cada venda aparece em Coletar › Vendas › Últimas vendas em segundos, com o que a Vozea fez com ela: pedido agendado (e para quando), já estava na fila, evento ignorado, produto fora do filtro, venda desfeita.
• O pedido de depoimento sai 7 dias depois da compra (você muda em Gerenciar: outro prazo, ou o fim da garantia na Hotmart). Quem responde não recebe mais nada; quem não responde recebe até dois lembretes.
• Reembolso, chargeback e assinatura cancelada param o pedido pendente sozinhos — desde que esses eventos estejam marcados no webhook.
• Por e-mail o pedido sai sozinho a partir do plano Essencial. Por WhatsApp a Vozea monta a mensagem e o pedido entra na lista do dia em Coletar, para você mandar com um toque.
• Só na Hotmart: em Gerenciar você pode trocar "Quando pedir" para No fim da garantia — o pedido sai no dia seguinte ao fim da garantia que a Hotmart informa na venda, quando o comprador já decidiu ficar.
• Em Gerenciar › Só estes produtos você escolhe de quais produtos pedir; a lista se monta com as vendas que chegam.

Problemas comuns

A configuração ficou desativada na Hotmart

A Hotmart desativa uma configuração cuja URL respondeu erro. Quase sempre é o Hottok errado ou vazio na Vozea (a Vozea responde 401). Corrija em Gerenciar, reative a configuração na Hotmart e teste de novo.

"Assinatura não confere" em Últimas vendas

O token colado na Vozea não é o mesmo da plataforma. Confira em Gerenciar, cole de novo sem espaços e salve. A plataforma reenvia a chamada sozinha (ou use o botão de teste dela).

"Só e-mail — sai sozinho no Essencial"

A venda veio só com e-mail e a conta está no Grátis: o pedido por e-mail automático é do plano Essencial. Vendas com telefone entram na lista do dia para você mandar pelo WhatsApp.

"Evento ignorado"

A plataforma mandou um evento que não é compra aprovada nem cancelamento (boleto gerado, pix gerado, carrinho abandonado…). É normal: só a compra aprovada vira pedido.

"Já estava na fila"

A mesma venda chegou duas vezes, ou o mesmo cliente comprou o mesmo produto enquanto o pedido anterior ainda estava aberto. A Vozea não pede duas vezes.

"Sem nome ou contato no JSON"

A chamada veio na versão 1.0.0 ou sem os dados do comprador. Na configuração da Hotmart, confira a versão 2.0.0. Como afiliado, o produtor precisa liberar os dados do comprador.

Fontes

Os nomes de menus, botões e campos deste manual foram conferidos em:

• Central de Ajuda Hotmart — Como configurar a API do meu produto usando o Webhook (Postback)?
• Hotmart Developers — Eventos de pedido (Webhook 2.0.0)

Ficou com dúvida? Escreva para contato@vozea.io.