Configurar o recebimento dos webhook events

Através dos webhook events você conseguirá receber webhooks de eventos específicos, diretamente da Hubla, sem a utilização de outra plataforma.

1. Acesse a página da Hubla, vá até a seção “*Integrações”;*
2. Procure por Webhooks e clique em “Configurar”;
3. Na página de configurações, clique em "Adicionar webhook”:

<aside> 💡 Você pode criar mais de um webhook event, por exemplo, na URL X você pode receber eventos de NewSale e NewUser, na URL Y você pode receber eventos de NewSale e CanceledSale e etc.

</aside>

<aside> 💡 Você pode usar diferentes api keys para cada webhook event.

</aside>

Autenticação

Na aba de autenticação você encontrará um token que é enviado no header da chamada HTTP pela Hubla. Esse token vai no campo x-hubla-token e tem o objetivo de permitir que o servidor que recebe os eventos possa verificar a autenticidade do que está sendo recebido.

Além desse header, também existem outros dois:

• x-hubla-sandbox: Define se a requisição é do ambiente de teste
• x-hubla-idempotency: É um token de idempotência. Se você já tiver processado esse evento, pode apenas dar um skip se receber o mesmo token duas vezes nesse header.

Eventos

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.

Acesso concedido

• Disparado quando um membro passa a ter acesso a um determinado produto

Acesso removido

• Disparado quando um membro não tem mais acesso a um determinado produto

Envio dos webhook events

Os webhook events serão enviados como POST na sua URL com o body no seguinte padrão:

Novo usuário

{
	"type": "NewUser",
	"event": {
		"userId": "01GcniNRKgO122q0zrgi2Tbu7QB3",
		"userName": "Nome Sobrenome",
		"userEmail": "[email protected]",
		"userPhone": "+55 11 90000 1234",
		"groupId": "123456-3400",
		"amount": 50,
		"sellerId": "12345-11111",
		"userDocument": "051.713.580-95",
		"groupName": "Desafio de 30 Dias"
	}
}