Como habilitar integração com a HeroSpark
A HeroSpark é uma ferramenta completa para lançamento de infoprodutos. Com ela você pode criar qualquer tipo de produto digital e fazer todas as etapas do lançamento, desde a captação de leads até as vendas.
Com a HeroSpark você pode: Criar um produto digital do zero, Montar uma página de captura de alta conversão, Fazer todo o fluxo de nutrição de leads, Disparar e-mails ilimitados e Hospedar seu produto em uma página de venda exclusiva.
Ou seja, a HeroSpark é uma ferramenta poderosa que agrega em um só lugar toda sua estratégia de marketing digital e vendas. Isso garante um planejamento e uma execução mais eficientes para disparar seus negócios no digital.
Acesse sua conta na HeroSpark e clique no menu Piloto Automático.
Na tela exibida, clique no botão Usar Modelo de Automação e em seguida, escolha o modelo Pagamento Confirmado, clicando em Usar este modelo.
Na próxima tela, selecione a opção Gerar um Webhook no campo Ação a ser realizada.
No campo Filtro de Disparo, selecione a opção Aplicar em todos os produtos ou a opção Produtos específicos se for emitir nota fiscal apenas para determinados produtos.
Mais abaixo, temos a opção Edição de Webhook. Preencha da seguinte forma:
URL: https://api.spedy.com.br/v1/orders
Método: POST
Agora, precisamos copiar a Credencial de API na tela Minha Empresa, na Spedy.
Em sua conta na Spedy, clique sobre o nome de usuário no canto superior direito e vá em Minha Empresa.
Em seguida, clique no botão Credenciais da API.
Pronto. A credencial está copiada e podemos voltar a configurar o Webhook na HeroSpark.
No agrupamento Headers, clique no botão + Adicionar e preencha os campos da seguinte forma:
Chave: X-Api-Key
Valor: Cole a Credencial de API copiada na tela Minha Empresa
Clique novamente no botão + Adicionar para inserirmos uma nova chave e preencha os campos da seguinte forma:
Chave: Content-Type
Valor: application/json
Agora, vamos para o último campo da automação que é o campo Body.
Neste campo, copie e cole o seguinte script:
{ "date": "{{ payment_date }}", "items": [ { "price": "{{ offer_price | divided_by: 100.00 }}", "amount": "{{ payment_value | divided_by: 100.00 }}", "product": { "code": "{{ product_id }}", "name": "{{ product_name }}", "price": "{{ offer_price | divided_by: 100.00 }}", "invoiceModel": "serviceInvoice" }, "quantity": 1, "description": "{{ product_name }}" } ], "amount": "{{ payment_value | divided_by: 100.00 }}", "status":"approved","customer": { "name": "{{ buyer_name }}", "email": "{{ buyer_email }}","address": { "city": { "name": "{{ buyer_city }}", "state": "{{ buyer_state | default: 'ex' }}" },"number":"{{buyer_address_number }}", "street": "{{ buyer_address_street }}", "district": "{{ buyer_district }}", "postalCode": "{{ buyer_zip_code }}", "additionalInformation": "{{ buyer_complement }}" },"mobilePhone": "{% if buyer_phone | size != 15 %}Null{% else %}{{ buyer_phone }}{% endif %}", "federalTaxNumber": "{{ buyer_document_id | remove: '.' | remove: '-' }}" }, "warrantyDate": "{{ payment_date | date: '%s' | plus: 604800 | date: '%Y-%m-%d %H:%M:%S' }}", "autoIssueMode": "afterWarrency", "paymentMethod": "{% if payment_method == 'credit_card' %}creditCard{% elsif payment_method == 'bank_slip' %}billetBank{% else %}pix{% endif %}", "transactionId": "{{ payment_id }}", "sendEmailToCustomer": true }
Para concluir, clique em Salvar Edição.
Para confirmar que o Script ficou correto, edite o gatilho Pagamento confirmado. O campo Body estará da seguinte forma:
Agora, após o disparo do gatilho de Pagamento confirmado, uma venda será enviada para a Spedy, para emissão de uma Nota Fiscal de Serviços.
Se você precisar emitir Nota de Comércio (NFe - Modelo 55) para as suas vendas, faça o seguinte procedimento:
Edite o gatilho Pagamento confirmado e, no campo Body, altere o valor da variável invoiceModel para productInvoice.
Clique em Salvar edição para concluir.
Por fim, na tela de Piloto Automático vamos ativar as integração para que as vendas sejam integradas na Spedy.
Pronto! Sua integração está concluída. A partir de agora, suas vendas na HeroSpark serão integradas na Spedy para emissão das notas fiscais.
Serão integradas somente as vendas realizadas após a ativação do Pilotos Automático. Vendas retroativas não serão integradas automaticamente.
Vendas estornadas não serão atualizadas na Spedy. O cancelamento da nota fiscal precisará ser realizada manualmente na Spedy.
Viu como é simples e fácil utilizar nossa plataforma? Cuidamos de suas notas fiscais para que você foque no crescimento do seu negócio.
Caso ainda tenha alguma dúvida, entre em contato conosco através de um de nossos canais de atendimento.
Até mais
Com a HeroSpark você pode: Criar um produto digital do zero, Montar uma página de captura de alta conversão, Fazer todo o fluxo de nutrição de leads, Disparar e-mails ilimitados e Hospedar seu produto em uma página de venda exclusiva.
Ou seja, a HeroSpark é uma ferramenta poderosa que agrega em um só lugar toda sua estratégia de marketing digital e vendas. Isso garante um planejamento e uma execução mais eficientes para disparar seus negócios no digital.
Habilitando a integração
Acesse sua conta na HeroSpark e clique no menu Piloto Automático.
Na tela exibida, clique no botão Usar Modelo de Automação e em seguida, escolha o modelo Pagamento Confirmado, clicando em Usar este modelo.
Na próxima tela, selecione a opção Gerar um Webhook no campo Ação a ser realizada.
No campo Filtro de Disparo, selecione a opção Aplicar em todos os produtos ou a opção Produtos específicos se for emitir nota fiscal apenas para determinados produtos.
Mais abaixo, temos a opção Edição de Webhook. Preencha da seguinte forma:
URL: https://api.spedy.com.br/v1/orders
Método: POST
Agora, precisamos copiar a Credencial de API na tela Minha Empresa, na Spedy.
Em sua conta na Spedy, clique sobre o nome de usuário no canto superior direito e vá em Minha Empresa.
Em seguida, clique no botão Credenciais da API.
Pronto. A credencial está copiada e podemos voltar a configurar o Webhook na HeroSpark.
No agrupamento Headers, clique no botão + Adicionar e preencha os campos da seguinte forma:
Chave: X-Api-Key
Valor: Cole a Credencial de API copiada na tela Minha Empresa
Clique novamente no botão + Adicionar para inserirmos uma nova chave e preencha os campos da seguinte forma:
Chave: Content-Type
Valor: application/json
Agora, vamos para o último campo da automação que é o campo Body.
Neste campo, copie e cole o seguinte script:
{ "date": "{{ payment_date }}", "items": [ { "price": "{{ offer_price | divided_by: 100.00 }}", "amount": "{{ payment_value | divided_by: 100.00 }}", "product": { "code": "{{ product_id }}", "name": "{{ product_name }}", "price": "{{ offer_price | divided_by: 100.00 }}", "invoiceModel": "serviceInvoice" }, "quantity": 1, "description": "{{ product_name }}" } ], "amount": "{{ payment_value | divided_by: 100.00 }}", "status":"approved","customer": { "name": "{{ buyer_name }}", "email": "{{ buyer_email }}","address": { "city": { "name": "{{ buyer_city }}", "state": "{{ buyer_state | default: 'ex' }}" },"number":"{{buyer_address_number }}", "street": "{{ buyer_address_street }}", "district": "{{ buyer_district }}", "postalCode": "{{ buyer_zip_code }}", "additionalInformation": "{{ buyer_complement }}" },"mobilePhone": "{% if buyer_phone | size != 15 %}Null{% else %}{{ buyer_phone }}{% endif %}", "federalTaxNumber": "{{ buyer_document_id | remove: '.' | remove: '-' }}" }, "warrantyDate": "{{ payment_date | date: '%s' | plus: 604800 | date: '%Y-%m-%d %H:%M:%S' }}", "autoIssueMode": "afterWarrency", "paymentMethod": "{% if payment_method == 'credit_card' %}creditCard{% elsif payment_method == 'bank_slip' %}billetBank{% else %}pix{% endif %}", "transactionId": "{{ payment_id }}", "sendEmailToCustomer": true }
Para concluir, clique em Salvar Edição.
Para confirmar que o Script ficou correto, edite o gatilho Pagamento confirmado. O campo Body estará da seguinte forma:
Agora, após o disparo do gatilho de Pagamento confirmado, uma venda será enviada para a Spedy, para emissão de uma Nota Fiscal de Serviços.
Se você precisar emitir Nota de Comércio (NFe - Modelo 55) para as suas vendas, faça o seguinte procedimento:
Edite o gatilho Pagamento confirmado e, no campo Body, altere o valor da variável invoiceModel para productInvoice.
Clique em Salvar edição para concluir.
Por fim, na tela de Piloto Automático vamos ativar as integração para que as vendas sejam integradas na Spedy.
Pronto! Sua integração está concluída. A partir de agora, suas vendas na HeroSpark serão integradas na Spedy para emissão das notas fiscais.
Serão integradas somente as vendas realizadas após a ativação do Pilotos Automático. Vendas retroativas não serão integradas automaticamente.
Vendas estornadas não serão atualizadas na Spedy. O cancelamento da nota fiscal precisará ser realizada manualmente na Spedy.
Viu como é simples e fácil utilizar nossa plataforma? Cuidamos de suas notas fiscais para que você foque no crescimento do seu negócio.
Caso ainda tenha alguma dúvida, entre em contato conosco através de um de nossos canais de atendimento.
Até mais
Atualizado em: 04/06/2025
Obrigado!