Toolzz: personalização total para automatização de matrículas
Automatize matrículas em cursos com a API Toolzz LMS e integre com sistemas de RH via webhooks.
Toolzz: personalização total para automatização de matrículas
17 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 de programas de treinamento e desenvolvimento. Processos manuais de matrícula são suscetíveis a erros, demandam tempo e recursos significativos e podem gerar frustração tanto para alunos quanto para administradores. A automatização desse processo, através da integração entre sistemas externos e plataformas LMS como a Toolzz, otimiza fluxos de trabalho, reduz custos e melhora a experiência do usuário. Este tutorial detalhado aborda a automatização de matrículas utilizando a API do Toolzz LMS, com exemplos práticos e código em diversas linguagens.
Pré-requisitos
Para acompanhar este tutorial, você precisará de:
- Conta Toolzz LMS: Crie uma conta na plataforma Toolzz LMS. Você pode iniciar um teste gratuito em https://toolzz.com.br/lxp#demo.
- Token do Administrador: Para acessar a API, você precisará de um token de administrador. Para gerar o token, siga os passos:
- Acesse a plataforma Toolzz LMS com sua conta de administrador.
- Vá em 'Configurações' > 'API Keys'.
- Clique em 'Gerar Nova Chave'.
- Copie o token gerado. Mantenha-o em segurança!
Arquitetura da solução
O fluxo de integração para automatizar matrículas com a API Toolzz LMS é o seguinte:
- Sistema Externo (ex: RH, CRM): Um sistema externo, como um sistema de RH ou CRM, identifica a necessidade de matricular um aluno em um curso.
- API Toolzz LMS: O sistema externo envia uma requisição para a API Toolzz LMS, especificando o aluno, o curso e a turma desejada.
- Plataforma LXP: A API Toolzz LMS processa a requisição e matricula o aluno na turma correspondente dentro da plataforma LXP. Um webhook pode ser disparado para atualizar o sistema externo sobre o status da matrícula.
Simplifique a gestão de seus treinamentos. Com a Toolzz, você centraliza a automação de matrículas e otimiza a jornada de aprendizado dos seus colaboradores. Conheça a Toolzz LXP e descubra como podemos transformar seus resultados.
Passo a passo no produto
Antes de iniciar a integração via API, é importante configurar os cursos e turmas na interface do Toolzz LMS.
- Crie o Curso: Vá em 'Cursos' > 'Novo Curso' e defina as informações do curso, como título, descrição e conteúdo.
- Crie a Turma: Dentro do curso, vá em 'Turmas' > 'Nova Turma' e defina as configurações da turma, como data de início, data de término e capacidade máxima.
- Gerencie Usuários: Crie ou importe os usuários que serão matriculados nos cursos. Vá em 'Usuários' > 'Novo Usuário' ou utilize a importação em massa via CSV.
Implementação via API
Utilizaremos o endpoint Matricule alunos em uma turma para realizar a matrícula programática.
Endpoint: Matricule alunos em uma turma
URL:
https://api.toolzz.dev/lms/v1/turmas/{turma_id}/matriculasMétodo:
POSTHeaders:
Authorization: Bearer TOKENContent-Type: application/json
Parâmetros (Body JSON):
| Parâmetro | Tipo | Descrição | Obrigatório | Exemplo |
|---|---|---|---|---|
| aluno_ids | array | Array com os IDs dos alunos a serem matriculados | Sim | [123, 456, 789] |
Exemplo de Body JSON:
{ "aluno_ids": [123, 456] }
Exemplo em Bash (curl):
bash curl -X POST https://api.toolzz.dev/lms/v1/turmas/789/matriculas -H 'Authorization: Bearer SEU_TOKEN' -H 'Content-Type: application/json' -d '{"aluno_ids": [123, 456]}'
Exemplo em JavaScript (fetch):
javascript fetch('https://api.toolzz.dev/lms/v1/turmas/789/matriculas', { method: 'POST', headers: { 'Authorization': 'Bearer SEU_TOKEN', 'Content-Type': 'application/json' }, body: JSON.stringify({ aluno_ids: [123, 456] }) }) .then(response => response.json()) .then(data => console.log(data))
Exemplo em Python (requests):
python import requests
url = 'https://api.toolzz.dev/lms/v1/turmas/789/matriculas' headers = { 'Authorization': 'Bearer SEU_TOKEN', 'Content-Type': 'application/json' } data = { 'aluno_ids': [123, 456] } response = requests.post(url, headers=headers, json=data) print(response.json())
Response JSON de exemplo:
{ "matriculas": [ { "aluno_id": 123, "turma_id": 789, "status": "matriculado" }, { "aluno_id": 456, "turma_id": 789, "status": "matriculado" } ] }
Webhooks
Para acompanhar o status da matrícula, você pode configurar um webhook para o evento Nova matrícula. Ao configurar o webhook, defina um URL para onde a Toolzz enviará as notificações. O payload do webhook incluirá informações sobre o aluno matriculado, o curso e a turma.
Payload de exemplo:
{ "evento": "nova_matricula", "data": { "aluno_id": 123, "turma_id": 789, "curso_id": 101, "data_matricula": "2024-10-27T10:00:00Z" } }
Testando
Após implementar a integração, teste a matrícula de um aluno através da API. Verifique na plataforma Toolzz LMS se o aluno foi matriculado corretamente na turma desejada. Confirme também se o webhook está sendo disparado e processado corretamente pelo seu sistema externo.
Erros comuns
- Código 401 (Não Autorizado): Token inválido ou ausente. Verifique se o token está correto e se você o incluiu no header
Authorization. - Código 400 (Requisição Inválida): Dados inválidos no body JSON. Verifique se o formato do JSON está correto e se todos os parâmetros obrigatórios estão presentes.
- Código 404 (Não Encontrado): Turma ou aluno não encontrado. Verifique se os IDs da turma e do aluno estão corretos.
- Código 500 (Erro Interno do Servidor): Erro inesperado no servidor. Entre em contato com o suporte da Toolzz para obter ajuda.
Quer ver a Toolzz em ação?
Solicitar demonstraçãoConclusão
A automatização de matrículas com a API Toolzz LMS simplifica o processo de gestão de alunos, reduz erros e libera recursos para atividades mais estratégicas. Ao integrar a Toolzz LMS com seus sistemas externos, você garante um fluxo de trabalho eficiente e uma experiência aprimorada para seus alunos. A flexibilidade da API permite personalizar a integração de acordo com suas necessidades específicas, adaptando a plataforma às suas demandas de negócio. Se você busca uma solução completa para aprimorar a gestão de seus treinamentos, conheça todos os planos e preços da Toolzz.
Demonstração LXP
Experimente uma demonstração interativa da nossa plataforma LXP e descubra como podemos transformar o aprendizado na sua organização.
.webp){kind=small}
