Quer adicionar, suspender ou remover estudantes no seu curso de eLearning da Builderall de forma automática?
Você está no lugar certo.
Este guia mostra exatamente como conectar plataformas externas como sistemas de pagamento, CRMs ou ferramentas de automação ao eLearning da Builderall usando webhooks seguros.
Se você precisa registrar novos estudantes de forma automática, suspender o acesso deles por um tempo ou remover tudo de vez, este passo a passo vai dar tudo o que você precisa para fazer isso acontecer.
Nesta guia você vai aprender: #
- Como funciona
- Erros comuns e como resolver
- Recomendações finais
Aviso sobre curso de teste #
Os exemplos abaixo usam credenciais de teste (id=3550 e uma chave secreta de demonstração) criadas exclusivamente para validação interna.
Por favor, gere sua própria URL de webhook segura dentro das configurações do curso no eLearning da Builderall.
Para obter os endpoints e integrar com seu sistema externo, vá em:
Cursos → Editar curso
Integrações → Adicionar nova integração
Personalize o nome da integração e clique em Criar integração
Para pegar seus endpoints URLs, clique aqui:
Copie os endpoints URLs gerados:
Nunca compartilhe em público sua chave secreta de produção.
Como funciona resumo de endpoints Webhook #
O eLearning da Builderall oferece três endpoints seguros para gerenciar o acesso dos estudantes:
Adicionar ou registrar um estudante
Endpoint:https://elearning.builderall.com/hooks/add.php?id=SEU_ID_DO_CURSO&secret=SUA_SECRET
Método: POST
Parámetros:
- email: endereço do estudante obrigatório
- password: senha do estudante opcional se não enviar o sistema cria uma automaticamente.
Resposta de exemplo:
{
"error": 0,
"data": {
"student_email": "ejemplo@email.com",
"student_password": "autoGenerada123",
"course_url": "https://elearning.builderall.com/course/..."
}
}Use este endpoint depois de um pagamento concluído ou de alguma ação que ative o registro.
Desativar um estudante suspensão temporária
Endpoint:https://elearning.builderall.com/hooks/deactivate.php?id=SEU_ID_DO_CURSO&secret=SUA_SECRET
Método: POST
Parámetros:
- email: endereço do estudante obrigatório
Resposta de exemplo:
{
"error": 0,
"data": "Student deactivated"
}Ideal para casos de suspensão temporária por exemplo quando não há pagamento. O progresso fica salvo e pode ser reativado depois.
Remover um estudante remoção permanente
Endpoint:https://elearning.builderall.com/hooks/remove.php?id=SEU_ID_DO_CURSO&secret=SUA_SECRET
Método: POST
Parámetros:
- email: endereço do estudante obrigatório
Resposta de exemplo:
{
"success": 1,
"details": "User removed"
}Use isso apenas se você realmente precisar remover o estudante por completo e não quiser manter o progresso
Erros comuns e como resolver #
| Resposta de erro | Causa | Solução |
| { “error”:1, “details”:”Email parameter is empty” } | O parâmetro email não foi enviado ou está com problema. | Confirme que o email está sendo enviado corretamente no corpo do POST. |
| {“error”:1,”details”:”User not found”} | O endereço não corresponde a nenhum estudante registrado. | Verifique se o estudante está registrado antes de desativar ou remover. |
| {“success”:0,”details”:”Invalid secret key”} | A chave secreta usada na URL está incorreta ou já não vale mais. | Gere uma nova chave secreta nas configurações do curso. |
| {“error”:1,”details”:”Method not allowed”} | A solicitação foi enviada com GET em vez de POST. | Todos os endpoints precisam do método POST. |
Recomendações finais #
- Use o parâmetro deactivate ponto php em vez de remove ponto php quando for suspensão temporária para manter o progresso do aluno.
- Nunca compartilhe sua chave secreta em público.
- Use sempre o método POST. GET não funciona.
- Funciona com ferramentas como Zapier, Make, PHP, Node ponto js e qualquer sistema que envie requisições POST.
- Teste suas integrações em um ambiente seguro antes de usar em produção.
Precisa de ajuda para configurar essa integração ou automatizar mais processos? Estou aqui para ajudar você a expandir sua experiência educativa digital
Vamos construir algo incrível juntos! 🚀
Éricka Castro
Head of Strategic Customer Success – Builderall
