Como otimizar matrículas usando API LMS em 2026

Lucas (CEO Toolzz)
16 de abril de 2026

Gerenciar matrículas de alunos em plataformas de educação corporativa pode ser uma tarefa manual e demorada, especialmente em empresas com grande volume de colaboradores e cursos. A automatização desse processo, através da API do LMS, não apenas economiza tempo e recursos, mas também reduz erros e garante uma experiência mais fluida para alunos e administradores. Este guia detalhado demonstra como automatizar a matrícula de alunos utilizando a API do Toolzz LMS, explorando cada etapa do processo, desde a configuração inicial até a implementação e testes.

Pré-requisitos

Para acompanhar este tutorial, você precisará de:

• Conta Toolzz LMS: Caso ainda não tenha, crie uma conta em https://toolzz.com.br.
• Token do Administrador: O token é a chave de acesso para utilizar a API. Para gerar, siga os passos:
  1. No Toolzz LMS, acesse as configurações da sua instituição.
  2. Selecione a aba "API".
  3. Clique em "Gerar Token".
  4. Copie o token gerado. Mantenha-o em local seguro.

Dica: O token do administrador concede acesso total à sua conta. Utilize-o com cautela e evite compartilhá-lo.

Arquitetura da solução

O fluxo de integração para automatizar matrículas é o seguinte:

1. Sistema Externo: Seu sistema de RH, CRM ou outra plataforma que contém os dados dos alunos.
2. API Toolzz LMS: A API recebe as informações do aluno e do curso e realiza a matrícula.
3. Plataforma LXP: A plataforma Toolzz LXP registra a matrícula e disponibiliza o acesso ao curso para o aluno.

Quer simplificar a gestão da sua plataforma de aprendizado? Conheça a Toolzz LXP e ofereça uma experiência de aprendizado personalizada e envolvente para seus colaboradores.

Passo a passo no produto

Antes de iniciar a integração via API, é importante configurar as escolas/unidades e os cursos na plataforma Toolzz LMS:

1. Criar Unidades/Escolas: Acesse o menu "Instituições" e adicione as unidades/escolas que farão parte do processo de matrícula.
2. Criar Cursos: Crie os cursos que estarão disponíveis para os alunos no menu "Cursos".
3. Definir Turmas: Para cada curso, crie as turmas com vagas disponíveis. A API utilizará o ID da turma para realizar a matrícula.

Implementação via API

Vamos detalhar a implementação da matrícula via API. Usaremos o endpoint POST /api/v1/enrollments para matricular alunos em turmas.

Endpoint: Criar Matrícula

• URL: https://api.toolzz.dev/api/v1/enrollments
• Método: POST
• Headers:
  • Authorization: Bearer SEU_TOKEN
  • Content-Type: application/json
• Body (JSON):

{ "user_id": "654321abcdef0123456789", "course_id": "987654321abcdef0123456789", "school_id": "1234567890abcdef0123456789", "enrollment_date": "2024-10-27T10:00:00Z" }

• Parâmetros:

• Exemplo em Curl:

bash curl -X POST https://api.toolzz.dev/api/v1/enrollments -H 'Authorization: Bearer SEU_TOKEN' -H 'Content-Type: application/json' -d '{ "user_id": "654321abcdef0123456789", "course_id": "987654321abcdef0123456789", "school_id": "1234567890abcdef0123456789", "enrollment_date": "2024-10-27T10:00:00Z" }'

• Exemplo em JavaScript (Fetch):

javascript fetch('https://api.toolzz.dev/api/v1/enrollments', { method: 'POST', headers: { 'Authorization': 'Bearer SEU_TOKEN', 'Content-Type': 'application/json' }, body: JSON.stringify({ user_id: '654321abcdef0123456789', course_id: '987654321abcdef0123456789', school_id: '1234567890abcdef0123456789', enrollment_date: '2024-10-27T10:00:00Z' }) }) .then(response => response.json()) .then(data => console.log(data)) .catch(error => console.error('Erro:', error));

• Exemplo em Python (Requests):

python import requests

url = 'https://api.toolzz.dev/api/v1/enrollments' headers = { 'Authorization': 'Bearer SEU_TOKEN', 'Content-Type': 'application/json' } data = { 'user_id': '654321abcdef0123456789', 'course_id': '987654321abcdef0123456789', 'school_id': '1234567890abcdef0123456789', 'enrollment_date': '2024-10-27T10:00:00Z' } response = requests.post(url, headers=headers, json=data) print(response.json())

• Response (JSON):

{ "id": "abcdef1234567890", "user_id": "654321abcdef0123456789", "course_id": "987654321abcdef0123456789", "school_id": "1234567890abcdef0123456789", "enrollment_date": "2024-10-27T10:00:00Z", "status": "active" }

Webhooks

Para ser notificado quando uma matrícula é criada, você pode configurar um webhook para o evento "Nova matrícula".

1. Configurar Webhook: No Toolzz LMS, acesse as configurações da sua instituição e a aba "Webhooks".
2. Criar Webhook: Adicione um novo webhook, especificando a URL para onde as notificações serão enviadas e selecione o evento "Nova matrícula".
3. Payload de Exemplo:

{ "event": "enrollment.created", "data": { "id": "abcdef1234567890", "user_id": "654321abcdef0123456789", "course_id": "987654321abcdef0123456789", "school_id": "1234567890abcdef0123456789", "enrollment_date": "2024-10-27T10:00:00Z", "status": "active" } }

Testando

Após a implementação, teste a integração matriculando um aluno através da API. Verifique se:

• O aluno aparece como matriculado no curso na plataforma Toolzz LXP.
• O webhook é disparado e você recebe a notificação de nova matrícula.

Erros comuns

• 401 Unauthorized: Token inválido ou ausente.
• 400 Bad Request: Dados inválidos no corpo da requisição. Verifique os tipos de dados e os campos obrigatórios.
• 404 Not Found: ID do usuário, curso ou escola não encontrado.
• 500 Internal Server Error: Erro interno no servidor. Consulte a documentação da API ou entre em contato com o suporte da Toolzz.

Conclusão

A automatização da matrícula de alunos com a API do Toolzz LMS simplifica o processo de gestão educacional, economiza tempo e reduz erros. Ao integrar o LMS com seus sistemas existentes, você garante uma experiência mais eficiente e agradável para todos os envolvidos. A flexibilidade da API permite criar soluções personalizadas para atender às necessidades específicas da sua empresa e escalar suas iniciativas de aprendizado corporativo.

Outras plataformas de LMS, como Moodle e Totara Learn, também oferecem APIs para automatização, mas a Toolzz se destaca pela facilidade de uso, documentação completa e suporte dedicado, tornando a integração mais rápida e eficiente. Plataformas como Coursera for Business oferecem soluções prontas, mas a Toolzz oferece maior flexibilidade e personalização para atender às necessidades específicas de cada cliente.

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? https://www.toolzz.com.br/ai