Principal Automação / Integrações Como integrar HeroSpark com a Toolz

Como integrar HeroSpark com a Toolz

Última atualização em Sep 22, 2026

É possível integrar a HeroSpark com área de membros como a Toolz para matricular e cancelar a matrícula de um aluno em uma turma.

Passo 1 - Crie o produto na HeroSpark

Clique no menu Produtos e Criar novo produto. Siga as instruções na tela até finalizar a criação do produto.

Passo 2 - Gere o Token API Toolz

Solicite ao suporte da Toolz o Token para integração via webhook com a Herospark. Guarde o token para usar no Passo 4.

Passo 3 - Localize o ID da turma na Toolz

No menu lateral clique em Painel do administrador, Unidades e clique em Entrar para selecionar a unidade.

Dentro da unidade clique no menu Turmas e em Visualizar Turma.

Na barra de endereço do navegador copie e guarde o número que está após a turma/. Repita esse processo para todas as turmas que pretende incluir na integração.

Selecione as opções Pagamento confirmado, Pagamento confirmado order bump, Estorno feito pelo produtor, Chargeback, Estorno order bump, Assinatura cancelada pelo cliente, Assinatura cancelada pelo produtor e Pagamento inadimplente.

Em todas as automações selecione a opção Gerar um Webhook.

Em todas as automações selecione a opção Gerar um Webhook.

Atenção! Para cada produto criado na HeroSpark que será integrado com a Toolz é necessário criar novamente todas as automações acima!

Passo 5 - Configurar Automações na HeroSpark para Matricular o aluno em uma turma na Toolz

Para as automações de Pagamento confirmado, Pagamento confirmado order bump faça as seguintes configurações para matricular o aluno:

A. Filtro de disparo

Selecione Produtos específicos. Esse é o produto na HeroSpark que vai disparar a automação para matricular o aluno.

B. Edição de webhook

Preencha com a URL com: https://kong.api.toolzz.com.br/api/classes/IDDATURMA/attach. Substitua o id da turma pelo copiado no Passo 3. 

Mantenha o método como Post.

C. Headers

Crie as chaves abaixo preenchendo os campos com:

Chave: Authorization

Valor: Bearer token api da Toolz

Atenção! Ao colar os dados nos campos, cuidado para não deixar espaços entre o Authorization e no token api existe um espaço entre o Bearer e o restante do código.

D. Body

Preencha o campo com: 

{"users": [{"cpf": "{{ buyer_document_id | replace: '.', '' | replace: '-', '' | replace: '/', '' }}","name": "{{ buyer_name }}","email": "{{ buyer_email }}","enrollment_renewal": false}]}

Clique em Salvar edição para finalizar a configuração.

Passo 6 - Configurar Automações na HeroSpark para Cancelar a matrícula do aluno em uma turma na Toolz

Para as automações de Estorno feito pelo produtor, Chargeback, Estorno order bump, Assinatura cancelada pelo cliente, Assinatura cancelada pelo produtor e Pagamento inadimplente faça as seguintes configurações para cancelar a matrícula:

A. Filtro de disparo

Selecione Produtos específicos. Esse é o produto na HeroSpark que vai disparar a automação para cancelar a matrícula do aluno.

B. Edição de webhook

Preencha com a URL com: https://kong.api.toolzz.com.br/api/classes/IDDATURMA/detach. Substitua o id da turma pelo copiado no Passo 3. 

Mantenha o método como Post.

C. Headers

Crie as chaves abaixo preenchendo os campos com:

Chave: Authorization

Valor: Bearer token api da Toolz

Atenção! Ao colar os dados nos campos, cuidado para não deixar espaços entre o Authorization e no token api existe um espaço entre o Bearer e o restante do código.

D. Body

Preencha o campo com: 

{"users": [{"name": "{{ buyer_name }}","email": "{{ buyer_email }}"}]}

Clique em Salvar edição para finalizar a configuração.

Passo 7 - Testar automações

Clique no botão Testar automação e aguarde a exibição da confirmação do teste.

Clique em Histórico para visualizar o log. Nele é possível verificar através do status Executado e resposta 200 que o teste foi realizado com sucesso e nesse mesmo log também ficam registrados os envios reais após o acionamento das automações.

Atenção! O teste sempre envia os mesmos dados fictícios para a Toolz.

Problemas?

Caso você tenha problemas, entre em contato diretamente com o suporte da Toolz.