Variáveis do certificado
variáveis transformam 1 template em 1.000 certificados personalizados — sistema substitui automaticamente nome, curso, data, etc. para cada aluno.
Como funciona
Você escreve no template:
``` Conferimos a {{aluno_nome}} a conclusão do curso "{{curso_nome}}" com carga de {{carga_horaria}}h. ```
Sistema gera para Maria:
``` Conferimos a Maria Silva a conclusão do curso "Marketing Digital" com carga de 40h. ```
E para João:
``` Conferimos a João Oliveira a conclusão do curso "Marketing Digital" com carga de 40h. ```
Catálogo completo de variáveis
👤 Sobre o aluno
| Variável | Conteúdo | |---|---| | `{{aluno_nome}}` | Nome completo | | `{{aluno_primeiro_nome}}` | Apenas primeiro nome | | `{{aluno_email}}` | Email do aluno | | `{{aluno_cpf}}` | CPF (se autorizado e necessário) | | `{{aluno_documento}}` | Genérico (CPF, RG, passaporte) | | `{{aluno_pais}}` | País | | `{{aluno_estado}}` | Estado |
⚠️ CPF em certificado só se necessário (regulamentação MEC, OAB, CRP). Senão, evite por LGPD.
🎓 Sobre o curso
| Variável | Conteúdo | |---|---| | `{{curso_nome}}` | Título do curso | | `{{curso_descricao}}` | Descrição (raramente usado) | | `{{curso_categoria}}` | Categoria | | `{{curso_nivel}}` | Básico, Intermediário, Avançado | | `{{carga_horaria}}` | Em horas (ex: 40h) | | `{{numero_aulas}}` | Total de aulas | | `{{turma}}` | Nome da turma | | `{{instrutor_nome}}` | Professor principal | | `{{instrutor_titulacao}}` | Mestre, Doutor, etc. |
📅 Sobre o evento de conclusão
| Variável | Conteúdo | |---|---| | `{{data_emissao}}` | Data de geração do certificado | | `{{data_emissao_formato_extenso}}` | "02 de maio de 2026" | | `{{data_inicio_curso}}` | Quando aluno matriculou | | `{{data_conclusao}}` | Quando completou | | `{{periodo_curso}}` | "Janeiro a Maio de 2026" |
🆔 Validação
| Variável | Conteúdo | |---|---| | `{{numero_certificado}}` | ID único (ex: ABC-12345) | | `{{url_validacao}}` | URL para validar online | | `{{qr_code_validacao}}` | QR code embutido | | `{{hash_validacao}}` | Hash criptográfico |
🏢 Sobre a plataforma / loja
| Variável | Conteúdo | |---|---| | `{{plataforma_nome}}` | Sua marca | | `{{plataforma_cnpj}}` | CNPJ | | `{{loja_nome}}` | Nome da loja específica | | `{{loja_endereco}}` | Endereço |
📊 Notas e desempenho (Pro+)
| Variável | Conteúdo | |---|---| | `{{nota_final}}` | Média final | | `{{aprovado_em_quizzes}}` | "X de Y quizzes" | | `{{aproveitamento_curso}}` | "% de conclusão" | | `{{ranking_turma}}` | "1º lugar entre 50 alunos" |
💡 Use desempenho com cuidado. Aluno com nota baixa pode não querer mostrar.
Como inserir variáveis
Editor visual
- Clique onde quer inserir
- Botão + Variável
- Selecione da lista
- Sistema insere `{{...}}` automaticamente
Edição manual
Se você prefere editar HTML/SVG direto, escreva exatamente:
``` {{aluno_nome}} ```
Atenção:
- ✅ 2 chaves abre, 2 chaves fecha
- ✅ Sem espaços dentro: `{{aluno_nome}}` (sem `{{ aluno_nome }}`)
- ✅ Letras minúsculas e underscores
Variáveis condicionais (Pro+)
Avançado: mostrar texto só se variável existe:
``` {{#if instrutor_nome}} Assinado pelo instrutor: {{instrutor_nome}} {{/if}} ```
Útil quando alguns cursos têm 1 instrutor e outros não.
Formatação especial
Datas
``` {{data_emissao}} → 02/05/2026 {{data_emissao_formato_extenso}} → 02 de maio de 2026 {{data_emissao_formato_iso}} → 2026-05-02 ```
Carga horária
``` {{carga_horaria}} → 40 {{carga_horaria_h}} → 40h {{carga_horaria_extenso}} → quarenta horas ```
Nome
``` {{aluno_nome}} → Maria Silva {{aluno_primeiro_nome}} → Maria {{aluno_nome_iniciais}} → M. S. {{aluno_nome_uppercase}} → MARIA SILVA ```
Variáveis customizadas (Enterprise)
Em Enterprise, criar variáveis próprias:
``` {{mentoria_realizada}} → Sim/Não {{horas_em_grupo}} → 12h {{projeto_final_nota}} → 9.5 ```
Configurável em Plataforma > Configurações > Custom Fields.
Boas práticas
✅ Faça
- Use variáveis para tudo personalizado (não escreva nome estático)
- Pré-visualize antes de aplicar
- Teste com 3 alunos diferentes (nomes longos/curtos)
- Documente quais variáveis você usa
❌ Não faça
- ❌ Variável errada (`{{nome}}` não existe; use `{{aluno_nome}}`)
- ❌ Espaço dentro (`{{ aluno_nome }}` quebra)
- ❌ CPF em certificado público sem necessidade (LGPD)
- ❌ Variável que não existe (vira texto literal)
Erros comuns
"Variável aparece literal `{{aluno_nome}}` no certificado"
- Variável escrita errada (verifique catálogo acima)
- Variável tem espaço dentro
- Aluno sem nome cadastrado (raro)
"Carga horária aparece como '0'"
- Curso sem carga configurada
- Variável errada (use `{{carga_horaria}}`, não `{{horas}}`)
"Data formato errado (ex: 'Mai 02, 2026')"
- Inglês? Mude formato em Configurações > Idioma
- Use variável com sufixo: `{{data_emissao_formato_extenso}}`
"Nome do instrutor não aparece"
- Curso sem instrutor configurado
- Use variável condicional: `{{#if instrutor}}{{instrutor}}{{/if}}`
"QR code não funciona"
- Variável `{{qr_code_validacao}}` ausente do template
- URL de validação alterada — não use links manuais
"Quero variável que mostra todas as aulas concluídas"
Avançado. Disponível em Enterprise via Custom Fields + integração de dados.
Próximos passos
- 📖 Temas de certificado
- 📖 Criar tema de certificado
- 📖 Tema padrão da plataforma
- 📖 Como funciona certificado
Foi útil este artigo? 👍 👎 Falar com CS (em produção) · Pergunte ao Vob 🤖 (em produção) Última atualização: 2026-05-02