Procedimentos de Integração para Acesso a Conteúdos Hospedados em Sistemas de Terceiros

Pré-requisitos

• Este tutorial é destinado a profissionais técnicos (desenvolvedores de sistemas e correlatos) que tenham conhecimentos de programação, principalmente com a linguagem Javascript, e de integrações entre sistemas.
• De modo que a experiência do usuário seja a mais fluida possível, é necessário que o sistema terceiro, onde o conteúdo está hospedado, possua Webhooks - de modo que o aproveitamento do usuário possa ser enviado desta plataforma, automaticamente, para a Engage, no momento que o usuário finalizar o treinamento. Para maiores informações de como carregar o aproveitamento do usuário na Engage, consulte a documentação disponível aqui.

Em algumas situações, clientes possuem treinamentos ou conteúdo hospedados em alguma plataforma terceira, ou seja, fora do ambiente da Engage, e deseja que o usuário acesse este conteúdo nesta plataforma de modo que ele não precise informar suas credenciais novamente - melhorando a sua experiência de navegação. 

Para isso, a plataforma Engage disponibiliza um template de atividade customizada, disponível aqui, onde é possível obter, através do recurso de PostMessage, dados da sessão do usuário logado para a realização do SSO. 

Para utilizar este template, siga os seguintes passos:

1. Primeiramente, baixe o template da atividade customizada clicando aqui;
2. Descompacte o arquivo e abra o arquivo index.html;
3. Na linha 113 deste arquivo, implemente o algoritmo necessário para realização do SSO na plataforma, conforme exemplificado abaixo: Importante: Lembrando que para o SSO funcionar corretamente é necessário que o ID de login do usuário na plataforma de origem seja o mesmo da utilizada na Engage, ou seja, se na Engage for o e-mail na outra plataforma também deverá ser.
4. Uma vez implementada a lógica do SSO na index.html compacte-o em um arquivo .zip;
5. Crie uma atividade do tipo Customizada na Engage e salve-a. Será habilitado o campo Arquivo. Clique no botão Importar, selecione o arquivo desejado e clique em enviar;
6. Na aba media library clique no botão atualizar;
7. Selecione o arquivo index.html;
8. No campo Arquivo deverá ser exibido o nome index.html;
9. Informe no código externo da atividade - disponível na aba avançado - o ID do treinamento no sistema terceiro de modo a fazer o De-Para da atividade na Engage com o treinamento;
10. Clique em confirmar;
11. Para testar a sua atividade customizada, crie um novo módulo ou vincule-a algum módulo já existente.
12. Ao clicar no botão acessar, como mostrado na tela abaixo, SSO ocorrerá e o usuário acessará o conteúdo na plataforma terceira.
    Nota: Essa integração, uma vez construída, rodará tanto no browser quanto no app da Engage.

IMPORTANTE

• O template disponibilizado neste tutorial é utilizado apenas para a realização do SSO, ficando o cliente/desenvolvedor responsável pela implementação do envio automático, através deWebhook, do aproveitamento obtido pelo usuário na plataforma terceira, conforme descrito nos pré-requisitos deste documento.
• Para cada treinamento no sistema terceiro será necessário criar uma atividade customizada na Engage de modo a fazer o De-Para do conteúdo entre as duas plataformas.