A HotZapp é um sistema focado na recuperação de carrinho, sendo assim, o objetivo deste
tutorial é integrar as soluções. Enviando as informações de compras recusadas, boletos
expirados e outros eventos para o sistema da HotZapp.
Assim, é possível disparar não apenas quando a ação é efetuada (Pix vencido por exemplo),
mas também os dados do aluno que disparou o evento, como nome, e-mail e telefone.
Auxiliando e podendo ser utilizado no contato com o mesmo, fazendo a recuperação de
carrinho diretamente pelo sistema da HotZapp.
Clique aqui e conheça a documentação utilizado como base para a integração.
Passo 01:
Ao entrar no menu de "Piloto automático" dentro de seu painel administrativo da HeroSpark, é
possível visualizar todos os eventos referentes ao checkout e abandono de carrinho:
Neste exemplo, usaremos o modelo "Cartão recusado". Porém, todos os eventos podem ser utilizados!
Passo 02
Ao escolher o modelo, o sistema irá perguntar se quer seguir para a ação de envio de e-mail ou de
Webhook. Neste caso, seguiremos com "Webhook":
Passo 03
Agora, dentro da automação já criada. Será necessário realizar a configuração da mesma:
Aqui, iremos realizar as primeiras configurações:
URL: a URL é o destino de nosso Webhook. Neste caso, é necessário copiar a URL diretamente
da sua conta da HotZapp seguindo a documentação do sistema: https://hotzapp.me/suporte/integracoes/webhooks-de-pedidos
Método: O método é o tipo de requisição que iremos enviar. Neste caso, como estamos criando
um novo registro no sistema da Hotzapp iremos enviar no formato POST.
Headers: Os Headers são informações que ajudarão na comunicação entre o envio e o
recebedor da requisição. Neste caso, estamos declarando o formato JSON (Content-Type
application/json) que é a forma que o Hotzapp e a maioria dos sistemas recebem as requisições.
Passo 05
Neste passo, iremos configurar o "body" da requisição que enviaremos. O "body" é todas as
informações que o recebedor (neste caso, a HotZapp) irá receber da HeroSpark.
É uma parte sensível, e importante destacar que deve ser escrito no formato de JSON:
Body exemplo:
{"email": "{{buyer_email}}", "name": "{{buyer_name}}", "phone":
"{{buyer_phone}}", "total_price": "{{offer_price}}",
"payment_method": "credit", "financial_status": "refused",
"currency": "R$", "transaction_id": "", "transcation_error_msg":
"{{credit_card_refused_message}}"}
Neste caso, estamos passando o e-mail, nome, telefone, valor e mensagem de erro da
transação específica do aluno que disparou o evento.
Além disso, estamos passando de forma estáticas os campos de "Método de pagamento",
"Status do pagamento", "Moeda", e enviando o ID da transação como vazio já que o mesmo foi
um abandono. Seguindo a documentação da HotZapp.
Passo 04
Feito isso, seu webhook está totalmente configurado e deve ser disparado e recebido no
sistema da HotZapp.
Basta salvar a edição e ativa-lá:
As variáveis que podem ser utilizadas são:
Variáveis:
{{buyer_email}} - Email do comprador
{{buyer_name}} - Nome do comprador
{{buyer_phone}} - Telefone do comprador
{{offer_price}} - Preço do produto
{{offer_discount}} - Desconto do produto (Caso tenha)
{{offer_kind}} - Tipo da oferta
{{product_id}} - ID do produto
{{product_name}} - Nome do produto
{{payment_id}} - ID do pagamento
{{payment_method}} - Método do pagamento
Também temos variáveis específicas de eventos:
Boleto:
{{boleto_expiration_at}} - Data de expiração do boleto
Pix:
{{pix_expiration_at}} - Data de expiração do Pix
Cartão de crédito:
{{credit_card_refused_message}} - Motivo da recusa do cartão
Assinatura:
{{subscription_canceled_by}} - Responsável pelo cancelamento
{{subscription_status}} - Status da assinatura