Em ambientes reais, você obterá course_id e student_id a partir do payload do webhook de conclusão. O campo issue_date é opcional; se omitido, o sistema usa a data/hora atual.

Exemplo com curl

bash curl -X POST https://api.toolzz.com/v1/certificates
-H "Authorization: Bearer token_aqui"
-H "Content-Type: application/json"
-d '{ "course_id": 1823, "student_id": 4592, "issue_date": "2026-03-15T10:00:00Z" }'

Exemplo com JavaScript (Node.js + axios)

javascript const axios = require('axios');

const emitirCertificado = async (courseId, studentId) => { try { const response = await axios.post('https://api.toolzz.com/v1/certificates', { course_id: courseId, student_id: studentId, issue_date: new Date().toISOString() }, { headers: { 'Authorization': 'Bearer SEU_TOKEN', 'Content-Type': 'application/json' } }); console.log('Certificado emitido:', response.data); return response.data; } catch (error) { console.error('Erro ao emitir certificado:', error.response.data); } };

Exemplo com Python (requests)

python import requests import json

url = "https://api.toolzz.com/v1/certificates" headers = { "Authorization": "Bearer SEU_TOKEN", "Content-Type": "application/json" } payload = { "course_id": 1823, "student_id": 4592, "issue_date": "2026-03-15T10:00:00Z" }

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

Parâmetros do Body

Resposta de Sucesso (201 Created)

{ "id": 11235, "course_id": 1823, "student_id": 4592, "issued_at": "2026-03-15T10:00:00Z", "download_url": "https://api.toolzz.com/v1/certificates/11235/download", "status": "issued" }

O campo download_url permite baixar o certificado em PDF. Você pode enviar esse link ao aluno por e-mail ou notificação.

Integrações como essa são o que separa operações manuais de experiências de aprendizado em escala. Com a Toolzz, líderes de mercado automatizam não apenas certificados, mas todo o ciclo de treinamento.

Endpoint: Obter Certificado

Caso precise recuperar informações de um certificado já emitido:

• URL: GET https://api.toolzz.com/v1/certificates/{id}

• Headers: Authorization: Bearer SEU_TOKEN

• Exemplo curl: bash curl -H "Authorization: Bearer token_aqui" https://api.toolzz.com/v1/certificates/11235

• Resposta: igual ao JSON da emissão, incluindo download_url.

Webhooks: Rastreando Emissões e Conclusões

Os webhooks proporcionam a automação em tempo real. Vamos configurar e processar o evento de conclusão de curso para disparar a emissão.

Configurando Webhooks no Toolzz LMS

Na interface administrativa, em Integrações > Webhooks:

1. Clique em Adicionar Webhook.
2. Escolha o evento Curso Concluído.
3. Insira a URL do seu endpoint (ex.: https://meudominio.com/webhook/toolzz).
4. Defina um segredo (chave de assinatura) opcional para validar a origem das requisições.
5. Salve. A plataforma enviará um ping de verificação.

Payload de Exemplo: Curso Concluído

Quando um aluno termina todas as aulas, o Toolzz envia:

{ "event": "course.completed", "timestamp": "2026-03-15T14:30:00Z", "data": { "course_id": 1823, "course_name": "Python para Data Science", "student": { "id": 4592, "name": "Maria Souza", "email": "[email protected]" }, "completed_at": "2026-03-15T14:29:55Z", "progress": 100 } }

⚠️ Importante: Sempre verifique o cabeçalho X-Toolzz-Signature se configurou um segredo, para garantir que a requisição é legítima.

Processando o Webhook e Emitindo Certificado (Node.js)

Aqui está um exemplo de servidor Express que recebe o webhook e dispara a API de emissão:

javascript const express = require('express'); const axios = require('axios'); const app = express(); app.use(express.json());

const TOOLZZ_TOKEN = process.env.TOOLZZ_TOKEN; const WEBHOOK_SECRET = process.env.WEBHOOK_SECRET;

app.post('/webhook/toolzz', async (req, res) => { // Valida assinatura (opcional) const signature = req.headers['x-toolzz-signature']; const payload = JSON.stringify(req.body); const expected = crypto.createHmac('sha256', WEBHOOK_SECRET).update(payload).digest('hex'); if (signature !== expected) { return res.status(401).json({ error: 'Assinatura inválida' }); }

const event = req.body; if (event.event === 'course.completed') { const { course_id, student } = event.data; try { const response = await axios.post('https://api.toolzz.com/v1/certificates', { course_id, student_id: student.id }, { headers: { 'Authorization': Bearer ${TOOLZZ_TOKEN} } }); console.log('Certificado emitido:', response.data.id); // Opcional: enviar email com o link de download } catch (error) { console.error('Falha na emissão:', error.response.data); // Reagendar ou logar erro para análise } } res.status(200).send('OK'); });

app.listen(3000, () => console.log('Webhook ouvindo na porta 3000'));

Testando a Solução

1. Crie um aluno de teste e matricule-o em um curso via interface ou API.
2. Simule a conclusão marcando todas as aulas como assistidas (como administrador, é possível forçar progresso).
3. Verifique se o webhook é chamado — logs do servidor mostrarão o payload.
4. Confira no painel Toolzz LMS se o certificado aparece na lista do aluno (menu Alunos > Certificados).
5. Teste o download acessando a URL retornada pela API.

Erros Comuns

Erro de assinatura inválida no webhook: certifique-se de que o segredo cadastrado na plataforma é o mesmo utilizado na verificação HMAC.

Certificado já emitido: se o mesmo par (aluno, curso) já tiver um certificado, a API pode retornar erro. Considere verificar com GET /certificates?student_id=X&course_id=Y antes de emitir.

Conclusão

Automatizar a emissão de certificados com a API do Toolzz LMS elimina atrasos, reduz erros manuais e proporciona uma experiência de aprendizado contínua. Ao combinar webhooks e endpoints REST, você constrói um fluxo confiável que escala com o crescimento da sua base de alunos. Empresas líderes de mercado já adotam essa prática; agora você tem o passo a passo para implementá-la.

Automatize ainda mais com agentes de IA da Toolzz

E se em vez de escrever código para cada integração, você pudesse delegar essa tarefa a um agente inteligente? Com a Toolzz AI, é possível criar um agente que, ao receber uma mensagem de WhatsApp dizendo “Emita o certificado do João no curso de Liderança”, automaticamente consulta o banco de alunos, chama a API de certificados e envia o link de volta ao gestor. Tudo isso sem digitar uma linha de comando.

Já imaginou seu RH perguntando pelo WhatsApp: “Quantos certificados foram emitidos este mês?” e o agente responder com um relatório em segundos? A Toolzz AI conecta sua plataforma LMS com canais de comunicação e executa ações em tempo real. É o próximo passo em automação inteligente para educação corporativa. Solicite uma demonstração da Toolzz AI e veja como criar esse agente hoje.