Os principais conceitos de automatização de matrícula explicados em 2026

Lucas (CEO Toolzz)
16 de abril de 2026

A automatização de matrículas é fundamental para otimizar a gestão educacional em empresas e instituições de ensino. Com a API do Toolzz LXP, é possível integrar sistemas externos e automatizar processos, economizando tempo e recursos. Este artigo explora os principais conceitos e como implementá-los.

Pré-requisitos

Antes de começar a automatizar matrículas, certifique-se de ter os seguintes pré-requisitos:

• Conta Toolzz LMS: É necessário ter uma conta ativa no Toolzz LXP para acessar a API.

• Token do Administrador: Gere um token de administrador através do endpoint de autenticação. Este token será usado para autorizar as requisições à API.

  Dica: Guarde o token em um local seguro, pois ele concede acesso administrativo ao seu LMS.

Para gerar o token, siga estes passos:

1. Acesse o painel de administração do Toolzz LXP.
2. Navegue até a seção de API.
3. Gere um novo token de administrador.

Arquitetura da solução

A arquitetura da solução envolve a integração de um sistema externo (como um sistema de RH, CRM ou ERP) com a API do Toolzz LXP. O fluxo geral é o seguinte:

1. Sistema Externo: O sistema externo detecta a necessidade de matricular um novo aluno.
2. API Toolzz LMS: O sistema externo envia uma requisição à API do Toolzz LMS para criar o usuário (se necessário) e matriculá-lo na turma desejada.
3. Plataforma LXP: A plataforma LXP registra a matrícula e disponibiliza o curso para o aluno.

Passo a passo no produto

Para configurar a automatização de matrículas na interface do Toolzz LXP, siga estes passos:

1. Criar Turmas: Acesse a seção de turmas e crie as turmas necessárias. Defina o nome, descrição e outras informações relevantes.
2. Configurar API: Na seção de API, configure as permissões e gere o token de administrador.
3. Webhooks (opcional): Configure webhooks para receber notificações sobre novas matrículas, cadastros ou conclusões de curso.

Implementação via API

Criar Turmas

Este endpoint permite criar novas turmas no LMS.

• URL: https://api.toolzz.dev/lms/turmas
• Método: POST
• Headers:
  • Authorization: Bearer SEU_TOKEN
  • Content-Type: application/json

Exemplo de body JSON:

{ "nome": "Turma de Vendas Avançado - 2026", "descricao": "Turma para treinamento avançado em técnicas de vendas", "data_inicio": "2026-01-15", "data_fim": "2026-12-20" }

bash curl -X POST
'https://api.toolzz.dev/lms/turmas'
-H 'Authorization: Bearer SEU_TOKEN'
-H 'Content-Type: application/json'
-d '{ "nome": "Turma de Vendas Avançado - 2026", "descricao": "Turma para treinamento avançado em técnicas de vendas", "data_inicio": "2026-01-15", "data_fim": "2026-12-20" }'

javascript const url = 'https://api.toolzz.dev/lms/turmas'; const data = { nome: 'Turma de Vendas Avançado - 2026', descricao: 'Turma para treinamento avançado em técnicas de vendas', data_inicio: '2026-01-15', data_fim: '2026-12-20' };

fetch(url, { method: 'POST', headers: { 'Authorization': 'Bearer SEU_TOKEN', 'Content-Type': 'application/json' }, body: JSON.stringify(data) }) .then(response => response.json()) .then(data => console.log(data)) .catch(error => console.error('Error:', error));

python import requests import json

url = 'https://api.toolzz.dev/lms/turmas' headers = { 'Authorization': 'Bearer SEU_TOKEN', 'Content-Type': 'application/json' } data = { 'nome': 'Turma de Vendas Avançado - 2026', 'descricao': 'Turma para treinamento avançado em técnicas de vendas', 'data_inicio': '2026-01-15', 'data_fim': '2026-12-20' }

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

Tabela de parâmetros:

Exemplo de response JSON:

{ "id": 123, "nome": "Turma de Vendas Avançado - 2026", "descricao": "Turma para treinamento avançado em técnicas de vendas", "data_inicio": "2026-01-15", "data_fim": "2026-12-20" }

Matricule alunos em uma turma

Este endpoint permite matricular alunos em uma turma existente.

• URL: https://api.toolzz.dev/lms/turmas/{turma_id}/matriculas
• Método: POST
• Headers:
  • Authorization: Bearer SEU_TOKEN
  • Content-Type: application/json

Exemplo de body JSON:

{ "usuario_id": 456 }

bash curl -X POST
'https://api.toolzz.dev/lms/turmas/123/matriculas'
-H 'Authorization: Bearer SEU_TOKEN'
-H 'Content-Type: application/json'
-d '{ "usuario_id": 456 }'

