Body JSON de Exemplo:

{ "aluno_id": "654321abcdef012" }

Exemplo em curl:

bash curl -X POST https://api.toolzz.com.br/lms/v1/turmas/1234567890abcdef/alunos -H 'Authorization: Bearer SEU_TOKEN' -H 'Content-Type: application/json' -d '{"aluno_id": "654321abcdef012"}'

Exemplo em javascript (fetch):

javascript const token = 'SEU_TOKEN'; const turmaId = '1234567890abcdef'; const alunoId = '654321abcdef012';

fetch(https://api.toolzz.com.br/lms/v1/turmas/${turmaId}/alunos, { method: 'POST', headers: { 'Authorization': Bearer ${token}, 'Content-Type': 'application/json' }, body: JSON.stringify({ aluno_id: alunoId }) })
.then(response => response.json()) .then(data => console.log(data)) .catch(error => console.error('Error:', error));

Exemplo em python (requests):

python import requests

token = 'SEU_TOKEN' turma_id = '1234567890abcdef' aluno_id = '654321abcdef012'

headers = { 'Authorization': f'Bearer {token}', 'Content-Type': 'application/json' }

data = { 'aluno_id': aluno_id }

response = requests.post(f'https://api.toolzz.com.br/lms/v1/turmas/{turma_id}/alunos', headers=headers, json=data)

print(response.json())

Response JSON de Exemplo (Sucesso):

{ "message": "Aluno matriculado com sucesso na turma.", "status": "success" }

Webhooks

Para ser notificado sobre novas matrículas, você pode configurar um webhook no endpoint alunos.matriculado. Ao configurar o webhook, você precisará fornecer uma URL para a qual o Toolzz LMS enviará as notificações. O payload do webhook conterá informações sobre o aluno matriculado e a turma.

Testando

Após implementar a integração, teste-a cuidadosamente para garantir que as matrículas estão sendo realizadas corretamente. Verifique se os alunos aparecem nas turmas corretas no Toolzz LMS e se todas as informações estão sendo sincronizadas corretamente.

Erros Comuns

• 401 Unauthorized: Token inválido ou ausente. Verifique se o token está correto e se você o incluiu no header Authorization.
• 400 Bad Request: Dados inválidos no corpo da requisição. Verifique se os parâmetros obrigatórios estão presentes e se os tipos de dados estão corretos.
• 404 Not Found: Turma ou aluno não encontrado. Verifique se os IDs da turma e do aluno estão corretos.
• 500 Internal Server Error: Erro interno no servidor. Entre em contato com o suporte da Toolzz para obter ajuda.

Conclusão

A automatização de matrículas através da API do Toolzz LMS permite otimizar a gestão educacional, reduzir erros e liberar recursos administrativos para atividades mais estratégicas. Ao integrar o Toolzz LMS com seus sistemas existentes, você pode criar um fluxo de trabalho mais eficiente e melhorar a experiência do aluno. A flexibilidade e a robustez da API do Toolzz LMS tornam-no uma ferramenta poderosa para instituições de ensino de todos os portes.

Se você busca ir além da automação básica, a Toolzz AI pode revolucionar seus processos. 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?