Pular para o conteúdo principal

Integrar o POK com o Sana

Integrar o POK Proof of Knowledge com o Sana permite emitir credenciais automaticamente quando uma pessoa conclui um curso. Você registra a integração no painel do POK, conecta o POK ao seu espaço do Sana e escolhe quais cursos emitem qual credencial. A partir desse momento, sempre que o Sana informa que um curso foi concluído, o POK emite a credencial configurada para essa pessoa, sem nenhuma etapa manual.

A conexão tem duas direções, e cada uma usa suas próprias credenciais:

  • POK lendo do Sana: o POK chama a API do Sana para localizar a pessoa que concluiu o curso. Usa as credenciais de API criadas no painel do Sana.
  • Sana notificando o POK: o Sana envia cada conclusão ao POK. Usa as credenciais de conexão que o POK fornece.

As etapas a seguir cobrem as duas direções.

Iniciar a integração pelo POK​

  1. Acesse a seção Integrações dentro do painel do POK.
  2. Na lista de plataformas disponíveis, selecione Sana.
  3. Atribua um nome que identifique a integração (por exemplo, "Sana 2026").
  4. Insira as credenciais do seu espaço do Sana:
    • URL do tenant do Sana: o endereço do Sana, por exemplo https://suaempresa.sana.ai.
    • Client ID e Client Secret: as credenciais de API OAuth2 criadas no Sana (veja abaixo).
  5. Salve a integração.

Caixa de diálogo de nova integração no POK com o formulário do Sana: nome da integração, URL do tenant do Sana, Client ID e Client Secret

dica

O Client ID e o Client Secret vêm do cliente de API criado nas configurações de administrador do Sana. Se ainda não os tiver, crie primeiro um cliente de API no Sana e depois volte a este formulário.

Solicitar as credenciais de conexão ao POK​

Para que o Sana possa notificar o POK sobre as conclusões de curso, o POK fornece um conjunto de credenciais de conexão dedicadas. Depois de criar a integração, o POK indica como solicitá-las.

Escreva para contact@pok.tech para solicitar as credenciais de conexão do Sana. O POK enviará:

  • Um Client ID e um Client Secret (emitidos pelo POK, diferentes dos do Sana).
  • A URL de token e a URL de statements que o Sana precisa para alcançar o POK.

Configurar a integração no Sana​

No Sana, configure a integração xAPI que envia os statements de conclusão ao POK, usando os valores que o POK enviou:

  1. Abra as configurações do seu espaço do Sana e adicione uma integração xAPI.
  2. Insira a URL de statements fornecida pelo POK como endpoint.
  3. Em autenticação, escolha OAuth2 client credentials e insira a URL de token, o Client ID e o Client Secret fornecidos pelo POK.
  4. Defina o tipo de ator (Actor type) como account. É obrigatório: com qualquer outro tipo de ator a conclusão chega sem o identificador da pessoa e o POK não consegue emitir a credencial.
  5. Salve a integração no Sana.

Formulário de integração xAPI do Sana com o Token URL, o Statements URL, o Client ID e o Client Secret de OAuth2, e o Actor type em Account

aviso

O tipo de ator deve ser account. É o único ajuste do lado do Sana que, se ficar errado, impede a emissão das credenciais sem dar aviso.

Escolher quais cursos emitem credencial​

De volta ao POK, defina quais dos seus cursos do Sana emitem uma credencial e como cada uma aparece.

  1. Abra a integração do Sana pela seção Integrações.
  2. Procure o curso que quer configurar e selecione-o.
  3. Complete a configuração da credencial:
    • Selecione o design da credencial.
    • Vincule uma página personalizada e uma trilha de aprendizagem (opcional).
    • Defina se a credencial tem data de expiração.
    • Mapeie os atributos personalizados do design com os dados da pessoa.
    • Escolha o tipo de credencial: básica ou blockchain.
    • Defina o idioma do e-mail que a pessoa receberá.
  4. Salve a configuração.

Página de configuração de credencial por curso no POK com o seletor de curso e o formulário da credencial

Um visto verde marca cada curso que já tem uma credencial configurada. Somente os cursos configurados emitem credenciais; as conclusões de qualquer outro curso são ignoradas.

Para parar de emitir em um curso, abra-o novamente e exclua a sua configuração.

Como funciona a emissão​

Assim que um curso está configurado e a integração do Sana está conectada, a emissão é automática:

  1. Uma pessoa conclui o curso no Sana.
  2. O Sana informa a conclusão ao POK.
  3. O POK localiza a pessoa no Sana e emite a credencial configurada.
  4. A pessoa recebe um e-mail com o link para aceitar a sua credencial.

Não é necessária nenhuma ação manual para cada pessoa. Se chegar uma conclusão de um curso que você não configurou, o POK simplesmente a ignora.

Em caso de dúvida, escreva para contact@pok.tech

Saiba mais​

Para ver como as integrações do POK se conectam ao seu LMS e a outros sistemas, confira a página do recurso de integrações LMS e CRM.