javascript const turmaId = 123; const url = https://api.toolzz.dev/lms/turmas/${turmaId}/matriculas; const data = { usuario_id: 456 };

fetch(url, { method: 'POST', headers: { 'Authorization': 'Bearer SEU_TOKEN', 'Content-Type': 'application/json' }, body: JSON.stringify(data) }) .then(response => response.json()) .then(data => console.log(data)) .catch(error => console.error('Error:', error));

python import requests import json

turma_id = 123 url = f'https://api.toolzz.dev/lms/turmas/{turma_id}/matriculas' headers = { 'Authorization': 'Bearer SEU_TOKEN', 'Content-Type': 'application/json' } data = { 'usuario_id': 456 }

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

Exemplo de response JSON:

{ "id": 789, "turma_id": 123, "usuario_id": 456 }

Criar usuário em várias escolas

Este endpoint permite criar um novo usuário em múltiplas escolas.

• URL: https://api.toolzz.dev/lms/usuarios
• Método: POST
• Headers:
  • Authorization: Bearer SEU_TOKEN
  • Content-Type: application/json

Exemplo de body JSON:

{ "nome": "João da Silva", "email": "[email protected]", "cpf": "123.456.789-00", "escolas": [1, 2, 3] }

bash curl -X POST
'https://api.toolzz.dev/lms/usuarios'
-H 'Authorization: Bearer SEU_TOKEN'
-H 'Content-Type: application/json'
-d '{ "nome": "João da Silva", "email": "[email protected]", "cpf": "123.456.789-00", "escolas": [1, 2, 3] }'

javascript const url = 'https://api.toolzz.dev/lms/usuarios'; const data = { nome: 'João da Silva', email: '[email protected]', cpf: '123.456.789-00', escolas: [1, 2, 3] };

fetch(url, { method: 'POST', headers: { 'Authorization': 'Bearer SEU_TOKEN', 'Content-Type': 'application/json' }, body: JSON.stringify(data) }) .then(response => response.json()) .then(data => console.log(data)) .catch(error => console.error('Error:', error));

python import requests import json

url = 'https://api.toolzz.dev/lms/usuarios' headers = { 'Authorization': 'Bearer SEU_TOKEN', 'Content-Type': 'application/json' } data = { 'nome': 'João da Silva', 'email': '[email protected]', 'cpf': '123.456.789-00', 'escolas': [1, 2, 3] }

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

Exemplo de response JSON:

{ "id": 456, "nome": "João da Silva", "email": "[email protected]", "cpf": "123.456.789-00", "escolas": [1, 2, 3] }

Webhooks

Para receber notificações sobre eventos como novas matrículas, utilize os webhooks do Toolzz LXP.

Configurando um Webhook

1. Acesse a seção de webhooks no painel de administração.
2. Crie um novo webhook.
3. Defina a URL para onde as notificações serão enviadas.
4. Selecione os eventos que deseja monitorar (ex: Nova matrícula).

Payload de Exemplo (Nova Matrícula)

{ "evento": "Nova matrícula", "data": { "id": 789, "turma_id": 123, "usuario_id": 456, "data_matricula": "2026-01-10" } }

Processando o Webhook

No seu sistema, crie um endpoint para receber e processar o payload do webhook. Utilize as informações para atualizar seus registros e realizar outras ações necessárias.

Testando

Para validar a automatização, siga estes passos:

1. Crie uma turma via API.
2. Crie um usuário via API.
3. Matricule o usuário na turma via API.
4. Verifique se a matrícula foi registrada corretamente no painel do Toolzz LXP.

Erros comuns

• 401 Unauthorized: Token inválido ou ausente. Verifique se o token está correto e presente nos headers.
• 400 Bad Request: Dados inválidos no body da requisição. Verifique se os parâmetros estão corretos e no formato esperado.
• 404 Not Found: Turma ou usuário não encontrado. Verifique se os IDs estão corretos.

Dica: Consulte a documentação da API em docs.toolzz.dev/lms-reference/ para obter mais informações sobre os códigos de erro e suas soluções.

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?

Plataformas como a Docebo, Litmos e TalentLMS oferecem funcionalidades de LMS, mas a Toolzz se destaca pela integração com agentes de IA, proporcionando uma experiência mais automatizada e inteligente.

Descubra o poder da IA na automatização de processos! Conheça a Toolzz AI e veja como podemos transformar sua gestão educacional.

Conclusão

A automatização de matrículas via API do Toolzz LXP é uma solução eficiente para simplificar a gestão educacional. Ao integrar seus sistemas externos e utilizar os webhooks, você pode economizar tempo, reduzir erros e garantir que seus alunos tenham acesso rápido e fácil aos cursos. Experimente a Toolzz AI para levar a automação a um novo nível.