Como configurar e usar o Checkout Webhook na plataforma
Lançado em: Agosto 2025
Sobre
O Checkout Webhook é uma funcionalidade que permite integrar seus cursos com sistemas externos através de disparos automáticos. Quando um aluno clica em "Comprar", o sistema aciona um disparo HTTP para a URL definida por você, enviando automaticamente os dados do aluno. Isso permite que você processe essas informações em sistemas externos como CRM, plataformas de pagamento personalizadas ou automação de marketing, oferecendo total flexibilidade na gestão de leads e vendas.
Como funciona
O sistema funciona como um gatilho: quando o aluno clica em "Comprar", é acionado automaticamente um disparo HTTP POST para sua URL configurada, enviando os dados do aluno (nome, e-mail e ID do curso). Seu sistema externo recebe esses dados e pode processá-los conforme sua necessidade - seja para criar um lead no CRM, gerar um checkout personalizado, aplicar regras de negócio específicas ou integrar com qualquer outro sistema. Após processar os dados, seu sistema deve retornar uma URL para onde o aluno será redirecionado.
Pré-requisitos
Antes de configurar o Checkout Webhook, certifique-se de que você possui:
-
Permissões para editar configurações de cursos.
-
Sistema externo com endpoint ativo que aceita requisições POST.
-
Suporte ao Content-Type: application/json.
-
Protocolo HTTPS configurado (obrigatório em produção).
Passo a passo
1º passo: Na tela de login, informe seu e-mail, senha e clique em "Entrar".
2º passo: No menu lateral, expanda a opção "Meu conteúdo" e clique em "Cursos". Você será direcionado para a página de gestão de cursos na rota: https://seudominio.app.toolzz.com.br/master/gestao/curso/livre/aluno?institution=suainstituicao
3º passo: Escolha se você quer configurar o webhook em um curso existente ou criar um novo curso.
-
Para curso novo:
- Clique no botão azul "+ ADICIONAR" no canto superior direito.
-
Para curso existente:
-
Localize o curso desejado na lista.
-
Clique no ícone de engrenagem ou botão "Editar Curso".
-
Atenção! Você só poderá configurar o Checkout Webhook em cursos que estejam ativos. Para cursos novos, será necessário completar as configurações básicas primeiro.
4º passo: Acesse o formulário de configuração do curso. Tanto para edição quanto para criação, você será direcionado para: https://seudominio.app.toolzz.com.br/master/gestao/curso/cursoslivres/novo?institution=suainstituicao
5º passo: Navegue até a seção de configurações de checkout. Role a página para baixo até encontrar as opções de checkout. Você verá duas opções:
-
"Checkout Externo?"
-
"Checkout webhook?"
Atenção! Ao ativar o "Checkout webhook?", o "Checkout Externo?" será automaticamente desativado. Apenas um pode estar ativo por vez.
7º passo: Configure a URL do webhook. Após ativar a chave do webhook, aparecerá automaticamente o campo "URL para Checkout Webhook". Insira sua URL completa neste campo.
Exemplo de URL válida: https://hook.make.com/xyz123abc456
Informação importante: A URL deve começar obrigatoriamente com "https://" e estar acessível pela internet. O sistema mostra a mensagem: "Ao ativar, o LMS enviará automaticamente os dados do aluno (nome, e-mail e ID do curso) via requisição HTTP para a URL informada abaixo, no momento em que ele clicar para se inscrever."
8º passo: Salve as configurações. Role até o final da página e clique no botão azul "SALVAR" para confirmar todas as configurações.
O sistema validará automaticamente sua URL e salvará as configurações se tudo estiver correto.
Dados enviados automaticamente (disparo do webhook)
Quando um aluno clica em "Comprar", o sistema dispara automaticamente uma requisição HTTP POST com os seguintes dados em formato JSON:
JSON
"body":{
"courseId":7753402,
"user":{
"id":77207093,
"name":"Aluno Toolzz"
}
},
Resposta esperada do seu sistema
Após receber e processar o disparo do webhook, seu sistema deve retornar uma resposta no seguinte formato:
JSON
{
"redirect": true,
"redirectUrl": "https://www.exemplo.com.br/"
}
O aluno será então redirecionado automaticamente para a URL retornada.
Exemplos com Query Parameters
json{ "redirect": true, "redirectUrl": "https://www.exemplo.com.br/?user_id=123&curso_id=456&status=concluido"}
json{ "redirect": true, "redirectUrl": "https://plataforma.instituicao.com/dashboard?origem=webhook&trilha_concluida=true&certificado=disponivel"}
Gerenciando configurações do Webhook
9º passo: Para verificar ou alterar configurações existentes, retorne ao formulário de edição do curso. Acesse novamente a página de cursos e clique em "Editar Curso" no curso configurado. Você poderá:
-
Ver o status atual do webhook (ativado/desativado).
-
Alterar a URL configurada.
-
Desativar temporariamente o webhook.
[ESPAÇO PARA IMAGEM: Formulário mostrando configurações existentes do webhook]
10º passo: Para desativar o webhook temporariamente, desative a chave "Checkout webhook?".
[ESPAÇO PARA IMAGEM: Processo de desativação do webhook]
Atenção! Ao desativar o Checkout webhook, os alunos voltarão a usar o sistema de checkout padrão da plataforma. Certifique-se de que isso não afetará suas vendas.
Solução de problemas
Problema: "URL Inválida" Sintomas: Mensagem de erro ao salvar. Soluções:
-
Verifique se a URL começa com "https://".
-
Confirme que não há espaços antes ou depois da URL.
-
Teste a URL em um navegador para verificar se está acessível.
Problema: "Webhook não dispara" Sintomas: O aluno clica em "Comprar" mas o disparo não é enviado. Soluções:
-
Verifique se seu endpoint está online.
-
Confirme que ele aceita requisições POST.
-
Teste com ferramentas como Postman ou curl.
-
Verifique os logs do seu sistema para confirmar recebimento.
Problema: "Redirecionamento não funciona" Sintomas: O disparo é recebido, mas o aluno não é redirecionado. Soluções:
-
Verifique o formato da resposta JSON.
-
Confirme que ela retorna ao campo "url_access".
-
Verifique se a URL de destino é válida e acessível.
-
Certifique-se de que seu sistema responde rapidamente (menos de 10 segundos).