Authorization: Bearer SEU_TOKEN Content-Type: application/json

Body JSON de exemplo:

{ "nome": "Turma de Vendas - Outubro 2026", "descricao": "Turma para treinamento de novos vendedores", "data_inicio": "2026-10-01", "data_fim": "2026-10-31", "unidade_id": 123 }

Code block (curl):

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 - Outubro 2026", "descricao": "Turma para treinamento de novos vendedores", "data_inicio": "2026-10-01", "data_fim": "2026-10-31", "unidade_id": 123 }'

Code block (javascript - fetch):

javascript const url = 'https://api.toolzz.dev/lms/turmas'; const data = { nome: 'Turma de Vendas - Outubro 2026', descricao: 'Turma para treinamento de novos vendedores', data_inicio: '2026-10-01', data_fim: '2026-10-31', unidade_id: 123 };

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));

Code block (python - requests):

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 - Outubro 2026', 'descricao': 'Turma para treinamento de novos vendedores', 'data_inicio': '2026-10-01', 'data_fim': '2026-10-31', 'unidade_id': 123 }

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

Tabela de parâmetros:

Response JSON de exemplo:

{ "id": 456, "nome": "Turma de Vendas - Outubro 2026", "descricao": "Turma para treinamento de novos vendedores", "data_inicio": "2026-10-01", "data_fim": "2026-10-31", "unidade_id": 123 }

Matricular Alunos em uma Turma

Este endpoint permite matricular alunos em uma turma existente.

• URL: https://api.toolzz.dev/lms/turmas/{turma_id}/alunos
• Método: POST

Headers:

Authorization: Bearer SEU_TOKEN Content-Type: application/json

Body JSON de exemplo:

{ "aluno_id": [789, 790, 791] }

Code block (curl):

bash curl -X POST
'https://api.toolzz.dev/lms/turmas/456/alunos'
-H 'Authorization: Bearer SEU_TOKEN'
-H 'Content-Type: application/json'
-d '{ "aluno_id": [789, 790, 791] }'

Code block (javascript - fetch):

javascript const turmaId = 456; const url = https://api.toolzz.dev/lms/turmas/${turmaId}/alunos; const data = { aluno_id: [789, 790, 791] };

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));

Code block (python - requests):

python import requests import json

turma_id = 456 url = f'https://api.toolzz.dev/lms/turmas/{turma_id}/alunos' headers = { 'Authorization': 'Bearer SEU_TOKEN', 'Content-Type': 'application/json' } data = { 'aluno_id': [789, 790, 791] }

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

Tabela de parâmetros:

Response JSON de exemplo:

{ "message": "Alunos matriculados com sucesso" }

Criar Usuário em Várias Escolas

Este endpoint permite criar um usuário (aluno) e associá-lo a várias escolas.

• URL: https://api.toolzz.dev/lms/alunos
• Método: POST

Headers:

Authorization: Bearer SEU_TOKEN Content-Type: application/json

Body JSON de exemplo:

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

Code block (curl):

bash curl -X POST
'https://api.toolzz.dev/lms/alunos'
-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_id": [1, 2, 3] }'

Code block (javascript - fetch):

javascript const url = 'https://api.toolzz.dev/lms/alunos'; const data = { nome: 'João da Silva', email: '[email protected]', cpf: '123.456.789-00', escolas_id: [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));

Code block (python - requests):

python import requests import json

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

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

Tabela de parâmetros:

Response JSON de exemplo:

{ "id": 901, "nome": "João da Silva", "email": "[email protected]", "cpf": "123.456.789-00" }

Webhooks

A Toolzz LXP também oferece webhooks para notificar seu sistema externo sobre eventos importantes, como:

• Nova matrícula
• Novo cadastro
• Curso concluído

Para configurar um webhook, siga os seguintes passos:

1. Acesse as configurações da sua conta Toolzz LXP.
2. Procure pela seção de webhooks.
3. Adicione a URL do seu endpoint para receber as notificações.
4. Selecione os eventos que deseja receber.

Payload de exemplo (Nova matrícula):

{ "evento": "nova_matricula", "aluno_id": 789, "turma_id": 456, "data_matricula": "2026-09-15" }

Seu sistema deve estar preparado para receber e processar esses payloads.

Testando a Automação

Para validar que a automação está funcionando corretamente, siga estes passos:

1. Crie uma turma via API.
2. Matricule alunos nessa turma via API.
3. Verifique na interface da Toolzz LXP se a turma foi criada e se os alunos foram matriculados corretamente.

Erros Comuns

Ao implementar a automação, você pode encontrar alguns erros comuns. Aqui estão alguns exemplos e suas soluções:

• Código HTTP 401 (Não Autorizado): Verifique se o token de autenticação está correto e se você tem permissão para acessar o endpoint.
• Código HTTP 400 (Requisição Inválida): Verifique se o corpo da requisição está no formato JSON correto e se os parâmetros obrigatórios estão presentes.
• Mensagem de erro "Turma não encontrada": Verifique se o ID da turma está correto.

Dica: Consulte a documentação da API da Toolzz (docs.toolzz.dev/lms-reference/) para obter mais detalhes sobre os erros e suas soluções.

Alternativas e Concorrentes

No mercado de LMS, existem diversas opções além da Toolzz. Plataformas como Moodle, Totara Learn e TalentLMS oferecem funcionalidades similares. No entanto, a Toolzz se destaca pela sua flexibilidade, facilidade de uso e, principalmente, pela integração com agentes de IA. Enquanto outras plataformas podem exigir conhecimentos técnicos avançados para personalização e automação, a Toolzz oferece uma interface intuitiva e uma API completa para desenvolvedores. Além disso, a Toolzz AI permite automatizar tarefas complexas sem a necessidade de código, tornando a gestão educacional mais eficiente e acessível.

Conclusão

A automação da matrícula de alunos via API da Toolzz LXP é uma solução eficiente para otimizar a gestão educacional. Ao integrar seu sistema externo com a API da Toolzz, você pode automatizar tarefas repetitivas, reduzir erros e focar em oferecer um ensino de qualidade. Além disso, a integração com Toolzz AI eleva a automação a um novo nível, permitindo criar agentes de IA que executam tarefas complexas de forma autônoma.

Automatize ainda mais com agentes de IA da Toolzz: Conecte o LMS com Toolzz AI. 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?

Pronto para levar a automação para o próximo nível? Conheça a Toolzz AI e descubra como a inteligência artificial pode transformar a sua gestão educacional.