1. Ajuda | Hubla
  2. Vendi pela Hubla e preciso de ajuda

Integração via Webhook na Hubla

Os webhooks da Hubla automatizam comunicações entre sistemas

Webhook é uma forma de comunicação entre dois sistemas, onde informações são enviadas automaticamente quando ocorre um evento.

Um evento é uma ação específica que ocorre na plataforma da Hubla, desencadeando ações automáticas em outras plataformas. Esses eventos são essenciais para acompanhar e responder às atividades dos usuários, como abandonar um carrinho de compras, realizar uma nova venda, cancelar uma assinatura, entre outros. Eles permitem a criação de estratégias eficazes de marketing e de relacionamento com os clientes, garantindo uma interação personalizada e oportuna em cada etapa do processo de compra.

Em alguns casos, a configuração de um webhook exige um nível de conhecimento técnico mais avançado. Nessas situações, sugerimos que você contrate um desenvolvedor para ajudá-lo.

Como configurar um Webhook na Hubla?

Para realizar a configuração de um webhook, siga o passo a passo:

  • Acesse https://app.hub.la/dashboard?provider=webhook#integrations
  • Caso a plataforma externa solicite a autenticação do token da Hubla, esse dado fica disponível na aba Autenticação:
  • Em seguida, na aba Configurações, você deverá criar as regras que irão disparar os eventos para a outra plataforma:
  • Ao criar uma regra, é importante se atentar:
    • Dê um nome para a regra, para facilitar a compreensão
    • Insira a URL para onde o evento será enviado. Essa informação deve ser verificada na plataforma de destino, ou seja, onde a área de membros estará hospedada.
    • Selecione o produto da Hubla que deseja configurar
    • Selecione o evento que será enviado. 

  • Após configurar, você pode ativar e desativar, testar a configuração (enviar um evento de teste), editar, ou deletar essa regra:
  • Na aba Histórico, você consegue verificar todas as vezes que um evento foi enviado:

Quais eventos são enviados pela Hubla?


Carrinho abandonado

  • Disparado quando um usuário acessa a página do checkout e preenche as informações de email ou telefone e não efetua a compra no período de 20 minutos.

Venda pendente

  • Disparado sempre que uma nova fatura é criada, mas ainda não foi paga.

Nova venda

  • Disparado sempre que uma fatura pendente é paga.

Novo usuário

  • Disparado quando um usuário faz uma compra pela primeira vez com um determinado criador (independente de qual grupo ou data, se o usuário já tiver comprado um grupo desse criador, o evento não será disparado).

Assinatura cancelada

  • Disparado sempre que uma assinatura é cancelada, seja por finalizado seus dias assinados ou porque o usuário cancelou sua renovação.

Venda em protesto

  • Disparado quando uma fatura entra em protesto, ou seja, o cliente contestou essa fatura através da bandeira do cartão de crédito.

Solicitação de reembolso

  • Disparado quando uma solicitação de reembolso é criada.

Venda cancelada

  • Disparado sempre que uma fatura é cancelada, seja por motivo de contestação, reembolso, etc.

Para a integração com o ActiveCampaign, temos mais 4 eventos: Venda Expirada, Venda Reembolsada, Venda Recusada e Chargeback.

Webhooks V2

Pensando em soluções de negócio mais robustas e complexas, com maiores estruturas de dados, a Hubla desenvolveu o Webhooks v2.0.0:

Membro

Acesso concedido

  • Evento disparado quando um membro passa a ter acesso a um determinado produto.

Acesso removido

  • Evento disparado quando um membro não tem mais acesso a um determinado produto.

Assinatura

Assinatura criada

  • Evento disparado quando uma assinatura é criada com sucesso. Isso não significa que a assinatura está ativa.

Assinatura ativada

  • Evento disparado quando a assinatura é ativada com sucesso. Isso significa que o membro possuí créditos disponíveis.

Assinatura expirada

  • Evento disparado quando uma assinatura expira.

Assinatura desativada

  • Evento disparado quando a assinatura é desativada com sucesso. Isso significa que o usuário não possuí créditos disponíveis.

Renovação automática desativada

  • Evento disparado quando a renovação automática de uma assinatura é desativada com sucesso. Isso significa que a assinatura não irá ser renovada automaticamente e quando chegar da data do vencimento ela irá ser desativada.

Renovação automática ativada

  • Evento disparado quando a renovação automática de uma assinatura desativada anteriormente, volta a ficar ativa.

Fatura

Fatura criada

  • Evento disparado quando uma fatura é criada com sucesso e já está disponível para pagamento.

Status da fatura atualizada

  • Evento disparado quando uma fatura tem o status atualizado com sucesso.

Pagamento da fatura realizado

  • Evento disparado quando uma fatura é paga com sucesso.

Pagamento da fatura falhou

  • Evento disparado quando uma fatura apenas com o método de pagamento sendo Cartão de Crédito efetua tentativa de cobrança e falha.

Fatura expirada

  • Evento disparado quando uma fatura não foi paga até a data de vencimento.

Fatura reembolsada

  • Evento disparado quando uma fatura que estava paga é reembolsada com sucesso.

Solicitação de Reembolso

Solicitação de Reembolso criada

  • Evento disparado quando uma solicitação de reembolso é criada.

Solicitação de Reembolso aceita

  • Evento disparado quando uma solicitação de reembolso é aceita, podendo ser automaticamente ou manual pelo vendedor.

Solicitação de Reembolso cancelada

  • Evento disparado quando uma solicitação de reembolso é cancelada pelo comprador.

Solicitação de Reembolso rejeitada

  • Evento disparado quando uma solicitação de reembolso é rejeitada pelo vendedor.