O que é Webhook e para que serve?
Webhooks são uma forma da Lastlink enviar automaticamente informações para outros sistemas ou ferramentas sempre que algo importante acontece na sua conta, como uma venda concluída, um pagamento confirmado ou um carrinho abandonado.
Com webhooks, você pode, por exemplo, liberar o acesso a cursos ou conteúdos assim que o pagamento for confirmado, atualizar planilhas de vendas automaticamente ou enviar notificações para sua equipe ou clientes.
Na prática, funciona assim: quando um evento ocorre na Lastlink (como uma venda confirmada), a plataforma envia automaticamente as informações sobre esse evento para o sistema ou ferramenta que você configurou, que então realiza as ações desejadas, como liberar acesso, atualizar registros ou avisar sua equipe.
⚠️ O Orderbump não dispara webhooks; apenas os eventos principais da plataforma são enviados.
Passo a passo para configurar
Na Lastlink, acesse o menu Produtos e clique no produto que deseja integrar.
Nas configurações do produto, acesse Integrações e busque por Lastlink - Webhook, em seguida clique no botão Ativar.
Clique em Novo webhook na parte superior à direita.
Preencha os dados de configuração do webhook:
Nome do webhook
URL fornecida pela plataforma externa. (Essa é a URL de recepção (endpoint), ou seja, o “endereço” para onde a Lastlink enviará as informações do evento)
Escolha quais eventos serão enviados, clicando em Selecionar. Após escolher, confirme as informações no painel.
Para conferir se o evento está sendo disparado corretamente, você pode clicar em “Testar” ou utilizar outra ferramenta externa. (Explicamos melhor abaixo)
Para finalizar, clique em Salvar.
Dessa forma, seu webhook estará configurado e ativo!
Como testar o Webhook?
Antes de ativar o webhook definitivamente, é importante testar se o envio das informações está funcionando corretamente.
Teste via Lastlink
O botão Testar na Lastlink envia uma simulação do evento configurado para a URL que você cadastrou. Ele serve para verificar rapidamente se a comunicação entre a Lastlink e a plataforma externa está funcionando.
Obs: Esse teste não mostra o conteúdo completo do evento (JSON).
Teste via Webhook.site
Se quiser ver de forma mais técnica e detalhada o que está sendo transmitido, ou seja, o conteúdo em formato JSON, você também pode usar uma ferramenta externa. Para fazer isso:
Acesse webhook.site;
Copie a URL gerada automaticamente;
Cole essa URL no campo URL do webhook na Lastlink;
Obs: Esta URL serve apenas para testar. Para liberar acesso a conteúdos reais, configure a URL da plataforma externa conforme as instruções do sistema que receberá os eventos.
Clique em “Testar”.
Volte ao site Webhook.site e confira, no lado esquerdo da página, todos os eventos disparados e o conteúdo em JSON. Alguns eventos podem aparecer duplicados, dependendo do método de pagamento utilizado.
⚠️ Em caso de erro durante a configuração, verifique se a plataforma externa com a qual está tentando integrar possui compatibilidade com o envio de webhooks da Lastlink. Plataformas sem integração direta podem não receber ou processar corretamente as informações enviadas.
Eventos e propriedades enviados
Carrinho Abandonado
Nome do evento: [Abandoned_Cart]
Quando é enviado: Quando o lead abandona o carrinho e não confirma a compra, após 30 minutos da sua última ação na página de checkout.
Pagamento Estornado
Nome do evento: [Payment_Chargeback]
Quando é enviado: Quando a fatura é estornada (Chargeback) e a compra cancelada.
Pagamento Reembolsado
Nome do evento: [Payment_Refund]
Quando é enviado: Quando a fatura foi reembolsada e a compra cancelada via sistema Lastlink.
Compra Completa
Nome do evento: [Purchase_Order_Confirmed]
Quando é enviado: Quando a compra é realizada e pagamento do produto foi confirmado, concedendo acesso ao membro no produto.
Pedido de Compra Cancelado
Nome do evento: [Purchase_Request_Canceled]
Quando é enviado: Quando o cliente não realiza o pagamento, cancelando a fatura gerada.
Fatura Criada
Nome do evento: [Purchase_Request_Confirmed]
Quando é enviado: Quando o cliente finaliza o checkout e a fatura é criada.
Pedido de Compra Expirada
Nome do evento: [Purchase_Request_Expired]
Quando é enviado: Quando a compra expira, ou seja, não foi paga dentro do prazo definido pelo método de pagamento escolhido pelo comprador.
Pagamento de Renovação Efetuado
Nome do evento: [Recurrent_Payment]
Quando é enviado: Quando o pagamento da fatura de renovação da assinatura foi confirmado.
Período de Reembolso Terminado
Nome do evento: [Refund_Period_Over]
Quando é enviado: Em sete dias após a compra, prazo limite para solicitar reembolso. Aplica-se apenas à primeira compra.
Assinatura Cancelada
Nome do evento: [Subscription_Canceled]
Quando é enviado: Quando o cliente cancelou a recorrência da assinatura.
Assinatura Expirada
Nome do evento: [Subscription_Expired]
Quando é enviado: Quando o pagamento da fatura de renovação não foi realizado, expirando a fatura.
Liberação e Remoção de Acesso
Nome do evento: [Product_access_started / Product_access_ended]
Quando é enviado: Quando o acesso do membro ao produto é liberado ou removido, dependendo do status de pagamento ou convite.
Assinatura Pendente de Renovação
Nome do evento: [Subscription_Renewal_Pending]
Quando é enviado: Quando um novo ciclo de recorrência iniciou e estamos aguardando o pagamento para renovar a assinatura.
Notificar Membro Ativo
Nome do evento: [Active_Member_Notification]
Quando é enviado: Notificação enviada para membros que estão ativos em determinado produto ou assinatura.
Início da Liberação de Acesso
Nome do evento: [Product_access_started]
Quando é enviado: Quando o membro recebe acesso ao conteúdo, seja por confirmação de pagamento ou convite.
Fim da Liberação de Acesso
Nome do evento: [Product_access_ended]
Quando é enviado: Quando o acesso do membro ao conteúdo é removido por falta de pagamento ou término do período de convite.
Reembolso Solicitado
Nome do evento: [Refund_Requested]
Quando é enviado: Quando o cliente solicita reembolso do produto adquirido.
Documentação dos Webhooks
Para entender melhor a estrutura técnica do Webhook, confira nosso artigo de Documentação de Webhook da Lastlink e veja os detalhes em JSON e as orientações técnicas para desenvolvedores.
Perguntas Frequentes
1. O que acontece se eu excluir um webhook?
Ao excluir um webhook, os eventos deixam de ser enviados para o endereço configurado. Se quiser voltar a utilizá-lo, será necessário criar novamente.
2. O evento não chegou ou o teste apresentou erro. O que fazer?
Verifique primeiro se a plataforma externa é compatível com integrações via webhook. Se ela não possuir um endpoint público ou não aceitar requisições externas, o envio não será concluído.
Para confirmar se o evento está sendo realmente enviado pela Lastlink, realize o teste com o webhook.site e consulte nossa documentação de webhooks. Essa é a forma mais simples de visualizar o conteúdo completo do webhook em formato JSON, e analisar a compatibilidade de informações.
3. O que significa o formato JSON?
O formato JSON é uma linguagem de comunicação de dados usada entre sistemas. No webhook, ele transmite informações como nome do comprador, valor e produto, para que a plataforma externa consiga interpretar e usar esses dados corretamente.
4. O webhook demora para refletir eventos?
O envio é automático e quase em tempo real. Alguns eventos, porém, podem levar alguns minutos para aparecer no painel.
5. Posso ativar todos os eventos de uma vez?
Pode, mas o ideal é ativar apenas os eventos que realmente serão utilizados. Isso evita tráfego desnecessário e facilita o monitoramento e os testes.
Em casos de dúvidas, acione nosso suporte pelo chat!