Toolzz: O Parceiro Tecnológico Ideal para 2026

Lucas (CEO Toolzz)
17 de abril de 2026

Gerenciar matrículas em cursos e turmas pode ser um processo manual e demorado, especialmente em instituições de ensino de grande porte ou empresas com programas de treinamento extensivos. A necessidade de inserir dados repetidamente, lidar com erros de digitação e garantir a consistência das informações entre diferentes sistemas são desafios comuns. A automatização desse processo não apenas economiza tempo e recursos, mas também minimiza erros e melhora a experiência do aluno. É nesse contexto que a API do Toolzz LMS se destaca, oferecendo uma solução flexível e poderosa para integrar sistemas externos e automatizar a gestão de matrículas.

Pré-requisitos

Para começar, você precisará de uma conta ativa na Toolzz LMS e um token de administrador. O token é essencial para autenticar suas requisições à API. Para gerar o token, siga estes passos:

1. Acesse o painel de administração da Toolzz LMS.
2. Navegue até a seção “Configurações” e, em seguida, “API”.
3. Clique em “Gerar Token”.
4. Copie o token gerado. Mantenha-o em um local seguro, pois ele será usado em todas as suas requisições.

Dica: O token de administrador concede acesso total à API. Utilize-o com cautela e considere a criação de tokens com permissões mais restritas para aplicações específicas.

Arquitetura da solução

A solução proposta envolve a integração entre um sistema externo (por exemplo, um sistema de RH ou um portal do aluno) e a API do Toolzz LMS. O fluxo de dados é o seguinte:

1. O sistema externo envia uma requisição à API do Toolzz LMS com os dados do aluno e da turma.
2. A API valida os dados e realiza a matrícula do aluno na turma.
3. A plataforma LXP da Toolzz LMS é atualizada com as informações da matrícula.

Esse fluxo permite que a matrícula seja realizada de forma automática, sem a necessidade de intervenção manual. Se você busca uma plataforma completa para gerenciar o aprendizado e desenvolvimento da sua equipe, conheça a Toolzz e descubra como podemos te ajudar.

Passo a passo no produto

Antes de começar a implementar a automação via API, é importante configurar as turmas e os cursos na interface do Toolzz LMS. Isso garante que as informações estejam corretas e consistentes:

1. Crie os cursos: Acesse a seção “Cursos” e crie os cursos que serão oferecidos.
2. Crie as turmas: Dentro de cada curso, crie as turmas com as datas e horários correspondentes.
3. Configure as permissões: Defina as permissões de acesso para cada turma, determinando quais alunos podem se matricular.

Implementação via API

Para automatizar a matrícula de alunos, utilizaremos o endpoint POST /api/v1/enrollments. Este endpoint permite matricular um aluno em uma ou mais turmas.

URL e Método HTTP

POST /api/v1/enrollments

Headers

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

Body JSON de exemplo

{ "student_id": "12345678900", "course_ids": ["curso1", "curso2"] }

Code block (curl)

bash curl -X POST 'https://api.toolzz.com.br/api/v1/enrollments' -H 'Authorization: Bearer SEU_TOKEN_DE_ADMINISTRADOR' -H 'Content-Type': 'application/json' -d '{ "student_id": "12345678900", "course_ids": ["curso1", "curso2"] }'

Code block (JavaScript - fetch)

javascript fetch('https://api.toolzz.com.br/api/v1/enrollments', { method: 'POST', headers: { 'Authorization': 'Bearer SEU_TOKEN_DE_ADMINISTRADOR', 'Content-Type': 'application/json' }, body: JSON.stringify({ student_id: '12345678900', course_ids: ['curso1', 'curso2'] }) }) .then(response => response.json()) .then(data => console.log(data)) .catch(error => console.error(error));

Code block (Python - requests)

python import requests

url = 'https://api.toolzz.com.br/api/v1/enrollments' headers = { 'Authorization': 'Bearer SEU_TOKEN_DE_ADMINISTRADOR', 'Content-Type': 'application/json' } data = { 'student_id': '12345678900', 'course_ids': ['curso1', 'curso2'] }

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

print(response.json())

Tabela de parâmetros

Response JSON de exemplo

{ "success": true, "message": "Aluno matriculado com sucesso.", "data": { "enrollment_id": "12345", "student_id": "12345678900", "course_ids": ["curso1", "curso2"] } }

Webhooks

Para receber notificações sobre eventos de matrícula, você pode configurar webhooks. O webhook enrollment.created é disparado sempre que um aluno é matriculado em um curso. Para configurar o webhook, acesse a seção “Webhooks” no painel de administração da Toolzz LMS e insira a URL para onde as notificações devem ser enviadas.

O payload do webhook contém informações sobre a matrícula, como o ID do aluno, o ID do curso e a data da matrícula.

Testando

Após implementar a integração, é importante realizar testes para garantir que tudo esteja funcionando corretamente. Você pode utilizar o endpoint da API para matricular um aluno em um curso e verificar se a matrícula é refletida na plataforma LXP da Toolzz LMS. Além disso, verifique se o webhook está sendo disparado corretamente e se as notificações estão sendo recebidas.

Erros comuns

• Código 400 (Bad Request): Indica que os dados enviados na requisição são inválidos. Verifique se os parâmetros student_id e course_ids estão corretos e no formato esperado.
• Código 401 (Unauthorized): Indica que o token de administrador é inválido ou expirou. Gere um novo token e tente novamente.
• Código 404 (Not Found): Indica que o curso especificado não existe. Verifique se o ID do curso está correto.
• Código 500 (Internal Server Error): Indica que ocorreu um erro interno no servidor. Entre em contato com o suporte da Toolzz LMS para obter ajuda.

Conclusão

A API do Toolzz LMS oferece uma solução poderosa e flexível para automatizar a gestão de matrículas, economizando tempo e recursos, minimizando erros e melhorando a experiência do aluno. Ao integrar sistemas externos com a API, as instituições de ensino e empresas podem otimizar seus processos de treinamento e oferecer uma experiência mais personalizada e eficiente.

Com a Toolzz, a automação da gestão educacional se torna uma realidade, permitindo que você se concentre no que realmente importa: o aprendizado e o desenvolvimento dos seus alunos e 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? Conheça a Toolzz AI.