Consulta de credenciais

A consulta de credenciais é uma busca pública das credenciais que a sua organização emitiu. Quem não tem o link nem o código QR de uma credencial, e só sabe o nome, o número de identificação ou o e-mail do titular, pode encontrá-la ali em vez de escrever para a sua equipe.

Ela é publicada em um ou dois lugares, você decide com quais dados se pode buscar e você decide o que cada resultado mostra.

A consulta de credenciais é um recurso premium. Se não estiver habilitado para a sua organização, a seção mostra "Este recurso ainda não está habilitado para a sua organização. Fale com o seu executivo de contas para ativá-lo."

Antes de publicá-la

Só aparecem as credenciais que o titular tornou públicas. A visibilidade é uma decisão do titular, não do emissor: cada pessoa a ativa para as próprias credenciais na sua conta da POK. Uma credencial que o titular mantém privada não é encontrada por nenhum campo de busca. É a surpresa mais comum logo depois de publicar a consulta, então leia A busca não encontra uma credencial antes de concluir que algo está quebrado.

Só aparecem as credenciais emitidas com a POK. Credenciais importadas de outro sistema ficam fora da consulta.

A sua organização é responsável pelos dados que expõe. Antes de salvar, você confirma que a sua organização é responsável legal pelos dados que ficam públicos e que tem o consentimento dos titulares. Recomendamos consultar o seu DPO conforme a lei aplicável (LGPD, GDPR).

Publique a busca

Você precisa de perfil de administrador ou operador. A opção "Configurações da organização" só aparece no menu para esses dois perfis.

1. Na barra de navegação superior, clique no nome da sua organização e depois em "Configurações da organização".

2. Abra a aba "Preferências" e localize "Consulta de credenciais" dentro de "Minhas preferências".

3. Clique em "Configurar".

4. Em "Onde você quer publicá-la?", escolha um canal ou os dois:

   • "Página da organização": uma seção de busca dentro do seu perfil na POK. Na sua página pública de organização aparece um link "Consultar uma credencial".
   • "iframe no seu site": a mesma busca embutida no seu próprio site. Esse canal precisa de um domínio autorizado.

5. Em "Campos de busca", escolha o que uma pessoa pode digitar para encontrar uma credencial: o nome e sobrenome do titular, o número de identificação ou o e-mail. Pelo menos um precisa continuar habilitado.

6. Em "Campos do resultado", escolha o que é mostrado publicamente em cada resultado: o nome e sobrenome do titular, o número de identificação, o e-mail, o título da credencial e o link para a credencial, que abre a mesma página pública de verificação para onde levam o link e o código QR dela.

7. Se você ativou o iframe, escreva o seu site em "Domínio autorizado" e clique em "Adicionar". Use um domínio https completo e sem caminho, por exemplo https://www.exemplo.edu. É possível autorizar até vinte domínios, que costuma ser o necessário quando se conta o domínio sem www, a versão com www e os microsites.

8. Leia o aviso de responsabilidade e aceite-o. Sem ele a configuração não pode ser salva.

9. Clique em "Salvar e publicar".

Nada é publicado até você salvar.

Insira a busca no seu próprio site

Ao salvar com o canal de iframe ativado, a POK mostra o código para inserir em "Código para inserir no seu site". Copie e cole em qualquer página do seu site, onde quiser que a busca apareça.

Você pode copiá-lo novamente quando precisar: abra "Configurar" em Minhas preferências e clique em "Ver código".

O iframe só carrega nos domínios que você autorizou. Se o código for colado em outro lugar, o navegador se recusa a exibi-lo, então a sua busca não pode aparecer sob a marca de terceiros.

O que quem consulta vê

A pessoa preenche os campos que você habilitou e recebe a resposta na hora.

• A correspondência é exata, embora ignore maiúsculas e acentos. "maria gonzalez" encontra "María González", e espaços repetidos não mudam nada. O que precisa coincidir é o conteúdo: um nome que a credencial guarda completo enquanto no buscador foi digitada só uma parte, ou um número de identificação com pontos ou hífens quando a credencial não os tem, não devolve nada. A busca nunca funciona por aproximação, então ninguém pode digitar algumas letras e percorrer as suas credenciais.

• Se mais de um campo for preenchido, todos precisam coincidir. É o que permite distinguir dois titulares com o mesmo nome.

• Cada resultado mostra o título da credencial, a data de emissão, o vencimento quando a credencial tem um, e o status, válida ou vencida. Além disso, são mostrados os campos que você escolheu em "Campos do resultado".

• Uma credencial revogada não aparece. Revogar uma credencial a tira da consulta, então a busca nunca devolve algo que a sua organização deu baixa.

• Uma busca muito ampla tem limite. Quando há mais coincidências do que a busca pode devolver, é pedido à pessoa que acrescente outro dado para restringi-la.

• Antes de cada busca roda uma verificação antibot automática, e os resultados não são indexados pelos mecanismos de busca.

Mude o que está publicado, ou pare de publicar

Abra "Configurar" de novo, mude o que precisar e salve. A mudança vale de imediato.

Para parar de publicá-la, desative os dois canais e clique em "Salvar". Sem nenhum canal selecionado, o botão deixa de dizer "Salvar e publicar". A busca deixa de responder, o link some da sua página de organização e qualquer iframe já colado em um site mostra um quadro vazio.

A busca não encontra uma credencial

Verifique estes pontos em ordem:

1. O titular não tornou a credencial pública. É a causa mais comum, sobretudo logo depois de publicar a consulta. A visibilidade é definida por cada titular na própria conta, então um catálogo de credenciais emitidas antes de publicar a consulta começa quase invisível. Vale avisar aos seus titulares que esse controle existe e para que serve.

2. O dado não coincide com a credencial. Maiúsculas, acentos e espaços a mais são ignorados, então o problema não está aí. Um nome que a credencial guarda completo enquanto no buscador foi digitada só uma parte, ou um número de identificação com pontos ou hífens quando a credencial não os tem, já bastam para a busca não devolver nada.

3. Mais de um campo foi preenchido. Todos precisam coincidir ao mesmo tempo. Buscar por um único dado é a forma de descartar isso.

4. A credencial foi importada, não emitida com a POK. Credenciais importadas ficam fora da consulta.

5. A credencial foi revogada. Credenciais revogadas são retiradas da consulta de propósito.

O iframe mostra um quadro vazio

1. O domínio não está autorizado. O domínio em "Domínio autorizado" precisa coincidir com o site onde o código está colado, incluindo https:// e o host exato. https://exemplo.edu e https://www.exemplo.edu são dois domínios diferentes, então autorize os dois se usar os dois.

2. A busca não está publicada. Se os dois canais foram desativados, um iframe já colado em uma página deixa de carregar.