Ferramentas e recursos para dominar a Automação de Matrículas em LMS
Automatize matrículas em seu LMS com a API Toolzz e integre com sistemas de RH.

Ferramentas e recursos para dominar a Automação de Matrículas em LMS
17 de abril de 2026
Gerenciar matrículas em um sistema de aprendizado (LMS) pode ser uma tarefa manual, demorada e propensa a erros, especialmente em empresas com muitos alunos e cursos. A automação desse processo não apenas economiza tempo, mas também reduz a carga administrativa e garante maior precisão. Neste tutorial técnico, exploraremos como automatizar matrículas no Toolzz LMS utilizando sua API, integrando-o com sistemas externos de RH e otimizando o processo de inscrição de alunos.
Pré-requisitos
Para seguir este tutorial, você precisará de:
- Uma conta ativa no Toolzz LMS.
- Um token de administrador para autenticação na API. Você pode gerar um token seguindo estes passos:
- No Toolzz LMS, vá para
Configurações>API. - Gere um novo token, atribuindo a ele um nome descritivo (ex: "API de Matrícula").
- Copie o token gerado – ele será usado para autenticar suas requisições.
- No Toolzz LMS, vá para
Dica: Guarde o token em um local seguro e não o compartilhe publicamente.
Arquitetura da solução
O fluxo de integração será o seguinte: um sistema externo de RH (ou outro sistema de gestão de alunos) envia informações de novos alunos ou solicitações de matrícula para a API do Toolzz LMS. A API processa a solicitação, cria ou atualiza o aluno no LMS e o matricula no curso desejado. A plataforma LXP (Toolzz LMS) é atualizada automaticamente, refletindo as novas matrículas.
Fluxo: Sistema externo → API Toolzz LMS → Plataforma LXP
Passo a passo no produto
Antes de iniciar a integração via API, é importante configurar as escolas e cursos no Toolzz LMS. Siga estes passos:
- Criar Escolas: Vá para
Instituições>Escolase crie as escolas que você deseja gerenciar. - Criar Cursos: Vá para
Cursos>Cursose crie os cursos que serão oferecidos aos alunos. Defina os detalhes do curso, como nome, descrição, categorias, etc. - Configurar Turmas: Dentro de cada curso, crie turmas para organizar os alunos. Vá para
Cursos>Turmase configure as turmas com datas de início e término, capacidade máxima, etc.
Quer otimizar a gestão de seus cursos?
Conheça a ToolzzImplementação via API
Para este caso de uso, utilizaremos os seguintes endpoints da API Toolzz LMS:
POST /api/v1/users- Criar um novo usuário.POST /api/v1/enrollments- Matricular um usuário em uma turma.
Criar um novo usuário
URL: https://api.toolzz.dev/api/v1/users
Método: POST
Headers:
{ "Authorization": "Bearer SEU_TOKEN_DE_ADMINISTRADOR", "Content-Type": "application/json" }
Body JSON de exemplo:
{ "name": "João da Silva", "email": "[email protected]", "cpf": "123.456.789-00", "school_id": "64f8e7a2b3c4d5e6f7a8b9c0", "role": "student" }
curl:
bash curl -X POST 'https://api.toolzz.dev/api/v1/users' -H 'Authorization: Bearer SEU_TOKEN_DE_ADMINISTRADOR' -H 'Content-Type': 'application/json' -d '{"name": "João da Silva", "email": "[email protected]", "cpf": "123.456.789-00", "school_id": "64f8e7a2b3c4d5e6f7a8b9c0", "role": "student"}'
JavaScript (fetch):
javascript fetch('https://api.toolzz.dev/api/v1/users', { method: 'POST', headers: { 'Authorization': 'Bearer SEU_TOKEN_DE_ADMINISTRADOR', 'Content-Type': 'application/json' }, body: JSON.stringify({ "name": "João da Silva", "email": "[email protected]", "cpf": "123.456.789-00", "school_id": "64f8e7a2b3c4d5e6f7a8b9c0", "role": "student" }) }) .then(response => response.json()) .then(data => console.log(data)) .catch(error => console.error(error));
Python (requests):
python import requests
url = 'https://api.toolzz.dev/api/v1/users' headers = { 'Authorization': 'Bearer SEU_TOKEN_DE_ADMINISTRADOR', 'Content-Type': 'application/json' } data = { "name": "João da Silva", "email": "[email protected]", "cpf": "123.456.789-00", "school_id": "64f8e7a2b3c4d5e6f7a8b9c0", "role": "student" }
response = requests.post(url, headers=headers, json=data)
print(response.json())
Parâmetros:
| Parâmetro | Tipo | Obrigatório | Descrição | Exemplo |
|---|---|---|---|---|
| name | string | sim | Nome completo do aluno | João da Silva |
| string | sim | Endereço de e-mail do aluno | [email protected] | |
| cpf | string | sim | CPF do aluno | 123.456.789-00 |
| school_id | string | sim | ID da escola a qual o aluno pertence | 64f8e7a2b3c4d5e6f7a8b9c0 |
| role | string | sim | Role do usuário (student, teacher, admin) | student |
Response JSON de exemplo:
{ "id": "65f8e7a2b3c4d5e6f7a8b9c1", "name": "João da Silva", "email": "[email protected]", "cpf": "123.456.789-00", "school_id": "64f8e7a2b3c4d5e6f7a8b9c0", "role": "student", "created_at": "2024-01-26T14:30:00Z" }
Matricular um usuário em uma turma
URL: https://api.toolzz.dev/api/v1/enrollments
Método: POST
Headers:
{ "Authorization": "Bearer SEU_TOKEN_DE_ADMINISTRADOR", "Content-Type": "application/json" }
Body JSON de exemplo:
{ "user_id": "65f8e7a2b3c4d5e6f7a8b9c1", "class_id": "65f9a8b2c3d4e5f6g7h8i9j0" }
curl:
bash curl -X POST 'https://api.toolzz.dev/api/v1/enrollments' -H 'Authorization: Bearer SEU_TOKEN_DE_ADMINISTRADOR' -H 'Content-Type': 'application/json' -d '{"user_id": "65f8e7a2b3c4d5e6f7a8b9c1", "class_id": "65f9a8b2c3d4e5f6g7h8i9j0"}'
JavaScript (fetch):
javascript fetch('https://api.toolzz.dev/api/v1/enrollments', { method: 'POST', headers: { 'Authorization': 'Bearer SEU_TOKEN_DE_ADMINISTRADOR', 'Content-Type': 'application/json' }, body: JSON.stringify({ "user_id": "65f8e7a2b3c4d5e6f7a8b9c1", "class_id": "65f9a8b2c3d4e5f6g7h8i9j0" }) }) .then(response => response.json()) .then(data => console.log(data)) .catch(error => console.error(error));
Python (requests):
python import requests
url = 'https://api.toolzz.dev/api/v1/enrollments' headers = { 'Authorization': 'Bearer SEU_TOKEN_DE_ADMINISTRADOR', 'Content-Type': 'application/json' } data = { "user_id": "65f8e7a2b3c4d5e6f7a8b9c1", "class_id": "65f9a8b2c3d4e5f6g7h8i9j0" }
response = requests.post(url, headers=headers, json=data)
print(response.json())
Parâmetros:
| Parâmetro | Tipo | Obrigatório | Descrição | Exemplo |
|---|---|---|---|---|
| user_id | string | sim | ID do usuário a ser matriculado | 65f8e7a2b3c4d5e6f7a8b9c1 |
| class_id | string | sim | ID da turma a ser matriculado | 65f9a8b2c3d4e5f6g7h8i9j0 |
Response JSON de exemplo:
{ "id": "65f9b9c3d4e5f6g7h8i9j0k1", "user_id": "65f8e7a2b3c4d5e6f7a8b9c1", "class_id": "65f9a8b2c3d4e5f6g7h8i9j0", "created_at": "2024-01-26T14:35:00Z" }
Testando
Após implementar a integração, valide se os alunos estão sendo matriculados corretamente no Toolzz LMS. Verifique:
- Se o novo usuário foi criado na plataforma.
- Se o aluno foi matriculado na turma correta.
- Se o aluno tem acesso aos materiais do curso.
Se você busca uma solução completa para aprimorar ainda mais a gestão de seus cursos e a experiência dos seus alunos, explore os planos da Toolzz e descubra como podemos te ajudar.
Erros comuns
- Erro 401 Unauthorized: Token de administrador inválido ou ausente.
- Erro 400 Bad Request: Dados inválidos no corpo da requisição. Verifique se todos os campos obrigatórios estão presentes e com o formato correto.
- Erro 404 Not Found: ID da escola ou turma inválido.
- Erro 500 Internal Server Error: Erro inesperado no servidor. Entre em contato com o suporte da Toolzz.
Conclusão
Automatizar o processo de matrícula no Toolzz LMS através da API oferece inúmeras vantagens, incluindo economia de tempo, redução de erros e maior eficiência na gestão de alunos. Ao integrar o LMS com seus sistemas existentes, você pode otimizar o fluxo de trabalho e proporcionar uma experiência de aprendizado mais fluida para seus alunos. A Toolzz oferece uma API robusta e flexível para atender às suas necessidades de automação, complementada pela facilidade de uso de sua plataforma LXP. Embora existam outras soluções de LMS no mercado, como Moodle e Totara Learn, a Toolzz se destaca pela sua abordagem moderna, API bem documentada e foco na experiência do usuário, tornando-a uma excelente escolha para empresas que buscam uma plataforma de aprendizado escalável e eficiente.
Pronto para simplificar a gestão de matrículas?
Solicitar demonstraçãoDemonstração LXP
Experimente uma demonstração interativa da nossa plataforma LXP e descubra como podemos transformar o aprendizado na sua organização.


















