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:
- Acesse sua conta pelo link: https://app.hotmart.com/login.
- No menu lateral esquerdo, clique em Ferramentas, seguido de Ver todas.
- Selecione a opção Webhook (API e notificações) ou busque diretamente na barra de busca da página.
- Clique em + Cadastrar Webhook para iniciar uma nova configuração
-
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.
- Escolha se deseja aplicar essa configuração a todos os seus produtos ou a um produto específico.
- 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.
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.