O Webhook é a ferramenta de API e notificações da Hotmart. Ao usá-la, é possível receber as notificações via post para a(s) URL(s) cadastradas pelo(a) Produtor(a) na plataforma Hotmart, de acordo com a atualização do status de uma transação.
Por exemplo, se um Produtor disponibiliza o conteúdo do seu produto em uma área de membros externa, o Webhook viabiliza a liberação do acesso do cliente ao produto assim que a transação assume o status de "compra aprovada".
Como configurar
1. Acesse sua conta na Hotmart pelo link: https://app-vlc.hotmart.com/login
2. No menu lateral à esquerda, opte por Ferramentas
3. Clique em Webhook (API e Notificações)
4. Na nova tela, você pode adicionar suas configurações no símbolo de +
5. Crie a nova configuração. Insira o nome da segmentação e marque os eventos desejados.
Os eventos disponíveis são: compra cancelada, compra completa, boleto impresso, compra aprovada, pedido de reembolso, compra reembolsada, chargeback, compra expirada e compra atrasada.
Em seguida, escolha se você quer que a segmentação abranja todos os produtos ou somente um produto específico e insira a URL de envio.
Dica 1: você pode explorar estes eventos para criar segmentações importantes para o seu negócio. Como por exemplo, uma segmentação para recuperação de vendas, selecionando pedidos de reembolso, chargeback, assinaturas em atraso e etc.
Dica 2: você também pode permitir que o(a) Afiliado(a) receba um post com o link e o código do boleto cada vez que uma compra for realizada pelo hotlink dele. Atenção, pois, para que o post seja enviado, você deve permitir que o(a) Afiliado(a) tenha acesso às informações do comprador. Veja como fazê-lo aqui.
6. Clique em salvar
Você pode criar quantas configurações quiser, editá-las, desativá-las ou removê-las da lista. Para isso, basta selecionar o botão correspondente à ação na lateral direita da configuração
OBS.: caso a URL inserida apresente algum erro, a configuração será desativada automaticamente para que novas notificações não sejam enviadas desnecessariamente.
Veja um exemplo desse passo a passo no vídeo abaixo:
Criando a integração
Dentro do menu Webhook, você encontra toda a documentação necessária para configurar a sua integração.
Basta clicar na aba Documentação e consultar os parâmetros utilizados para gerar as notificações. Você encontrará as seguintes informações:
- Nome do parâmetro
- Se a informação é enviada ou não para o afiliado
- Descrição e explicação do parâmetro
- Formato e tamanho
Nesta aba, você também encontra o token de verificação e segurança.
Atenção: para efetuar essa integração, recomendamos que você peça auxílio a um programador ou que você possua conhecimentos em programação, ok?
Acompanhando o envio de posts
Dentro do menu Webhook, você encontra a aba Histórico. Nela, você pode acompanhar todos os envios realizados e o status.
Os posts que apresentarem erro serão reprocessados até terem uma resposta positiva do servidor ou completarem 5 tentativas. Se você quiser processá-lo novamente, basta clicar no botão com uma flecha ao lado do status do post.
Os status serão sempre indicados pelos códigos de HTTP.
Na aba Histórico, você também pode visualizar o Payload enviado (cada notificação enviada) e o Histórico de Responses dadas àquela notificação. Isto é, a carga de informações relevantes que foram enviadas naquele evento e qual foi o retorno do sistema notificado, além de ter as ações passadas registradas.
Confira onde encontrar o Histórico de Responses:
Atenção: 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.
Envio de teste de post
Você pode realizar testes para verificar o funcionamento correto da integração mediante eventos de testes no produto e na URL selecionadas.
Caso ainda tenha dúvidas ou dificuldades com relação a esse processo, entre em contato com o nosso Suporte! Estamos sempre à disposição para atendê-lo! :)
Comentários
0 comentário
Artigo fechado para comentários.