Guia Rápido de Matrículas via API para Educação Corporativa em 2026

Lucas (CEO Toolzz)
17 de abril de 2026

Automatizar processos de matrícula em cursos corporativos pode ser um desafio para empresas com grande número de colaboradores. A gestão manual é propensa a erros, demanda tempo e pode atrasar o acesso dos alunos ao conteúdo. A integração entre sistemas de RH e plataformas de gestão de aprendizagem (LMS) é crucial para otimizar este fluxo. Este guia demonstra como automatizar matrículas utilizando a API do Toolzz LMS, agilizando o processo e garantindo a precisão dos dados.

Pré-requisitos

Para acompanhar este tutorial, você precisará de:

• Conta Toolzz LMS: Uma conta ativa na plataforma Toolzz LMS.
• Token do Administrador: Um token de autenticação com permissões de administrador para acessar a API. Você pode gerar um token seguindo estes passos:
  1. Faça login na sua conta Toolzz LMS.
  2. Navegue até as configurações da sua conta.
  3. Na seção "API", crie um novo token com permissões de administrador. Guarde este token em um local seguro, pois ele será utilizado para autenticar suas requisições.

Arquitetura da Solução

O fluxo de integração é o seguinte:

1. Sistema Externo (RH): Um sistema de RH envia informações sobre novos colaboradores ou colaboradores que precisam ser matriculados em cursos específicos.
2. API Toolzz LMS: A API do Toolzz LMS recebe a solicitação do sistema de RH, autenticada pelo token do administrador.
3. Plataforma LXP: A plataforma Toolzz LXP processa a solicitação e matricula o aluno no curso desejado. Webhooks podem ser configurados para notificar o sistema de RH sobre o sucesso ou falha da matrícula.

Simplifique a gestão de aprendizagem da sua equipe. Conheça a Toolzz LXP e ofereça uma experiência de aprendizado personalizada e eficiente.

Passo a Passo no Produto

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

1. Criação de Cursos: Crie os cursos que serão oferecidos aos colaboradores. Defina o conteúdo, as aulas e os materiais de apoio.
2. Criação de Turmas: Crie as turmas para cada curso. Defina a data de início, a data de término e a capacidade máxima de alunos.
3. Configuração de Webhooks (opcional): Configure webhooks para receber notificações sobre novas matrículas, cursos concluídos ou outras ações relevantes.

Implementação via API

Para automatizar a matrícula de alunos, utilizaremos os seguintes endpoints da API Toolzz LMS:

• POST /api/v1/courses/{course_id}/enrollments – Matricula um aluno em uma turma.

Endpoint: Criar Matrícula

URL: POST /api/v1/courses/{course_id}/enrollments

Headers:

Exemplo em curl: bash curl -X POST 'https://api.toolzz.com.br/api/v1/courses/123/enrollments' -H 'Authorization: Bearer seu_token_de_administrador' -H 'Content-Type': 'application/json' -d '{ "user_id": "6543210fedcba9876543210f", "turma_id": "1234567890abcdef12345678" }'

Exemplo em javascript (fetch): javascript fetch('https://api.toolzz.com.br/api/v1/courses/123/enrollments', { method: 'POST', headers: { 'Authorization': 'Bearer seu_token_de_administrador', 'Content-Type': 'application/json' }, body: JSON.stringify({ 'user_id': '6543210fedcba9876543210f', 'turma_id': '1234567890abcdef12345678' }) }).then(response => response.json()).then(data => console.log(data));

Exemplo em python (requests): python import requests

url = 'https://api.toolzz.com.br/api/v1/courses/123/enrollments' headers = { 'Authorization': 'Bearer seu_token_de_administrador', 'Content-Type': 'application/json' } data = { 'user_id': '6543210fedcba9876543210f', 'turma_id': '1234567890abcdef12345678' }

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

Parâmetros: