Automatize Matrículas: Guia Completo da API Toolzz LMS em 2026
Aprenda a automatizar a matrícula de alunos em turmas usando a API do Toolzz LMS e otimize a gestão da sua instituição.
Automatize Matrículas: Guia Completo da API Toolzz LMS em 2026
17 de abril de 2026
Gerenciar matrículas de alunos pode ser uma tarefa complexa e demorada, especialmente em instituições de ensino de grande porte. Processos manuais são propensos a erros, lentidão e exigem grande esforço da equipe administrativa. A automação desse processo, através da API do Toolzz LMS, permite otimizar o fluxo de trabalho, reduzir custos e garantir uma experiência mais eficiente para alunos e colaboradores.
Pré-requisitos
Para acompanhar este tutorial, você precisará de:
- Conta Toolzz LMS: Caso ainda não possua, crie uma conta em https://toolzz.com.br/lxp.
- Token do Administrador: Esse token será utilizado para autenticar suas requisições à API. Para gerar o token, siga os passos:
- Acesse o Toolzz LMS com sua conta de administrador.
- Vá em 'Configurações' -> 'API'.
- Clique em 'Gerar Token'.
- Copie o token gerado e guarde-o em um local seguro.
Dica: Trate seu token como uma senha. Não o compartilhe com terceiros e não o armazene em locais públicos.
Arquitetura da Solução
O fluxo de automação da matrícula de alunos via API Toolzz LMS segue o seguinte esquema:
- Sistema Externo: Um sistema de RH, um formulário de inscrição online ou qualquer outra fonte de dados com informações do aluno.
- API Toolzz LMS: As informações do aluno são enviadas para a API do Toolzz LMS através de requisições HTTP.
- Plataforma LXP: O Toolzz LMS processa as informações, cria o usuário (se necessário) e o matricula na turma desejada, atualizando a plataforma LXP automaticamente.
Para garantir que você tenha a plataforma ideal para implementar essa automação, conheça a Toolzz LXP e descubra como ela pode revolucionar a gestão da sua instituição.
Passo a Passo no Produto
No Toolzz LMS, você precisará configurar as turmas e os cursos antes de automatizar as matrículas.
- Criar Cursos: Acesse 'Cursos' e crie os cursos que serão oferecidos.
- Criar Turmas: Acesse 'Turmas', selecione o curso desejado e crie as turmas com as datas e horários correspondentes.
- Configurar Permissões: Garanta que o token do administrador tenha permissão para criar usuários, criar turmas e matricular alunos.
Implementação via API
Para automatizar a matrícula de alunos, utilizaremos os seguintes endpoints da API Toolzz LMS:
- Criar Usuário:
POST /api/v1/users - Matricular Aluno em Turma:
POST /api/v1/enrollments
Criar Usuário
URL: POST /api/v1/users
Headers:
{ "Authorization": "Bearer SEU_TOKEN", "Content-Type": "application/json" }
Body (JSON):
{ "name": "João da Silva", "email": "[email protected]", "cpf": "123.456.789-00", "password": "senha_segura", "school_id": "school_123" }
curl:
bash curl -X POST 'https://api.toolzz.com.br/api/v1/users' -H 'Authorization: Bearer SEU_TOKEN' -H 'Content-Type': 'application/json' -d '{"name": "João da Silva", "email": "[email protected]", "cpf": "123.456.789-00", "password": "senha_segura", "school_id": "school_123"}'
javascript (fetch):
javascript fetch('https://api.toolzz.com.br/api/v1/users', { method: 'POST', headers: { 'Authorization': 'Bearer SEU_TOKEN', 'Content-Type': 'application/json' }, body: JSON.stringify({ "name": "João da Silva", "email": "[email protected]", "cpf": "123.456.789-00", "password": "senha_segura", "school_id": "school_123" }) }) .then(response => response.json()) .then(data => console.log(data));
python (requests):
python import requests
url = 'https://api.toolzz.com.br/api/v1/users' headers = { 'Authorization': 'Bearer SEU_TOKEN', 'Content-Type': 'application/json' } data = { "name": "João da Silva", "email": "[email protected]", "cpf": "123.456.789-00", "password": "senha_segura", "school_id": "school_123" }
response = requests.post(url, headers=headers, json=data) print(response.json())
Parâmetros:
| Parâmetro | Tipo | Obrigatório | Descrição |
|---|---|---|---|
| name | string | Sim | Nome completo do aluno |
| string | Sim | Endereço de e-mail do aluno | |
| cpf | string | Sim | CPF do aluno |
| password | string | Sim | Senha do aluno |
| school_id | string | Sim | ID da escola a qual o aluno pertence |
Response (JSON):
{ "id": "user_123", "name": "João da Silva", "email": "[email protected]", "cpf": "123.456.789-00", "school_id": "school_123" }
Matricular Aluno em Turma
URL: POST /api/v1/enrollments
Headers:
{ "Authorization": "Bearer SEU_TOKEN", "Content-Type": "application/json" }
Body (JSON):
{ "user_id": "user_123", "class_id": "class_456" }
curl:
bash curl -X POST 'https://api.toolzz.com.br/api/v1/enrollments' -H 'Authorization: Bearer SEU_TOKEN' -H 'Content-Type': 'application/json' -d '{"user_id": "user_123", "class_id": "class_456"}'
javascript (fetch):
javascript fetch('https://api.toolzz.com.br/api/v1/enrollments', { method: 'POST', headers: { 'Authorization': 'Bearer SEU_TOKEN', 'Content-Type': 'application/json' }, body: JSON.stringify({ "user_id": "user_123", "class_id": "class_456" }) }) .then(response => response.json()) .then(data => console.log(data));
python (requests):
python import requests
url = 'https://api.toolzz.com.br/api/v1/enrollments' headers = { 'Authorization': 'Bearer SEU_TOKEN', 'Content-Type': 'application/json' } data = { "user_id": "user_123", "class_id": "class_456" }
response = requests.post(url, headers=headers, json=data) print(response.json())
Parâmetros:
| Parâmetro | Tipo | Obrigatório | Descrição |
|---|---|---|---|
| user_id | string | Sim | ID do usuário a ser matriculado |
| class_id | string | Sim | ID da turma em que matricular |
Response (JSON):
{ "enrollment_id": "enrollment_789", "user_id": "user_123", "class_id": "class_456", "enrollment_date": "2024-10-27T10:00:00Z" }
Webhooks
Embora este tutorial foque na matrícula, o Toolzz LMS oferece webhooks para eventos como 'Novo cadastro' ou 'Curso concluído'. Você pode configurar um webhook para receber notificações em tempo real quando um novo aluno for cadastrado ou quando um aluno concluir um curso, permitindo que você execute ações adicionais em seus sistemas.
Quer automatizar ainda mais?
Solicitar demo Toolzz AITestando
Após implementar a automação, teste o processo criando um novo usuário e matriculando-o em uma turma via API. Verifique na plataforma LXP se o usuário foi criado com sucesso e se a matrícula foi registrada corretamente.
Erros Comuns
- Erro 401 Unauthorized: Token inválido ou ausente.
- Erro 400 Bad Request: Dados inválidos no corpo da requisição. Verifique os tipos de dados e os campos obrigatórios.
- Erro 404 Not Found: ID de usuário ou turma inválido.
Conclusão
A automação da matrícula de alunos via API do Toolzz LMS oferece inúmeras vantagens, como redução de erros, aumento da eficiência e melhoria da experiência do aluno. Ao integrar a API do Toolzz LMS com seus sistemas existentes, você pode otimizar seus processos de gestão educacional e focar no que realmente importa: aprimorar o aprendizado e o desenvolvimento de seus alunos.
Demonstração LXP
Experimente uma demonstração interativa da nossa plataforma LXP e descubra como podemos transformar o aprendizado na sua organização.
Automatize ainda mais com agentes de IA da Toolzz: E se em vez de chamar a API manualmente, um agente de IA fizesse isso por você? Com a Toolzz AI, crie um agente que matricula alunos, consulta notas e gera relatórios — tudo por WhatsApp. Já imaginou o gestor perguntar pelo WhatsApp: 'Matricula o João no curso de vendas' e o agente executar na hora? https://www.toolzz.com.br
.webp){kind=small}
