Herospark

Owned by Átila
Last updated: Feb 20, 2024
4 min read

Para integração da HeroSpark com seu app da Entrega Digital, siga os passos abaixo.

  1. No painel da 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 para cada uma das opções acima com a ação gerar Webhoook.

image-20240219-132227.png



  1. 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.

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.

 

  1. Todas as automações possuem o mesmo Body. Copie o trecho abaixo e cole em todas.

{"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"}

 

Na última linha, ao lado do atributo “event”, substitua o atributo “MUDAR” pelo valor abaixo para cada caso

Exemplo de como ficará o preenchimento com a alteração acima:

 

  1. 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, selecione o produto desejado e na lateral direita, clique no botão Editar na aba de Configurações de vendas.

 

Na URL do produto 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, 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.

  1. 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.

 

  1. 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.