...
...
Para integração da HeroSpark com seu app da Entrega Digital, siga os passos abaixo.
No painel da Herospark HeroSpark no menu "Piloto automático” clique no botão “usar modelo de automação”. Essa ação precisará ser repetida 4 vezes, uma para cada tipo de webhook.
Assinatura cancelada pelo sistema e/ou produtor;
Estorno feito pelo produtor;
Assinatura cancelada pelo cliente;
Pagamento confirmado
Crie todas para cada uma das opções acima com a ação gerar webhoookWebhoook.
...
Após criados os Webhooks, edite cada um deles:
...
na Opção HEADERS, adicione em todos o método POST
...
com a chave Content-Type
...
e valor application/json conforme imagem abaixo.
...
A Na parte URL e Body, deverá ser preenchido conforme cada webhook de acordo com a lista abaixo. Essa lista contém todas as URLs, mas lembre-se de substituir "{domain}” pelo domínio do seu app EDM que está sendo configurado.
Todas as automações possuem o mesmo Body
...
. Copie o trecho abaixo e cole em todas
...
.
| Code Block |
|---|
{"data":{"buyer":{"name":"{{ buyer_name }}","email":"{{ buyer_email }}","checkout_phone":"{{ buyer_phone_raw }}"},"product":{"id":"{{ product_id }}","name":"{{ product_name }}"},"producer":{"name":"{{ school.name }}"},"purchase":{"offer":{"code":"{{ offer_id }}","kind":"{{ offer_kind }}"},"price":{"value":"{{ offer_price }}"},"status":"{{ payment_status }}","payment":{"type":"{{ payment_method }}"},"order_date":"{{ payment_date }}","transaction":"{{ payment_id }}","approved_date":"{{ payment_date }}"},"subscription":{"status":"{{ subscription_status }}","subscriber":{"code":"{{ offer_id }}{{ buyer_email }}"},"next_invoice":"{{ subscription_next_invoice_at }}","expiration_at":"{{ subscription_expiration_at }}","available_until":"{{ subscription_available_until }}","subscription_id":"{{ subscription_id }}"}},"event":"MUDAR"} |
Substitua o atributo “event” no final do trecho acima pelos valores Na última linha, ao lado do atributo “event”, substitua o atributo “MUDAR” pelo valor abaixo para cada caso:
Assinatura cancelada pelo produtor
URL: https://api-{domain}.entregadigital.app.br/api/tools/webhooks/herospark/subscription-cancelled
"event": "SUBSCRIPTION_CANCELLATION"Estorno feito pelo produtor
URL: https://api-{domain}.entregadigital.app.br/api/tools/webhooks/herospark/purchase-refunded
"event": "PURCHASE_REFUNDED"Assinatura cancelada pelo cliente
URL: https://api-{domain}.entregadigital.app.br/api/tools/webhooks/herospark/subscription-cancelled
"event": "SUBSCRIPTION_CANCELLATION"Pagamento confirmado
URL: https://api-{domain}.entregadigital.app.br/api/tools/webhooks/herospark/purchase-approved
"event": "PURCHASE_APPROVED"
Exemplo de como ficará o preenchimento com a alteração acima:
...
Configurado os webhooks, agora acesse o painel EDM → Ferramentas → Configurações → Técnicas. Na área de funcionalidades, ative a integração com a Herospark.
Com a integração
...
Herospark ativada, agora é possível configurar os Ids externos de produtos e assinaturas. Atenção! Os IDs utilizados para a venda de produtos é obtido de forma diferente do de assinaturas, como explicado abaixo.
Para a venda de produtos
No painel da Herospark, clique em Produtos, seleciona selecione o produto desejado e na lateral direita, clique no botão Editar na aba de Configurações de vendas.
...
e abra a edição Na URL do produto desejado. Na Url selecionado, será possível obter o ID do produto, esse ID será usado como ID externo no painel EDM, conforme exemplo abaixo.
...
Para a venda de assinaturas:
Como se é possível ter diferentes assinaturas (mensal, anual
...
) que correspondem ao mesmo produto, o ID utilizado como id externo no painel EDM é o ID da página de venda da assinatura.
Para acessar,
...
Caso ainda não possua uma oferta de assinatura, crie uma. Copie o link e novamente você encontrará o ID necessário.
...
siga o mesmo passo inicial dos produtos: clique em Produtos, selecione o produto desejado e na lateral direita, clique no botão Editar na aba de Configurações de vendas. Na próxima tela, clique em Ofertas. Caso já tenha criado as ofertas, basta clicar no botão copiar link na oferta desejada, conforme exemplo abaixo.
...
Com o link copiado, basta colar no navegador para encontrar o ID necessário.
...
Esse ID obtido na HeroSpark deverá ser colado no painel EDM na assinatura ou produto que que devem ser liberado.
Para liberar uma assinatura: no painel da EDM, acessar no menu esquerdo a opção Sua loja, Planos de Assinatura e selecionar a aba Lojas Externas na assinatura que estará sendo liberada nessa oferta. Colar o ID conforme exemplo abaixo e salvar.
...
Para liberar um pacote de produtos: no painel da EDM, acessar no menu esquerdo a opção Sua loja > Pacotes de Produtos e selecionar a aba Lojas Externas no pacote de Produtos que deve ser liberado. Colar o ID conforme exemplo abaixo e salvar.
...
A sua configuração com a Herospark deve estar finalizada. O próximo passo e testar todas as vendas que serão realizadas no app para garantir que está tudo configurado e funcionando conforme desejado.