A evolução da matrícula de alunos ao longo dos anos

Lucas (CEO Toolzz)
17 de abril de 2026

Tradicionalmente, a matrícula de alunos é um processo manual e demorado, repleto de planilhas, formulários em papel e muita burocracia. Essa abordagem, além de gerar erros e atrasos, exige um esforço considerável das equipes administrativas, desviando o foco de atividades mais estratégicas. Com o avanço da tecnologia, a automação se tornou uma necessidade para instituições de ensino que buscam eficiência, escalabilidade e uma melhor experiência para alunos e gestores. Este artigo apresenta um guia completo para automatizar a matrícula de alunos utilizando a API do Toolzz LMS, demonstrando como essa solução pode transformar a gestão educacional.

Pré-requisitos

Para acompanhar este tutorial, você precisará de:

• Conta Toolzz LMS: Certifique-se de ter uma conta ativa na plataforma Toolzz LMS.
• Token do Administrador: O token é a chave de acesso à API. Para gerá-lo, siga os passos:
  1. Acesse o painel de administração do Toolzz LMS.
  2. Navegue até a seção de configurações da API (geralmente em “Configurações” -> “API”).
  3. Gere um novo token com permissões de administrador. Guarde-o em um local seguro.

Dica: O token é como uma senha. Mantenha-o em segredo e não o compartilhe com terceiros.

Arquitetura da solução

A solução proposta envolve a integração entre um sistema externo (por exemplo, um sistema de RH, um formulário online, ou um CRM) e o Toolzz LMS através da API. O fluxo é o seguinte:

1. Sistema Externo: O sistema externo recebe as informações do aluno (nome, CPF, curso desejado, etc.).
2. API Toolzz LMS: O sistema externo envia uma requisição para a API do Toolzz LMS, contendo os dados do aluno e o curso para o qual ele deseja se matricular.
3. Plataforma LXP: O Toolzz LMS processa a requisição, cria o usuário (se necessário) e o matricula no curso, atualizando o status na plataforma LXP.

Implementar essa integração pode parecer complexo, mas os resultados em termos de otimização de tempo e recursos são significativos. Se você busca uma solução completa para a gestão do aprendizado, conheça a Toolzz LXP e descubra como ela pode impulsionar a educação em sua instituição.

Passo a passo no produto

Antes de começar a implementar a automação via API, é crucial configurar o Toolzz LMS:

1. Cursos e Turmas: Crie os cursos e turmas que estarão disponíveis para os alunos.
2. Campos Personalizados: Defina campos personalizados para coletar informações adicionais dos alunos, se necessário.
3. Níveis de Acesso: Configure os níveis de acesso dos alunos aos cursos e turmas.
4. Webhooks (opcional): Configure webhooks para receber notificações sobre eventos como novas matrículas ou cursos concluídos.

Implementação via API

Para este exemplo, usaremos os seguintes endpoints da API do 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:

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", "cpf": "123.456.789-00", "email": "[email protected]", "password": "senha123", "school_id": "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", "cpf": "123.456.789-00", "email": "[email protected]", "password": "senha123", "school_id": "123" }) }) .then(response => response.json()) .then(data => console.log(data)) .catch(error => console.error('Error:', error));

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", "cpf": "123.456.789-00", "email": "[email protected]", "password": "senha123", "school_id": "123" }

response = requests.post(url, headers=headers, json=data) print(response.json())

Parâmetros:

URL: POST /api/v1/enrollments

Headers:

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": "123", "course_id": "456", "turma_id": "789"}'

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": "123", "course_id": "456", "turma_id": "789" }) }) .then(response => response.json()) .then(data => console.log(data)) .catch(error => console.error('Error:', error));

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": "123", "course_id": "456", "turma_id": "789" }

response = requests.post(url, headers=headers, json=data) print(response.json())

Parâmetros: