{ "Authorization": "Bearer SEU_TOKEN", "Content-Type": "application/json" }

Body JSON de Exemplo:

{ "name": "Maria Silva", "email": "[email protected]", "cpf": "123.456.789-00", "school_id": "654321", "role": "student" }

curl:

bash curl -X POST https://api.toolzz.dev/api/v1/users -H 'Authorization: Bearer SEU_TOKEN' -H 'Content-Type': 'application/json' -d '{ "name": "Maria Silva", "email": "[email protected]", "cpf": "123.456.789-00", "school_id": "654321", "role": "student" }'

javascript (fetch):

javascript fetch('https://api.toolzz.dev/api/v1/users', { method: 'POST', headers: { 'Authorization': 'Bearer SEU_TOKEN', 'Content-Type': 'application/json' }, body: JSON.stringify({ name: 'Maria Silva', email: '[email protected]', cpf: '123.456.789-00', school_id: '654321', role: 'student' }) }) .then(response => response.json()) .then(data => console.log(data)) .catch(error => console.error('Error:', error));

python (requests):

python import requests

url = 'https://api.toolzz.dev/api/v1/users' headers = { 'Authorization': 'Bearer SEU_TOKEN', 'Content-Type': 'application/json' } data = { 'name': 'Maria Silva', 'email': '[email protected]', 'cpf': '123.456.789-00', 'school_id': '654321', 'role': 'student' }

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

print(response.json())

Parâmetros:

Response JSON de Exemplo:

{ "id": "123456", "name": "Maria Silva", "email": "[email protected]", "cpf": "123.456.789-00", "school_id": "654321", "role": "student" }

Matricular Usuário em uma Turma

{ "Authorization": "Bearer SEU_TOKEN", "Content-Type": "application/json" }

Body JSON de Exemplo:

{ "user_id": "123456", "course_id": "987654", "class_id": "555555" }

curl:

bash curl -X POST https://api.toolzz.dev/api/v1/enrollments -H 'Authorization: Bearer SEU_TOKEN' -H 'Content-Type': 'application/json' -d '{ "user_id": "123456", "course_id": "987654", "class_id": "555555" }'

javascript (fetch):

javascript fetch('https://api.toolzz.dev/api/v1/enrollments', { method: 'POST', headers: { 'Authorization': 'Bearer SEU_TOKEN', 'Content-Type': 'application/json' }, body: JSON.stringify({ user_id: '123456', course_id: '987654', class_id: '555555' }) }) .then(response => response.json()) .then(data => console.log(data)) .catch(error => console.error('Error:', error));

python (requests):

python import requests

url = 'https://api.toolzz.dev/api/v1/enrollments' headers = { 'Authorization': 'Bearer SEU_TOKEN', 'Content-Type': 'application/json' } data = { 'user_id': '123456', 'course_id': '987654', 'class_id': '555555' }

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

print(response.json())

Parâmetros:

Response JSON de Exemplo:

{ "message": "Usuário matriculado com sucesso." }

Webhooks

Para receber notificações sobre eventos como novas matrículas, você pode configurar webhooks no painel de administração do Toolzz LMS. Configure o URL do seu servidor para receber as notificações.

Webhook de Nova Matrícula:

• Evento: enrollment.created
• Payload de Exemplo:

{ "enrollment_id": "777777", "user_id": "123456", "course_id": "987654", "class_id": "555555", "created_at": "2024-10-27T10:00:00Z" }

Testando

Após implementar a automação, teste o processo criando um novo usuário no sistema externo e verificando se ele é criado e matriculado automaticamente na plataforma Toolzz LMS.

Erros comuns

• Erro 400 - Bad Request: Verifique se os parâmetros enviados na requisição estão corretos.
• Erro 401 - Unauthorized: Verifique se o token de administrador é válido.
• Erro 404 - Not Found: Verifique se os IDs de usuário, curso ou turma existem na plataforma.

Conclusão

Automatizar matrículas com a API do Toolzz LMS oferece inúmeros benefícios, incluindo redução de erros, otimização de tempo e melhoria da experiência do aluno. Ao integrar a API com seus sistemas externos, você pode criar um fluxo de trabalho eficiente e escalável para a gestão de matrículas. A Toolzz oferece uma solução completa e flexível para atender às suas necessidades de educação corporativa.

Com a Toolzz, a gestão de matrículas se torna simples e eficiente, permitindo que você se concentre no que realmente importa: o desenvolvimento de seus colaboradores.

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?