Como configurar a API do meu produto usando o Webhook (Postback)?

Se você quer automatizar ações importantes no seu negócio digital, como liberar acesso a um curso assim que uma compra for aprovada, configurar sua API via Webhook pode ser uma ótima solução. 

Neste artigo, vamos te explicar o que é o Webhook, como configurar suas notificações automáticas de acordo com eventos de compra, onde acompanhar os envios realizados, além de como testar a integração para garantir que tudo esteja funcionando direitinho.

O que é o Webhook da Hotmart?

O Webhook é uma ferramenta da Hotmart que permite que você integre sua API para receber notificações automáticas, sempre que houver uma atualização no status de uma transação. Em outras palavras, você configura uma URL e, sempre que ocorrer um evento (como uma venda aprovada, um reembolso ou uma assinatura cancelada), a Hotmart envia uma notificação para essa URL.

Essa funcionalidade é bastante útil, por exemplo, se você disponibiliza seu produto em uma área de membros externa e quer liberar o acesso do comprador de forma automática após a confirmação do pagamento.

Como configurar o Webhook?

A configuração é simples e você pode personalizar tudo conforme os eventos que mais fazem sentido para o seu negócio. Para isso, basta seguir os passos indicados abaixo:

1. Acesse sua conta pelo link: https://app.hotmart.com/login. 
2. No menu lateral esquerdo, clique em Ferramentas, seguido de Ver todas. 
3. Selecione a opção Webhook (API e notificações) ou busque diretamente na barra de busca da página.
4. Clique em + Cadastrar Webhook para iniciar uma nova configuração
5. Defina um nome para a segmentação, escolha os eventos que deseja monitorar e adicione a URL de envio.
   • Observação: Se a URL cadastrada apresentar erro, a Hotmart desativa automaticamente a configuração para evitar o envio de notificações incorretas.
6. Escolha se deseja aplicar essa configuração a todos os seus produtos ou a um produto específico.
7. Clique em Salvar.

Você pode criar quantas configurações quiser, além de editar, desativar ou excluir quando necessário. Tudo isso direto da mesma tela, apenas clicando nos botões localizados do lado direito da tela.

❯ Quais eventos posso acompanhar com o Webhook?

Ao configurar o Webhook, você pode escolher entre os seguintes eventos:

• Para compras: compra cancelada, compra completa, aguardando pagamento, compra aprovada, compra reembolsada, chargeback, compra expirada, pedido de reembolso, compra atrasada.
• Para assinaturas: cancelamento de assinatura, troca de plano, atualização de data de cobrança da assinatura.
• Para Club: primeiro acesso, módulo completo.
• Outros: abandono de carrinho.

Dica: Use os eventos a seu favor! Por exemplo, crie uma segmentação específica para recuperação de vendas, marcando eventos como “compra atrasada” ou “pedido de reembolso”.

Também é possível permitir que afiliados recebam notificações com o link e código do boleto das vendas realizadas pelo hotlink deles. Mas atenção: para isso funcionar, é necessário liberar o acesso às informações do comprador para os afiliados.

Para mais informações sobre o uso de Webhooks e APIs para otimizar os processos do seu negócio, consulte esta página. 

Como acompanho o histórico de notificações enviadas?

No próprio menu do Webhook, você encontra a aba Histórico, onde pode acompanhar todos os envios feitos, os status e até o conteúdo das notificações.  

Os posts com erro são reenviados automaticamente até cinco vezes, ou até receberem uma resposta positiva do servidor. É possível reenviar manualmente um post clicando no ícone de seta na coluna de Ações.

Você também pode visualizar o Payload (conteúdo da notificação enviada) e o Histórico de Responses, que mostra o retorno dado pela sua URL para cada evento. Para isso, clique no ícone de lupa, localizado na coluna de Ações.

Importante: Se você já usava o Webhook (Postback) antes da atualização, você poderá consultar os posts enviados antes da atualização da ferramenta. Para isso, clique nas abas Posts enviados ou Posts pendentes.
Os eventos são armazenados e listados no histórico por até 60 dias.

Perguntas frequentes

❯ Posso testar se o Webhook está funcionando?

Sim! A Hotmart permite que você realize testes de envio para verificar se a integração está funcionando corretamente.

Para isso, acesse a tela de Webhook, vá até a aba Minhas configurações e, ao lado direito da configuração desejada, clique no ícone de lista. Assim, você poderá executar um teste de envio para confirmar se a URL configurada está recebendo as notificações corretamente.