Guia para leigos: entendendo a automatização de matrículas no LMS em 2026
Automatize matrículas no LMS da sua empresa em 2026. Este guia técnico mostra como usar a API da Toolzz para otimizar a gestão educacional.
Guia para leigos: entendendo a automatização de matrículas no LMS em 2026
17 de abril de 2026
A gestão de matrículas em plataformas de Learning Management System (LMS) pode ser um gargalo para muitas empresas, especialmente aquelas com grande volume de alunos e cursos. A automatização desse processo, através da API do Toolzz LXP, pode economizar tempo, reduzir erros e otimizar a experiência tanto dos administradores quanto dos alunos.
O Problema da Matrícula Manual e a Solução da Automação
Imagine o cenário: uma empresa com centenas de funcionários que precisam ser matriculados em diversos cursos de treinamento. O processo manual de cadastrar cada aluno em cada turma pode levar horas, além de estar sujeito a erros humanos, como digitação incorreta de dados ou matrículas em cursos errados. Isso impacta diretamente a eficiência do departamento de Recursos Humanos e a experiência do aluno, que pode ter dificuldades em acessar o conteúdo correto.
A solução para esse problema é a automatização das matrículas através da API do Toolzz LXP. Com ela, é possível integrar o LMS com outros sistemas da empresa, como o sistema de RH ou CRM, e automatizar o processo de matrícula com base em regras pré-definidas. Por exemplo, ao cadastrar um novo funcionário no sistema de RH, ele automaticamente é matriculado nos cursos de integração e treinamento específicos para sua função.
Simplifique a gestão do seu aprendizado! Conheça a Toolzz e descubra como a tecnologia pode transformar a experiência de treinamento da sua equipe.
Pré-requisitos para Utilizar a API do Toolzz LXP
Antes de começar a automatizar as matrículas, é importante verificar se você possui os seguintes pré-requisitos:
- Conta Toolzz LXP: É necessário ter uma conta ativa na plataforma Toolzz LXP. Caso ainda não possua, você pode criar uma conta de teste gratuita.
- Token do Administrador: Para acessar a API, você precisa de um token de autenticação. Esse token é gerado através do endpoint de autenticação da API, utilizando as credenciais de um usuário administrador.
Para gerar o token, siga os passos:
- Faça uma requisição
POSTpara o endpoint/auth/logincom as credenciais de administrador (usuário e senha). - A resposta da API irá retornar um token JWT (JSON Web Token). Esse token deve ser utilizado no header
Authorizationdas suas requisições.
bash curl -X POST 'https://api.toolzz.com.br/auth/login' -H 'Content-Type: application/json' -d '{"email": "[email protected]", "password": "sua_senha"}'
{ "token": "eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9..." }
Dica: Guarde o token em um local seguro, pois ele é a chave de acesso à API. Evite expor o token em logs ou código fonte.
Arquitetura da Solução: Integração do Sistema Externo com a API Toolzz LMS
A arquitetura da solução envolve a integração do seu sistema externo (RH, CRM, etc.) com a API do Toolzz LXP. O fluxo de dados é o seguinte:
- Evento no Sistema Externo: Um evento ocorre no seu sistema externo, como a criação de um novo funcionário ou a atualização de um cargo.
- Chamada à API Toolzz LMS: Seu sistema externo faz uma chamada à API do Toolzz LXP, utilizando o endpoint apropriado para a ação desejada (ex: criar usuário, matricular aluno).
- Processamento na API Toolzz LMS: A API recebe a requisição, autentica o token, valida os dados e executa a ação no LMS.
- Atualização na Plataforma LXP: A plataforma Toolzz LXP é atualizada com as novas informações (ex: novo usuário cadastrado, aluno matriculado em um curso).
- Feedback para o Sistema Externo: A API retorna uma resposta para o sistema externo, indicando o sucesso ou falha da operação.
Passo a Passo no Produto: Configurando as Turmas no Toolzz LXP
Antes de começar a utilizar a API para automatizar as matrículas, é importante configurar as turmas na interface do Toolzz LXP. Siga os passos abaixo:
- Acesse o Painel Administrativo: Faça login na sua conta Toolzz LXP e acesse o painel administrativo.
- Navegue até a Seção de Turmas: No menu lateral, procure pela seção de "Turmas" ou "Gerenciamento de Turmas".
- Crie uma Nova Turma: Clique no botão "Criar Turma" e preencha os dados da turma, como nome, descrição, data de início, data de fim e curso associado.
- Defina as Configurações da Turma: Configure as opções da turma, como número máximo de alunos, lista de espera e permissões de acesso.
- Salve a Turma: Clique no botão "Salvar" para criar a turma.
Repita esse processo para todas as turmas que você deseja gerenciar através da API.
Implementação via API: Automatizando a Matrícula de Alunos em Turmas
Para automatizar a matrícula de alunos em turmas, utilizaremos os seguintes endpoints da API:
- Criar Turmas:
/lms/institutions/{institution_id}/courses/{course_id}/batches - Matricule alunos em uma turma:
/lms/institutions/{institution_id}/batches/{batch_id}/enroll - Criar usuário em várias escolas:
/lms/institutions/{institution_id}/users
Criar Usuário em Várias Escolas
Este endpoint cria um novo usuário em uma ou mais escolas dentro da sua instituição.
- URL:
POST /lms/institutions/{institution_id}/users - Método:
POST - Headers:
Authorization: Bearer TOKENContent-Type: application/json
Body JSON de Exemplo:
{ "name": "João da Silva", "email": "[email protected]", "cpf": "12345678900", "password": "senha123", "institution_ids": [1, 2] }
Code Block (cURL):
bash curl -X POST 'https://api.toolzz.com.br/lms/institutions/1/users' -H 'Authorization: Bearer SEU_TOKEN' -H 'Content-Type: application/json' -d '{ "name": "João da Silva", "email": "[email protected]", "cpf": "12345678900", "password": "senha123", "institution_ids": [1, 2] }'
Code Block (JavaScript - Fetch API):
javascript const url = 'https://api.toolzz.com.br/lms/institutions/1/users'; const data = { name: 'João da Silva', email: '[email protected]', cpf: '12345678900', password: 'senha123', institution_ids": [1, 2] };
fetch(url, { method: 'POST', headers: { 'Authorization': 'Bearer SEU_TOKEN', 'Content-Type': 'application/json' }, body: JSON.stringify(data) }) .then(response => response.json()) .then(data => console.log(data)) .catch(error => console.error('Error:', error));
Code Block (Python - Requests):
python import requests import json
url = 'https://api.toolzz.com.br/lms/institutions/1/users' headers = { 'Authorization': 'Bearer SEU_TOKEN', 'Content-Type': 'application/json' } data = { 'name': 'João da Silva', 'email': '[email protected]', 'cpf': '12345678900', 'password': 'senha123', 'institution_ids': [1, 2] }
response = requests.post(url, headers=headers, data=json.dumps(data)) print(response.json())
Tabela de Parâmetros:
| Parâmetro | Tipo | Descrição |
|---|---|---|
name |
string | Nome completo do usuário |
email |
string | Endereço de e-mail do usuário |
cpf |
string | CPF do usuário (formato: 12345678900) |
password |
string | Senha do usuário |
institution_ids |
array | Array de IDs das instituições às quais o usuário pertence |
Response JSON de Exemplo:
{ "id": 123, "name": "João da Silva", "email": "[email protected]", "cpf": "12345678900", "institutions": [{"id": 1, "name": "Escola A"}, {"id": 2, "name": "Escola B"}] }
Criar Turmas
Este endpoint cria uma nova turma dentro de um curso específico.
- URL:
POST /lms/institutions/{institution_id}/courses/{course_id}/batches - Método:
POST - Headers:
Authorization: Bearer TOKENContent-Type: application/json
Body JSON de Exemplo:
{ "name": "Turma de Vendas - Janeiro 2026", "start_date": "2026-01-05", "end_date": "2026-01-31", "max_students": 50 }
Code Block (cURL):
bash curl -X POST 'https://api.toolzz.com.br/lms/institutions/1/courses/1/batches' -H 'Authorization: Bearer SEU_TOKEN' -H 'Content-Type: application/json' -d '{ "name": "Turma de Vendas - Janeiro 2026", "start_date": "2026-01-05", "end_date": "2026-01-31", "max_students": 50 }'
Code Block (JavaScript - Fetch API):
javascript const url = 'https://api.toolzz.com.br/lms/institutions/1/courses/1/batches'; const data = { name: 'Turma de Vendas - Janeiro 2026', start_date: '2026-01-05', end_date: '2026-01-31', max_students": 50 };
fetch(url, { method: 'POST', headers: { 'Authorization': 'Bearer SEU_TOKEN', 'Content-Type': 'application/json' }, body: JSON.stringify(data) }) .then(response => response.json()) .then(data => console.log(data)) .catch(error => console.error('Error:', error));
Code Block (Python - Requests):
python import requests import json
url = 'https://api.toolzz.com.br/lms/institutions/1/courses/1/batches' headers = { 'Authorization': 'Bearer SEU_TOKEN', 'Content-Type': 'application/json' } data = { 'name': 'Turma de Vendas - Janeiro 2026', 'start_date': '2026-01-05', 'end_date': '2026-01-31', 'max_students': 50 }
response = requests.post(url, headers=headers, data=json.dumps(data)) print(response.json())
Tabela de Parâmetros:
| Parâmetro | Tipo | Descrição |
|---|---|---|
name |
string | Nome da turma |
start_date |
string | Data de início da turma (formato: YYYY-MM-DD) |
end_date |
string | Data de fim da turma (formato: YYYY-MM-DD) |
max_students |
number | Número máximo de alunos na turma |
Response JSON de Exemplo:
{ "id": 456, "name": "Turma de Vendas - Janeiro 2026", "start_date": "2026-01-05", "end_date": "2026-01-31", "max_students": 50, "course_id": 1 }
Matricule Alunos em Uma Turma
Este endpoint matricula um ou mais alunos em uma turma existente.
- URL:
POST /lms/institutions/{institution_id}/batches/{batch_id}/enroll - Método:
POST - Headers:
Authorization: Bearer TOKENContent-Type: application/json
Body JSON de Exemplo:
{ "user_ids": [123, 456, 789] }
Code Block (cURL):
bash curl -X POST 'https://api.toolzz.com.br/lms/institutions/1/batches/456/enroll' -H 'Authorization: Bearer SEU_TOKEN' -H 'Content-Type: application/json' -d '{ "user_ids": [123, 456, 789] }'
Code Block (JavaScript - Fetch API):
javascript const url = 'https://api.toolzz.com.br/lms/institutions/1/batches/456/enroll'; const data = { user_ids": [123, 456, 789] };
fetch(url, { method: 'POST', headers: { 'Authorization': 'Bearer SEU_TOKEN', 'Content-Type': 'application/json' }, body: JSON.stringify(data) }) .then(response => response.json()) .then(data => console.log(data)) .catch(error => console.error('Error:', error));
Code Block (Python - Requests):
python import requests import json
url = 'https://api.toolzz.com.br/lms/institutions/1/batches/456/enroll' headers = { 'Authorization': 'Bearer SEU_TOKEN', 'Content-Type': 'application/json' } data = { 'user_ids': [123, 456, 789] }
response = requests.post(url, headers=headers, data=json.dumps(data)) print(response.json())
Tabela de Parâmetros:
| Parâmetro | Tipo | Descrição |
|---|---|---|
user_ids |
array | Array de IDs dos usuários a serem matriculados |
Response JSON de Exemplo:
{ "message": "Alunos matriculados com sucesso!" }
Webhooks: Recebendo Notificações de Novas Matrículas
Para ser notificado sempre que um novo aluno é matriculado em uma turma, você pode configurar um webhook na plataforma Toolzz LXP. O webhook irá enviar uma requisição POST para a URL que você configurar, com os dados da matrícula.
- Configure o Webhook na Plataforma: No painel administrativo do Toolzz LXP, procure pela seção de "Webhooks" ou "Integrações".
- Adicione uma Nova Configuração: Clique no botão "Adicionar Webhook" e preencha os dados da configuração, como nome, URL de destino e evento (ex: "Nova Matrícula").
- Salve a Configuração: Clique no botão "Salvar" para ativar o webhook.
Payload de Exemplo:
{ "event": "new_enrollment", "data": { "user_id": 123, "batch_id": 456, "course_id": 1, "enrollment_date": "2026-01-05" } }
Seu sistema deve estar preparado para receber e processar esse payload, extraindo as informações relevantes e executando as ações necessárias.
Testando a Automação de Matrículas
Para garantir que a automatização de matrículas está funcionando corretamente, siga os passos abaixo:
- Crie um Novo Usuário: Utilize o endpoint
/lms/institutions/{institution_id}/userspara criar um novo usuário na plataforma. - Crie uma Nova Turma: Utilize o endpoint
/lms/institutions/{institution_id}/courses/{course_id}/batchespara criar uma nova turma. - Matricule o Usuário na Turma: Utilize o endpoint
/lms/institutions/{institution_id}/batches/{batch_id}/enrollpara matricular o usuário na turma. - Verifique a Matrícula: Acesse a plataforma Toolzz LXP e verifique se o usuário foi matriculado na turma corretamente.
- Verifique o Webhook: Se você configurou um webhook, verifique se ele foi acionado e se os dados da matrícula foram enviados para a URL configurada.
Erros Comuns e Soluções
Ao implementar a automatização de matrículas, você pode encontrar alguns erros comuns. Veja como solucionar:
- Erro 401 (Unauthorized): O token de autenticação está inválido ou expirado. Gere um novo token e tente novamente.
- Erro 400 (Bad Request): Os dados da requisição estão inválidos. Verifique se todos os parâmetros obrigatórios estão presentes e no formato correto.
- Erro 404 (Not Found): O recurso solicitado não foi encontrado. Verifique se a URL do endpoint está correta e se o ID da instituição, curso ou turma existe.
- Erro 500 (Internal Server Error): Ocorreu um erro interno no servidor da API. Tente novamente mais tarde ou entre em contato com o suporte técnico da Toolzz.
Dica: Consulte a documentação da API do Toolzz LXP em docs.toolzz.dev/lms-reference/ para obter mais informações sobre os endpoints, parâmetros e códigos de erro.
Conclusão
A automatização de matrículas no Toolzz LXP através da API é uma solução eficiente para otimizar a gestão educacional da sua empresa. Ao integrar o LMS com outros sistemas, você economiza tempo, reduz erros e melhora a experiência dos alunos e administradores. Implementando os endpoints e webhooks corretamente, você terá um sistema de matrículas automatizado e eficiente.
Concorrentes como Moodle, Coursera e TalentLMS também oferecem APIs para integração, mas a Toolzz se destaca pela sua interface intuitiva, suporte técnico especializado e flexibilidade na customização das soluções.
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?
Leve a automação para o próximo nível!
Solicite uma demonstração da Toolzz AIQuer ver como a Toolzz pode otimizar o seu LMS?
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.
.webp){kind=small}
