Como criar uma integração da Hotmart usando a versão 2.0 no Notificações Inteligentes?

Precisamos de informações básicas para funcionar! Se você é produtor, habilite o campo de telefone, nome e email durante o checkout. Sem ele, nós não conseguimos trabalhar, ok? Caso seja afiliado, peça ao produtor que a habilitação seja feita.

Como configurar a integração?

Dentro do Notificações Inteligentes

Para criar a integração, acesse a sua conta do Notificações Inteligentes e clique em Lojas:



Na página, clique em Criar loja:



Em seguida, na opção Descrição, é possível dar um apelido para a integração criada:



Na Plataforma, selecione a opção com o nome da integração, na categoria Plataforma de Afiliados, como demonstrado na imagem abaixo.

Dentro da Hotmart:

Para fazer a integração, você terá que executar algumas tarefas quando chegar à tela onde tem os campos de Id do cliente, Segredo de chave do cliente e Token da API. Veja:



Acesse a página inicial da hotmart:



Em seguida, procure a opção Ferramentas, no canto esquerdo da tela, e clique sobre ela:



Você será redirecionado para a tela de ferramentas. Agora, localize a opção Credenciais Hotmart:



Logo após, clique em Criar Credencial, como indica a imagem abaixo:



No campo Nome, coloque um nome de sua escolha e clique em Concluir:



Após criar suas credenciais copie elas e as cole em seus respectivos campos no Notificações Inteligentes e clique em Configurar:





Depois de configurar sua loja retorne a página inicial da hotmart:



Em seguida, procure a opção Ferramentas, no canto esquerdo da tela, e clique sobre ela:



Você será redirecionado para a tela de ferramentas. Agora, localize a opção Webhook (API e Notificações):



Logo após, clique em Criar Configuração, como indica a imagem abaixo, para criar uma configuração de webhook:



Aparecerão vários campos de configurações, como você pode observar:



No campo Nome da configuração, coloque um nome de sua escolha:



No campo URL, coloque a URL da integração da Hotmart que criou no Notificações Inteligentes:

Caso não saiba onde pegar a URL no Notificações Inteligentes, acesse este artigo e siga o passo a passo.



No campo Selecione uma versão, selecione a versão 2.0.0 (recomendado) como demonstra a imagem:



No campo Selecione um evento, selecione a opção Todos como demonstra a imagem:



Por fim, clique em Salvar:



Você tem vários produtos e quer personalizar a mensagem para cada um deles?

Nesse caso, repita o procedimento para cada produto, na loja dentro do Notificações Inteligentes.

Observe que, ao configurar na plataforma (como indicado nos passos anteriores), selecione para qual produto você quer enviar a notificação. Assim, você vai conseguir segmentar a mensagem por produto, está bem?

Pronto! Sua integração foi feita com sucesso! Agora vamos começar a receber os eventos e, consequentemente, enviar as notificações.


Rastreamento

Essa plataforma possui variáveis de rastreamento!

Agora você pode ter acesso a dados sobre a origem das compras, proporcionando mais controle sobre suas vendas. Use essas informações para otimizar suas campanhas e melhorar a experiência de compra. Para dúvidas, estamos à disposição!

Como sei que deu certo?

Quer conferir se a integração do Notificações Inteligentes foi feita de maneira certa? Então, veja como você pode fazer a confirmação, seguindo estas etapas:

Verifique o checklist dentro da sua loja

Temos um checklist que te ajuda a entender se todas as configurações necessárias para o envio das notificações foram feitas.

Você consegue ter um exemplo do checklist logo abaixo:



Se todas as opções estiverem na cor verde, quer dizer que você fez todos os passos. Então, provavelmente, as notificações já devem estar sendo enviadas.

Acompanhe a tela de relatórios

Na tela de relatórios, seja da integração ou da instância, você consegue ter uma ideia geral das notificações que estão sendo enviadas.

Caso não saiba onde fica esta tela, acesse este artigo para saber como verificar os relatórios.

Verifiquei todos os passos acima e mesmo assim acredito que não esteja funcionando

Nesse caso, temos um checklist mais detalhado que você consegue ver aqui.

Sobre a não disponibilidade da funcionalidade de lembrador de boletos para boletos financiados pela plataforma

Infelizmente a Hotmart não fornece os dados do boleto quando ele é financiado pela plataforma, tornando inviável o nosso trabalho. Caso você queria muito essa funcionalidade, envie um email para o suporte da Hotmart em suporte@hotmart.com.br e solicite que no evento de aguardando pagamento via boleto, na modalidade financiado, seja adicionado dados de pagamento como: link do boleto, vencimento do boleto e código de pagamento.

Quando as notificações serão disparadas?

Como essa é uma integração instantânea, assim que a plataforma nos enviar as informações, iremos processar e agendar a mensagem na fila de envios. Caso você não saiba o que é uma fila de envios, clique aqui.

Quais são as notificações disponíveis?

Todas as notificações listadas na tabela abaixo estão disponíveis e funcionando. Antes de você conhecê-las, entenda como cada uma delas funciona.

Veja, então, o que significa cada coluna das notificações disponíveis:

Prioridade no caminho feliz: se esta função estiver disponível, ela vai indicar a ordem de envio das mensagens seguindo a lógica do chamado “caminho feliz”. Você pode ler mais sobre ele aqui;
Nome da notificação: é o nome que damos para a notificação dentro do nosso painel;
Como reconhecemos o evento: em algumas integrações, deixamos documentada a maneira como elas são reconhecidas pelo nosso sistema. Isso acontece porque algumas delas podem ser personalizadas. Mas, se o reconhecimento não estiver disponível, pode ficar tranquilo pois isso não afeta qualquer usabilidade do sistema.

Clique na imagem para aumentar



Se você usa hoje a opção de parcelamento inteligente disponível na Hotmart e precisa enviar notificações relacionadas a esta modalidade de pagamento, iremos funcionar perfeitamente enviando as notificações. Entretanto, o evento de parcelamento inteligente não está listado na tela de eventos, uma vez que as notificações são criadas com base nos eventos de assinatura.

Relação de status na HormatV2 e Eventos na plataforma

ABANDONED_CART - Evento de Carrinho Abandonado;
APPROVED - Evento de Pagamento Realizado;
BILLET_PRINTED - Evento de Aguardando Pagamento por Boleto;
CANCELED - Evento de Pedido Cancelado;
CHARGEBACK - Evento Inválido;
COMPLETED - Evento Inválido;
DELAYED - Evento de Pedido Expirado;
DISPUTE - Evento em Disputa;
EXPIRED - Evento Inválido/Assinatura Expirada;
REFUNDED - Evento de Reembolso;
STARTED - Evento de Pagamento Realizado;
WAITING_PAYMENT - Evento de Aguardando Pagamento.

Limite de Requisições da API

A API dessa integração tem limites definidos pela plataforma, o que faz com que o processamento precise ser mais lento. Por conta disso, algumas notificações podem acabar sendo perdidas.

Os limites são:
- 100 requisições por minuto.

Após exceder este limite, não iremos conseguir enviar as notificações corretamente, lembre-se que é uma limitação da plataforma integrada, e não do Notificações Inteligentes.

Atualizado em: 30/10/2024