Acessar conteúdo hospedado em outro sistema (sem novo login)

Um treinamento que fica em outra plataforma pode ser aberto de dentro da Engage, sem o usuário digitar credenciais de novo. A Engage entrega os dados da sessão para uma página sua, e essa página faz o login no seu sistema. Este artigo mostra como montar essa página e como devolver a nota para a Engage.

Antes de começar

• Este passo é de desenvolvimento front-end (HTML e JavaScript), não de API. Quando o seu servidor precisar chamar a API, as credenciais estão em Comece por aqui: credenciais para integrar com a API da Engage.
• O template de atividade customizada atualizado, que você pede ao Suporte em meajuda@engage.bz.
• Uma forma de o seu sistema reconhecer o usuário: a Engage entrega o login e o e-mail do usuário logado, e um dos dois precisa existir também no seu lado.
• Monte e teste na instância de homologação; publique em produção só depois de validado.

Montar a atividade

1Prepare o template

1. Descompacte o template e abra o index.html.
2. Implemente a sua lógica de login no ponto indicado pelos comentários do arquivo.
3. Compacte de novo em .zip, com o index.html na raiz.

2Crie a atividade na Engage

1. Na área administrativa, crie uma atividade do tipo Customizada e salve. O campo Arquivo é habilitado.
2. Clique em Importar, envie o .zip, atualize a biblioteca de mídia e selecione o index.html.
3. Na aba Avançado, preencha o Código externo com o ID do treinamento no seu sistema.
4. Vincule a atividade a um módulo e teste com um usuário comum.

3Converse com o player

A sua página roda dentro de um iframe do player e troca mensagens com ele por postMessage. O corpo é uma string JSON com message e, quando houver, param:

Envie as solicitações só depois do load da página.

Devolver a nota para a Engage

Há duas formas, e só uma precisa de integração no servidor:

• Dentro da sessão (recomendado): quando o usuário termina com a página aberta, ela envia setAnswer com o score. Não precisa de webhook.
• Fora da sessão: quando a conclusão acontece depois (correção manual, processamento em lote), o seu sistema envia o resultado para a Engage pela API, e é aí que um webhook do seu lado faz sentido.

Cuidados

• login e email são dado pessoal. Não grave em console, não coloque em URL nem em localStorage. Se precisar registrar o acesso, registre no seu servidor.
• Não coloque segredo no index.html. O arquivo vai para o navegador do usuário. Chamada que use client_secret ou token de servidor fica no seu back-end.
• Não dependa de número de linha do template. Ele muda a cada versão; use os comentários do arquivo como referência.
• A mesma página roda no navegador e no aplicativo da Engage.
• Teste com um usuário comum. Testar só com administrador esconde erros de permissão e de vínculo de trilha.

Problemas comuns