{ "name": "João da Silva", "email": "[email protected]", "cpf": "123.456.789-00", "role": "student", "unit_id": "654321", "school_id": "987654" }

• curl:

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

• javascript (fetch):

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

• python (requests):

python import requests

url = 'https://api.toolzz.dev/lms/v1/users' headers = { 'Authorization': 'Bearer TOKEN', 'Content-Type': 'application/json' } data = { "name": "João da Silva", "email": "[email protected]", "cpf": "123.456.789-00", "role": "student", "unit_id": "654321", "school_id": "987654" }

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

print(response.json())

• Parâmetros:

• Response JSON de exemplo:

{ "id": "a1b2c3d4e5f6", "name": "João da Silva", "email": "[email protected]", "cpf": "123.456.789-00", "role": "student", "unit_id": "654321", "school_id": "987654", "created_at": "2024-01-01T12:00:00Z" }

Endpoint: Matricular Aluno em Turma

Após a criação do usuário, é necessário matriculá-lo na turma desejada.

{ "user_id": "a1b2c3d4e5f6", "course_id": "f6e5d4c3b2a1" }

Webhooks

Para receber notificações sobre a conclusão de matrículas, você pode configurar um webhook para o evento "Nova Matrícula". O payload do webhook conterá informações sobre o usuário matriculado e o curso.

Exemplo de payload:

{ "event": "new_enrollment", "user_id": "a1b2c3d4e5f6", "course_id": "f6e5d4c3b2a1", "enrollment_date": "2024-01-01T12:00:00Z" }

Testando

Após configurar o webhook e o endpoint de criação de usuário, teste a integração enviando uma requisição POST para a API da Toolzz LMS com os dados de um novo colaborador. Verifique se o usuário foi criado com sucesso na plataforma LXP e se o webhook foi disparado corretamente para o seu sistema de RH.

Erros comuns

• 401 Unauthorized: Token de administrador inválido ou ausente.
• 400 Bad Request: Dados inválidos no corpo da requisição.
• 409 Conflict: Usuário já existe com o mesmo CPF.
• 500 Internal Server Error: Erro interno no servidor.

Verifique a documentação da API para obter mais informações sobre os códigos de erro e as possíveis soluções.

Conclusão

A integração entre o sistema de RH e a Toolzz LMS, utilizando webhooks, é uma solução poderosa para automatizar a gestão de talentos e otimizar o processo de onboarding e desenvolvimento dos colaboradores. Ao automatizar tarefas repetitivas, as empresas podem reduzir custos, minimizar erros e focar em estratégias de alto valor. Ao implementar essa integração, sua empresa estará mais preparada para atrair, reter e desenvolver os melhores talentos.

Pronto para escalar a gestão de talentos da sua empresa? Conheça a Toolzz e descubra como nossas soluções podem te ajudar.

Ainda buscando mais automação e inteligência? 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? Conheça a Toolzz AI.