Glossário de termos essenciais sobre Automação de Matrícula em EAD

Lucas (CEO Toolzz)
16 de abril de 2026

Automatizar o processo de matrícula de alunos em turmas de cursos online é um desafio comum para instituições de ensino e empresas que investem em educação corporativa. A gestão manual é propensa a erros, demanda tempo da equipe e dificulta a escalabilidade. A API do Toolzz LMS oferece uma solução robusta e flexível para integrar sistemas externos e automatizar esse processo, otimizando a administração e a experiência do aluno.

Pré-requisitos

Para começar a automatizar as matrículas utilizando a API Toolzz LMS, você precisará de uma conta ativa na plataforma e um token de administrador. O token é a chave de acesso que permite que seu sistema externo se autentique e interaja com a API.

Para gerar o token, siga estes passos:

1. Acesse o painel de administração do Toolzz LMS.
2. Navegue até a seção de configurações da API (geralmente em 'Integrações' ou 'API').
3. Clique em 'Gerar novo token'.
4. Defina um nome descritivo para o token (ex: 'API de Matrícula').
5. Copie o token gerado e guarde-o em um local seguro.

Dica: Trate o token como uma senha. Não o compartilhe com terceiros e não o exponha em código público (ex: repositórios Git).

Arquitetura da solução

A arquitetura da solução envolve três componentes principais: o sistema externo (ex: sistema de RH, CRM, portal do aluno), a API Toolzz LMS e a plataforma LXP (Learning Experience Platform) do Toolzz. O fluxo de dados é o seguinte:

1. O sistema externo envia uma solicitação de matrícula para a API Toolzz LMS.
2. A API Toolzz LMS autentica a solicitação utilizando o token de administrador.
3. A API Toolzz LMS processa a solicitação e matricula o aluno na turma desejada.
4. A plataforma LXP é atualizada automaticamente com as informações da nova matrícula.

Passo a passo no produto

Antes de iniciar a implementação via API, é importante configurar as turmas e os cursos na plataforma Toolzz LMS.

1. Crie os cursos: Acesse a seção 'Cursos' e adicione os cursos que serão oferecidos.
2. Crie as turmas: Dentro de cada curso, crie as turmas com as datas de início e término, e o número máximo de alunos.
3. Defina os usuários: Crie os usuários (alunos) que poderão ser matriculados nas turmas. Você pode importar usuários em massa através de um arquivo CSV.

Implementação via API

Para automatizar a matrícula de alunos, utilizaremos o endpoint POST /api/v1/enrollments. Este endpoint permite matricular um aluno em uma turma específica.

URL e Método HTTP

URL: https://api.toolzz.com.br/api/v1/enrollments

Método: POST

Headers

Authorization: Bearer SEU_TOKEN_DE_ADMINISTRADOR Content-Type: application/json

Body JSON

{ "user_id": "64f3a2b1-9c8f-4d5e-9a7b-8a5e2f7a3b4c", "course_id": "64f3a2b1-9c8f-4d5e-9a7b-8a5e2f7a3b4d", "enrollment_date": "2023-10-27T10:00:00Z" }

Exemplo em Bash (curl)

bash curl -X POST https://api.toolzz.com.br/api/v1/enrollments -H 'Authorization: Bearer SEU_TOKEN_DE_ADMINISTRADOR' -H 'Content-Type: application/json' -d '{ "user_id": "64f3a2b1-9c8f-4d5e-9a7b-8a5e2f7a3b4c", "course_id": "64f3a2b1-9c8f-4d5e-9a7b-8a5e2f7a3b4d", "enrollment_date": "2023-10-27T10:00:00Z" }'

Exemplo em JavaScript (fetch)

javascript fetch('https://api.toolzz.com.br/api/v1/enrollments', { method: 'POST', headers: { 'Authorization': 'Bearer SEU_TOKEN_DE_ADMINISTRADOR', 'Content-Type': 'application/json' }, body: JSON.stringify({ user_id: '64f3a2b1-9c8f-4d5e-9a7b-8a5e2f7a3b4c', course_id: '64f3a2b1-9c8f-4d5e-9a7b-8a5e2f7a3b4d', enrollment_date: '2023-10-27T10:00:00Z' }) }).then(response => response.json()).then(data => console.log(data));

Exemplo em Python (requests)

python import requests

url = 'https://api.toolzz.com.br/api/v1/enrollments' headers = { 'Authorization': 'Bearer SEU_TOKEN_DE_ADMINISTRADOR', 'Content-Type': 'application/json' } data = { 'user_id': '64f3a2b1-9c8f-4d5e-9a7b-8a5e2f7a3b4c', 'course_id': '64f3a2b1-9c8f-4d5e-9a7b-8a5e2f7a3b4d', 'enrollment_date': '2023-10-27T10:00:00Z' }

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

Parâmetros

Response JSON

{ "id": "64f3a2b1-9c8f-4d5e-9a7b-8a5e2f7a3b4e", "user_id": "64f3a2b1-9c8f-4d5e-9a7b-8a5e2f7a3b4c", "course_id": "64f3a2b1-9c8f-4d5e-9a7b-8a5e2f7a3b4d", "enrollment_date": "2023-10-27T10:00:00Z", "created_at": "2023-10-27T10:05:00Z" }

Quer simplificar ainda mais a gestão de matrículas e a experiência do aluno? Descubra os planos da Toolzz e encontre a opção ideal para sua instituição.

Webhooks

Para receber notificações sobre novas matrículas, você pode configurar um webhook. O evento enrollment.created é disparado sempre que um novo aluno é matriculado em um curso. A documentação da API Toolzz LMS detalha como configurar webhooks e o formato do payload enviado.

Testando

Após implementar a integração, teste o processo de matrícula enviando uma solicitação de API para matricular um aluno em um curso. Verifique na plataforma Toolzz LMS se a matrícula foi realizada com sucesso e se o aluno tem acesso ao conteúdo do curso.

Erros comuns

• Código 400 - Bad Request: Indica que o corpo da solicitação está inválido ou faltando parâmetros obrigatórios. Verifique se os campos user_id, course_id e enrollment_date estão presentes e com os formatos corretos.
• Código 401 - Unauthorized: Indica que o token de administrador é inválido ou expirou. Verifique se o token está correto e se você tem permissão para executar a operação.
• Código 404 - Not Found: Indica que o usuário ou o curso especificado não foi encontrado. Verifique se os IDs estão corretos.

Outras plataformas de EAD como Moodle e Coursera também oferecem APIs, mas a Toolzz se destaca pela facilidade de uso e flexibilidade, permitindo integrações personalizadas e automatizadas de forma mais simples e eficiente.

Conclusão

A automatização da matrícula de alunos através da API Toolzz LMS oferece inúmeros benefícios, como redução de erros, economia de tempo e aumento da eficiência. Ao integrar seu sistema externo com a plataforma, você pode otimizar a gestão de cursos e proporcionar uma experiência mais fluida e personalizada para seus alunos. Ao implementar essa solução, sua instituição ou empresa estará preparada para escalar suas operações de educação corporativa e alcançar melhores resultados.