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 emitido para vários destinatários. Os distintivos seguem a especificação Open Badge v2.0 BadgeClass.

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 de criação em tela cheia é aberto, com o designer à esquerda e o formulário na barra lateral à direita:

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

CampoObrigatórioDescrição
NomeSimTítulo do distintivo (por exemplo, "Cloud Architecture Certified")
DescriçãoSimO que o distintivo representa
CritériosSimO que o destinatário fez para conquistar este distintivo
ImagemSimImagem do distintivo — use o Designer de distintivos ou envie a sua
  1. Clique em Criar distintivo.

A imagem do distintivo é enviada para uma hospedagem permanente com CDN. O distintivo já está pronto para ser emitido.

Visualizando os detalhes do distintivo ​

Clique em qualquer cartão de distintivo para abrir a visualização de detalhes — o mesmo pop-up usado para edição, de modo que você pode inspecionar e modificar em um só lugar:

Detalhes do distintivo — Developer Associate

A visualização de detalhes mostra:

  • Nome, descrição e critérios do distintivo
  • O emissor ao qual ele pertence
  • A imagem do distintivo (hospedada permanentemente)
  • O texto de compartilhamento (veja abaixo)

Editando um distintivo ​

A criação e a edição de distintivos usam o mesmo pop-up, então editar é exatamente como criar:

  1. Clique no distintivo na lista.
  2. O editor completo é aberto — altere qualquer um destes itens:
    • Nome — o título do distintivo
    • Descrição — o que o distintivo representa
    • Critérios — os requisitos para conquistá-lo
    • Imagem — abra o Designer de distintivos ou envie uma nova imagem (a imagem anterior continua acessível na sua URL, então as credenciais existentes continuam mostrando a arte original)
    • Texto de compartilhamento (veja abaixo)
  3. Clique em Atualizar distintivo.

Distintivos com credenciais também podem ser editados. Quando um distintivo já tem credenciais, o editor abre com um banner âmbar explicando que suas alterações valem apenas para as credenciais futuras — cada credencial já emitida incorpora um instantâneo do distintivo como ele era no momento da emissão, então os destinatários nunca veem uma credencial mudar depois do fato. (O emissor fica bloqueado depois que o distintivo é criado.)

Texto de compartilhamento ​

Todo 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 a credencial no LinkedIn, X, Facebook, WhatsApp, Telegram ou por e-mail. Você pode personalizá-lo no mesmo pop-up do restante do distintivo:

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

  • Seja breve (cerca de 200 caracteres) para caber nos limites de postagem das redes sociais.

  • O campo vem 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 para cada 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 credencial

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

Dicas ​

  • Primeiro o nome, depois o design — dê ao distintivo um nome claro para que ele apareça bem 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 este campo para entender o que foi realmente conquistado.
  • Um distintivo, muitas credenciais — crie uma vez e emita para milhares. Use Credenciais em massa quando tiver um CSV de destinatários.

Excluindo um distintivo ​

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

Um distintivo só pode ser excluído se não tiver credenciais. Se houver credenciais, a caixa de confirmação não aparece — em vez disso, um erro vermelho em linha informa que o distintivo ainda tem credenciais emitidas e não pode ser excluído por enquanto. Para remover esse distintivo, primeiro elimine as credenciais dele na página Credenciais (revogue ou exclua cada uma) e depois volte aqui para excluir o distintivo. Ou simplesmente deixe o distintivo onde está — mantê-lo não custa nada.

badges.ninja Documentation