Skip to content

Criando distintivos

Um distintivo é um modelo de credencial que descreve uma conquista, habilidade ou certificação. Cada distintivo pertence a um emissor verificado e pode ser concedido a vários destinatários. Os distintivos seguem a especificação BadgeClass do Open Badge v2.0.

Lista de distintivos com um distintivo Developer Associate

Criando um novo distintivo

  1. Abra a página Distintivos na barra lateral.
  2. Clique em Criar distintivo. O modal em tela cheia abre com o designer à esquerda e o formulário à direita:

Criar distintivo — canvas vazio e barra lateral 3. Selecione o emissor que vai conceder este distintivo. Apenas emissores verificados são exibidos. 4. Preencha os campos obrigatórios:

CampoObrigatórioDescrição
NomeSimTítulo do distintivo (ex.: "Certificado em Cloud Architecture")
DescriçãoSimO que o distintivo representa
CritériosSimO que o destinatário fez para obtê-lo
ImagemSimImagem do distintivo — use o designer ou envie a sua
  1. Clique em Criar distintivo.

A imagem do distintivo é enviada ao IPFS para armazenamento descentralizado e permanente. O distintivo está pronto para ser concedido.

Ver detalhes do distintivo

Clique em qualquer cartão de distintivo para abrir a visualização de detalhes — o mesmo popup usado para edição, permitindo inspecionar e modificar no mesmo lugar:

Detalhe do distintivo — Developer Associate

A visualização de detalhes mostra:

  • Nome, descrição e critérios do distintivo
  • O emissor a que pertence
  • Imagem do distintivo (armazenada no IPFS)
  • Texto de compartilhamento (veja abaixo)

Editando um distintivo

Criação e edição usam o mesmo popup, então editar é idêntico a criar:

  1. Clique no distintivo na lista.
  2. O editor completo abre — você pode alterar:
    • Nome — o título do distintivo
    • Descrição — o que representa
    • Critérios — os requisitos para obtê-lo
    • Imagem — abra o Designer de distintivos ou envie uma nova imagem (a imagem IPFS anterior continua acessível pelo CID, então concessões existentes mantêm a arte original)
    • Texto de compartilhamento (veja abaixo)
  3. Clique em Atualizar distintivo.

Distintivos já concedidos também podem ser editados. Quando um distintivo já tem concessões, o editor abre com um aviso âmbar explicando que suas alterações se aplicam somente às concessões futuras — cada concessão já emitida embute um instantâneo do distintivo tal como estava no momento da emissão, então os destinatários nunca veem mudanças retroativas na credencial. (O emissor fica bloqueado assim que o distintivo existe.)

Texto de compartilhamento

Cada distintivo tem um texto de compartilhamento padrão, exibido aos destinatários na página pública de compartilhamento e usado como mensagem pré-preenchida quando eles compartilham sua concessão no LinkedIn, X, Facebook, WhatsApp, Telegram ou por e-mail. É possível personalizá-lo no mesmo popup do restante do distintivo:

  • Apenas texto simples — tags HTML são rejeitadas.

  • Mantenha curto (cerca de 200 caracteres) para caber nos limites das redes sociais.

  • O campo é preenchido com este modelo padrão quando você cria um distintivo:

    text
    Excited to share that I just received the "{{badge_name}}" certification!
    
    Thanks to {{issuer_name}} for this awesome recognition.
    
    {{award_url}}

Placeholders

O texto de compartilhamento aceita tokens que o backend substitui por destinatário no momento do compartilhamento (nunca no editor). Clique em + Inserir placeholder acima do campo para inserir um token na posição do cursor:

TokenSubstituído por
O nome do destinatário
O nome do distintivo
O nome do emissor
A data de emissão
A URL pública da concessão

Ao criar um distintivo, um link Restaurar modelo padrão recupera o texto padrão caso você o tenha editado.

Dicas

  • O nome primeiro, o design depois — dê ao distintivo um nome claro para que ele se destaque no portal do destinatário e na página pública de verificação.
  • Os critérios vendem o distintivo — destinatários (e verificadores) leem esse campo para entender o que foi realmente conquistado.
  • Um distintivo, várias concessões — desenhe uma vez e conceda a milhares. Use Concessões em massa quando tiver um CSV de destinatários.

Excluir um distintivo

  1. Clique no distintivo que deseja excluir.
  2. Clique em Excluir no editor.
  3. Confirme a exclusão.

Um distintivo só pode ser excluído se não tiver concessões. Se houver concessões, o diálogo de confirmação não aparece — em vez disso, um erro vermelho inline informa que o distintivo ainda tem concessões emitidas e não pode ser excluído ainda. Para remover esse distintivo, apague primeiro suas concessões na página Concessões (revogue ou exclua cada concessão), depois volte aqui para excluir o distintivo. Ou simplesmente mantenha o distintivo — guardar não tem custo.

badges.ninja Documentation