Como alinhar matrículas e sistemas com API LMS

Lucas (CEO Toolzz)
16 de abril de 2026

No cenário dinâmico da educação corporativa, a eficiência na gestão de matrículas é crucial para o sucesso dos programas de treinamento. Processos manuais podem ser demorados, propensos a erros e dificultam a integração com outros sistemas da empresa, como o RH. A API do Toolzz LMS oferece uma solução poderosa para automatizar esse processo, permitindo a integração perfeita com sistemas externos e otimizando a experiência tanto para os alunos quanto para os administradores.

Pré-requisitos

Para começar a utilizar a API do Toolzz LMS, você precisará de uma conta ativa na plataforma e de um token de administrador. O token é a chave para autenticar suas requisições e garantir o acesso seguro aos dados do LMS. Para gerar o token, siga os passos abaixo:

1. Acesse o painel de administração do Toolzz LMS.
2. Navegue até a seção "Configurações" e, em seguida, "API".
3. Clique em "Gerar Token".
4. Copie o token gerado e guarde-o em um local seguro. Este token será utilizado em todas as suas requisições à API.

Dica: Trate o token como uma senha. Não o compartilhe com terceiros e evite expô-lo em código público.

Arquitetura da solução

A solução de automação de matrículas via API Toolzz LMS envolve a comunicação entre um sistema externo (por exemplo, um sistema de RH ou um portal do aluno) e a plataforma LXP (Learning Experience Platform) da Toolzz. O fluxo é o seguinte:

1. O sistema externo envia uma solicitação para a API do Toolzz LMS, contendo os dados do aluno e do curso.
2. A API valida a solicitação e, se for válida, cria o aluno (se necessário) e o matricula no curso.
3. A plataforma LXP é atualizada com as informações da nova matrícula, permitindo que o aluno acesse o curso e comece o aprendizado.

Este fluxo permite uma integração contínua e automatizada, eliminando a necessidade de intervenção manual e reduzindo o tempo de resposta. Se você busca uma plataforma completa para gerenciar todo esse processo de forma integrada, conheça a Toolzz.

Passo a passo no produto

Antes de iniciar a integração via API, é importante configurar as escolas e cursos no Toolzz LMS. Na interface do Toolzz LMS:

1. Crie as escolas: Acesse a seção "Escolas" e adicione as escolas que farão parte do processo de matrícula.
2. Crie os cursos: Acesse a seção "Cursos" e crie os cursos que serão oferecidos aos alunos.
3. Defina as turmas: Para cada curso, crie as turmas com as datas de início e término, e o número máximo de alunos.

Com as escolas, cursos e turmas configurados, você estará pronto para iniciar a integração via API.

Implementação via API

Para automatizar a matrícula de alunos, utilizaremos o endpoint POST /enrollments. Este endpoint permite criar uma nova matrícula para um aluno em um curso específico.

URL e Método HTTP

POST /enrollments

Headers

• Authorization: Bearer {seu_token}
• Content-Type: application/json

Body JSON de exemplo

{ "student_name": "João da Silva", "student_cpf": "123.456.789-00", "course_id": "curso-vendas-101", "class_id": "turma-vendas-01", "school_id": "escola-exemplo" }

Code block (curl)

bash curl -X POST https://api.toolzz.com.br/enrollments -H 'Authorization: Bearer {seu_token}' -H 'Content-Type: application/json' -d '{ "student_name": "João da Silva", "student_cpf": "123.456.789-00", "course_id": "curso-vendas-101", "class_id": "turma-vendas-01", "school_id": "escola-exemplo" }'

Code block (JavaScript - fetch)

javascript fetch('https://api.toolzz.com.br/enrollments', { method: 'POST', headers: { 'Authorization': 'Bearer {seu_token}', 'Content-Type': 'application/json' }, body: JSON.stringify({ student_name: 'João da Silva', student_cpf: '123.456.789-00', course_id: 'curso-vendas-101', class_id: 'turma-vendas-01', school_id: 'escola-exemplo' }) }).then(response => response.json()).then(data => console.log(data));

Code block (Python - requests)

python import requests

url = 'https://api.toolzz.com.br/enrollments' headers = { 'Authorization': 'Bearer {seu_token}', 'Content-Type': 'application/json' } data = { 'student_name': 'João da Silva', 'student_cpf': '123.456.789-00', 'course_id': 'curso-vendas-101', 'class_id': 'turma-vendas-01', 'school_id': 'escola-exemplo' }

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

Parâmetros

Response JSON de exemplo

{ "status": "success", "message": "Aluno matriculado com sucesso!", "enrollment_id": "matricula-123" }

Webhooks

Você pode configurar webhooks para receber notificações sobre eventos importantes, como a criação de uma nova matrícula. O webhook enrollment.created será enviado sempre que um aluno for matriculado em um curso. Para configurar o webhook, acesse a seção "Webhooks" no painel de administração do Toolzz LMS e adicione a URL para onde as notificações devem ser enviadas.

Testando

Após implementar a integração via API, é fundamental testar o processo de matrícula. Envie uma solicitação à API com os dados de um aluno e verifique se a matrícula foi criada com sucesso na plataforma LXP. Você pode verificar isso acessando a seção "Matrículas" no painel de administração do Toolzz LMS.

Erros comuns

• Erro 400: Bad Request: Indica que os dados enviados na solicitação estão incorretos ou incompletos. Verifique se todos os parâmetros obrigatórios estão presentes e se os valores estão no formato correto.
• Erro 401: Unauthorized: Indica que o token de autenticação é inválido ou expirou. Verifique se o token está correto e se ainda é válido.
• Erro 404: Not Found: Indica que o curso ou a turma especificada não existe. Verifique se os IDs do curso e da turma estão corretos.
• Erro 500: Internal Server Error: Indica um erro interno no servidor da Toolzz LMS. Entre em contato com o suporte técnico da Toolzz para obter ajuda.

Conclusão

A API do Toolzz LMS oferece uma solução flexível e poderosa para automatizar o processo de matrícula de alunos, integrando-o com seus sistemas existentes e otimizando a gestão da educação corporativa. Ao automatizar este processo, você economiza tempo, reduz erros e melhora a experiência de aprendizado dos seus alunos. Com a Toolzz, você tem o controle total sobre a gestão da sua plataforma de educação corporativa, permitindo focar no que realmente importa: o desenvolvimento dos seus colaboradores. Para explorar todas as funcionalidades e planos que a Toolzz oferece, confira nossos preços.