De Matrículas Manuais para Automação com LMS API

Lucas (CEO Toolzz)
17 de abril de 2026

Gerenciar matrículas em cursos e turmas pode ser uma tarefa demorada e propensa a erros, especialmente em instituições de ensino com grande volume de alunos. Processos manuais demandam tempo da equipe, aumentam a probabilidade de falhas e dificultam a escalabilidade. A automação desse processo, através da integração entre sistemas externos e o Learning Management System (LMS), oferece eficiência, precisão e agilidade.

Pré-requisitos

Para acompanhar este tutorial, você precisará de:

• Uma conta ativa na plataforma Toolzz LXP.
• Um token de administrador para autenticação na API. Você pode gerar um token seguindo os passos:
  1. No Toolzz LXP, navegue até Configurações > API & Integrações.
  2. Clique em Gerar Token.
  3. Copie o token gerado. Mantenha-o em local seguro, pois ele será usado para autenticar suas requisições.

Arquitetura da Solução

O fluxo de integração envolve os seguintes componentes:

1. Sistema Externo: Um sistema de Recursos Humanos (RH), CRM ou outro sistema que contenha os dados dos alunos.
2. API Toolzz LMS: A interface de programação que permite a comunicação entre o sistema externo e a plataforma LXP.
3. Plataforma LXP: O ambiente de aprendizado onde os cursos e turmas são gerenciados.

O sistema externo enviará dados dos alunos para a API do Toolzz LMS, que irá criar os usuários e matriculá-los nas turmas correspondentes.

Passo a passo no produto

Antes de começar a integração via API, é importante configurar a estrutura básica no Toolzz LXP:

1. Crie as Escolas: Se você tiver múltiplas escolas ou unidades, crie-as em Configurações > Escolas.
2. Crie os Cursos: Defina os cursos que serão oferecidos em Cursos > Gerenciar Cursos.
3. Crie as Turmas: Crie as turmas para cada curso, definindo datas de início e término, vagas e instrutores em Cursos > Gerenciar Turmas.

Pronto para simplificar a gestão dos seus cursos? Conheça a Toolzz LXP e descubra como automatizar seus processos de matrícula e muito mais.

Implementação via API

Neste exemplo, demonstraremos como automatizar a matrícula de alunos em uma turma específica através da API. Usaremos o endpoint POST /api/v1/enrollments.

URL e Método HTTP

POST /api/v1/enrollments

Headers

{ "Authorization": "Bearer SEU_TOKEN", "Content-Type": "application/json" }

Body JSON de Exemplo

{ "user_id": "6543210", "enrollment_id": "9876543", "school_id": "1234567" }

Code Block - 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": "6543210", "enrollment_id": "9876543", "school_id": "1234567" }'

Code Block - 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: '6543210', enrollment_id: '9876543', school_id: '1234567' }) }) .then(response => response.json()) .then(data => console.log(data)) .catch(error => console.error(error));

Code Block - 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': '6543210', 'enrollment_id': '9876543', 'school_id': '1234567' }

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

Tabela de Parâmetros

Response JSON de Exemplo

{ "status": "success", "message": "Aluno matriculado com sucesso.", "data": { "enrollment_id": "9876543", "user_id": "6543210" } }

Webhooks

Você pode configurar webhooks para ser notificado quando um novo aluno for matriculado. O webhook Nova matrícula enviará um payload JSON com os detalhes da matrícula para a URL configurada. Para configurar o webhook, vá em Configurações > Webhooks e adicione um novo webhook para o evento Nova matrícula.

O payload do webhook terá a seguinte estrutura:

{ "event": "new_enrollment", "data": { "enrollment_id": "9876543", "user_id": "6543210", "course_id": "1122334", "school_id": "1234567" } }

Testando

Após implementar a integração, teste-a cuidadosamente. Crie um novo usuário no seu sistema externo e verifique se ele é criado corretamente no Toolzz LXP e matriculado na turma desejada. Você pode verificar isso na seção Usuários e Turmas do Toolzz LXP.

Erros Comuns

• Erro 400 - Bad Request: Geralmente indica um erro no corpo da requisição JSON. Verifique se os parâmetros estão corretos e no formato esperado.
• Erro 401 - Unauthorized: Indica que o token de autenticação está incorreto ou expirado. Gere um novo token e tente novamente.
• Erro 404 - Not Found: Indica que o recurso solicitado (usuário ou turma) não foi encontrado. Verifique se os IDs estão corretos.

Conclusão

A automação da matrícula de alunos através da API do Toolzz LMS traz inúmeros benefícios para as instituições de ensino, desde a redução de erros e o aumento da eficiência até a melhoria da experiência do aluno. Ao integrar seus sistemas externos com a plataforma LXP, você pode otimizar seus processos de gestão educacional e focar no que realmente importa: o aprendizado.

Outros LMS como Moodle, Totara ou Coursera oferecem APIs, mas a Toolzz se destaca pela documentação clara, facilidade de uso e suporte dedicado, garantindo uma integração mais rápida e eficiente. Além disso, a flexibilidade da plataforma permite a customização de fluxos de trabalho e a criação de soluções sob medida para as necessidades específicas de cada instituição.

Para uma solução completa de gestão educacional, explore também os recursos de automação de marketing da Toolzz, que podem ser integrados ao seu LMS para atrair e engajar alunos em potencial, e os chatbots para oferecer suporte personalizado e instantâneo aos seus alunos.