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

• Code block (curl):

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

• Code block (javascript - fetch):

javascript const url = 'https://api.toolzz.com.br/lms/users'; const data = { name: 'João da Silva', email: '[email protected]', cpf: '123.456.789-00', schools: [1, 2] };

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

• Code block (python - requests):

python import requests import json

url = 'https://api.toolzz.com.br/lms/users' headers = { 'Authorization': 'Bearer SEU_TOKEN', 'Content-Type': 'application/json' } data = { 'name': 'João da Silva', 'email': '[email protected]', 'cpf': '123.456.789-00', 'schools': [1, 2] }

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

• Tabela de parâmetros:

• Response JSON de exemplo:

{ "id": 123, "name": "João da Silva", "email": "[email protected]", "cpf": "123.456.789-00", "schools": [1, 2], "created_at": "2026-01-01T10:00:00Z", "updated_at": "2026-01-01T10:00:00Z" }

Criar Turmas

Este endpoint permite criar uma nova turma.

{ "name": "Turma de Vendas - Janeiro 2026", "course_id": 1, "start_date": "2026-01-15", "end_date": "2026-01-31" }

• Code block (curl):

bash curl -X POST
'https://api.toolzz.com.br/lms/classes'
-H 'Authorization: Bearer SEU_TOKEN'
-H 'Content-Type: application/json'
-d '{ "name": "Turma de Vendas - Janeiro 2026", "course_id": 1, "start_date": "2026-01-15", "end_date": "2026-01-31" }'

• Code block (javascript - fetch):

javascript const url = 'https://api.toolzz.com.br/lms/classes'; const data = { name: 'Turma de Vendas - Janeiro 2026', course_id: 1, start_date: '2026-01-15', end_date: '2026-01-31' };

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

• Code block (python - requests):

python import requests import json

url = 'https://api.toolzz.com.br/lms/classes' headers = { 'Authorization': 'Bearer SEU_TOKEN', 'Content-Type': 'application/json' } data = { 'name': 'Turma de Vendas - Janeiro 2026', 'course_id': 1, 'start_date': '2026-01-15', 'end_date': '2026-01-31' }

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

• Tabela de parâmetros:

• Response JSON de exemplo:

{ "id": 456, "name": "Turma de Vendas - Janeiro 2026", "course_id": 1, "start_date": "2026-01-15", "end_date": "2026-01-31", "created_at": "2026-01-01T10:00:00Z", "updated_at": "2026-01-01T10:00:00Z" }

Matricular Alunos em uma Turma

Este endpoint permite matricular um ou mais alunos em uma turma existente.

{ "user_ids": [123, 124, 125] }

• Code block (curl):

bash curl -X POST
'https://api.toolzz.com.br/lms/classes/456/enroll'
-H 'Authorization: Bearer SEU_TOKEN'
-H 'Content-Type: application/json'
-d '{ "user_ids": [123, 124, 125] }'

• Code block (javascript - fetch):

javascript const url = 'https://api.toolzz.com.br/lms/classes/456/enroll'; const data = { user_ids: [123, 124, 125] };

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

• Code block (python - requests):

python import requests import json

url = 'https://api.toolzz.com.br/lms/classes/456/enroll' headers = { 'Authorization': 'Bearer SEU_TOKEN', 'Content-Type': 'application/json' } data = { 'user_ids': [123, 124, 125] }

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!" }

Webhooks

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

• Nova matrícula: Notifica quando um novo usuário é matriculado em um curso ou turma.
• Novo cadastro: Notifica quando um novo usuário é cadastrado na plataforma.
• Curso concluído: Notifica quando um usuário conclui um curso.

Para configurar um webhook, você precisa fornecer a URL para onde a notificação será enviada. O payload da notificação conterá informações sobre o evento, como o ID do usuário, o ID do curso e a data da matrícula.

Exemplo de payload do webhook de nova matrícula:

{ "event": "new_enrollment", "user_id": 123, "course_id": 1, "class_id": 456, "enrollment_date": "2026-01-01T10:00:00Z" }

Erros comuns

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

• Código HTTP 401 Unauthorized: Este erro indica que o token de autenticação está incorreto ou expirado. Verifique se o token está correto e gere um novo token se necessário.
• Código HTTP 400 Bad Request: Este erro indica que a requisição está mal formatada ou que algum parâmetro está faltando. Verifique se todos os parâmetros obrigatórios estão presentes e se os dados estão no formato correto.
• Mensagem de erro "Usuário não encontrado": Este erro indica que o ID do usuário especificado não existe na plataforma. Verifique se o ID do usuário está correto.

Alternativas e Concorrentes

Existem outras plataformas LMS no mercado que também oferecem APIs para integração, como Moodle, Totara Learn e TalentLMS. No entanto, a Toolzz se destaca pela sua interface intuitiva, facilidade de uso e recursos avançados de automação, além de oferecer agentes de IA para otimizar ainda mais a gestão educacional.

Conclusão

A automatização de matrículas via API do Toolzz LXP é uma solução eficiente para otimizar a gestão educacional em empresas de todos os portes. Ao integrar o sistema de RH com a plataforma LXP, é possível automatizar a matrícula de novos colaboradores nos treinamentos relevantes, garantindo que todos tenham acesso ao conteúdo necessário de forma rápida e eficiente. Isso economiza tempo, reduz erros e melhora a experiência do aluno. Além disso, a Toolzz oferece recursos avançados de automação com agentes de IA, tornando a gestão educacional ainda mais eficiente.

Se você busca uma solução completa e inovadora para a gestão de aprendizagem, conheça a Toolzz AI e descubra como a inteligência artificial pode transformar seus resultados.