Contact Support

Integração com Viva Engage

Atualizado

 

 

 


Através da integração da Awardco com o Viva Engage, as organizações podem compartilhar facilmente reconhecimentos públicos da Awardco dentro de suas comunidades. Para isso, você precisará criar um usuário bot, adicionar esse usuário a quaisquer comunidades onde deseja que os reconhecimentos sejam publicados, criar um aplicativo Viva Engage para personificar esse usuário e conectar esse aplicativo à Awardco. É necessário ter um administrador do Microsoft 365 para criar o usuário, garantir que o usuário tenha uma licença válida para acessar o Viva Engage e estar logado como administrador da Awardco para conectar a conta do usuário bot à Awardco. Siga os passos descritos no artigo abaixo para configurar a integração com sucesso.

Nota: Esta integração permite que você visualize o feed de reconhecimento para reconhecimentos pontuais no Viva Engage. No entanto, ela não suporta o envio de reconhecimentos diretamente pelo Viva Engage, incluindo reconhecimentos de programas automatizados, nem a exibição de imagens e vídeos no feed.

 

  1. Registrar um Aplicativo no Microsoft Entra ID
  2. Obter o ID do Cliente e o Segredo do Cliente
  3. Configurar Permissões da API
  4. Criar um Usuário Bot
  5. Adicionar um Usuário Bot a uma Comunidade
  6. Conectar o Aplicativo Viva Engage à Awardco
  7. Configurar Metadados para Publicação de Reconhecimentos
  8. Perguntas Frequentes (FAQ)

 

 Registrar um Aplicativo no Microsoft Entra ID

  1. Um administrador do Microsoft 365 (ou alguém com as permissões apropriadas, como Desenvolvedor de Aplicações ou Administrador de Aplicações em Nuvem) precisa fazer login no Portal Microsoft Azure (http://portal.azure.com).
  2. Selecione Microsoft Entra ID (ou pesquise por ele).
  3. Em Gerenciar, selecione Registros de aplicativos e, em seguida, clique em + Novo registro.
  4. Preencha os Detalhes do Registro:
    1. Nome: Dê um nome significativo (ex.: "Integração Awardco Viva Engage").
    2. Tipos de conta suportados: Selecione "Contas neste diretório organizacional somente" (inquilino único).
    3. URI de redirecionamento: Insira o seguinte substituindo [seu-subdomínio] pelo https://[seu-subdomínio].awardco.com/viva-engage/auth da sua empresa.
  5. Registre o aplicativo.

Obter o ID do Cliente e o Segredo do Cliente

  1. Após o registro, você será levado para a página Visão geral do aplicativo. O ID do Aplicativo (cliente) é o ID do Cliente. Salve-o para uso posterior.
  2. Segredo do Cliente: Na navegação à esquerda, vá para Certificados e segredos. Clique em + Novo segredo do cliente, dê uma descrição, selecione um tempo de expiração e clique em Adicionar. COPIE IMEDIATAMENTE o Valor do segredo.
    • Nota: Este é o seu novo Segredo do Cliente, e você não poderá recuperá-lo após sair desta página.

Configurar Permissões da API

  1. Na navegação à esquerda, vá para Permissões da API.
  2. Clique em + Adicionar uma permissão.
  3. Adicione as seguintes permissões
    • Sob Microsoft Graph
      • openid
      • profile
      • User.read
    • Sob Yammer
      • user_impersonation
  4. Conceder Consentimento de Administrador: Após adicionar a permissão, um administrador deve clicar em Conceder consentimento de administrador para [Sua Organização]

Criando um Usuário Bot

Para criar seu usuário bot para publicar reconhecimentos:

  1. Faça login no Centro de Administração do Microsoft 365 como administrador do Microsoft 365. https://admin.microsoft.com/Adminportal/Home#/users
  2. Clique em “Adicionar um usuário”.

  

 

  1. Nomeie o usuário como desejar. Por exemplo, você pode definir o nome de exibição como “Reconhecimento Minha Empresa”.
  2. Defina um nome de usuário e uma senha. Você também pode optar por receber a senha por e-mail. Certifique-se de salvar o nome de usuário e a senha, pois você precisará deles mais tarde!
  3. Selecione uma licença para conceder ao usuário. Certifique-se de que o usuário tenha acesso ao Viva Engage.
  4. Você pode pular as configurações opcionais, a menos que queira fazer alguma edição.
  5. Revise as informações e, se estiverem corretas, clique em “Concluir adição”.
  6. Certifique-se de salvar o nome de usuário e a senha, pois você precisará deles mais tarde!

Adicionando um Usuário Bot a uma Comunidade

  1. Use o novo usuário bot para fazer login no Viva Engage https://web.yammer.com/. Pode ser interessante fazer isso em uma janela anônima do seu navegador.
  2. Faça com que o usuário crie e/ou participe de quaisquer comunidades nas quais deseja postar reconhecimentos.

Uma forma opcional para administradores concederem permissões de bot para postar em qualquer comunidade:

  1. Faça login no Viva Engage (Yammer) como administrador global.
  2. Vá para o Centro de Administração do Yammer (Configurações > Administrador da Rede).
  3. Selecione Administradores no menu.
  4. Encontre seu usuário Bot.
  5. Conceda a ele o status de Administrador Verificado.
     

Conectando o Aplicativo Viva Engage à Awardco

Para conectar o aplicativo Viva Engage à Awardco:

  1. Navegue até https://[seu-subdomínio].awardco.com/settings/integrations/viva-engage
  2. Selecione o botão Admin na parte inferior do menu de navegação à esquerda.
  3. Selecione “Plataforma”, depois “Integrações”, e clique na Biblioteca de Integrações dentro do portal de administração.
  4. Encontre e selecione "Microsoft Viva Engage"
  5. Clique em Iniciar Configuração
  6. Clique em Avançar
  7. Digite o ID do Cliente que você salvou anteriormente
  8. Digite o Segredo do Cliente que você salvou anteriormente
  9. Faça login com o bot que você deseja que publique os reconhecimentos na nova página que abrir
  10. Clique em Continuar
  11. Selecione uma Comunidade na qual deseja que o bot publique
     

Configurando Metadados para Publicação de Reconhecimentos

Para configurar Regras de Metadados para que usuários de diferentes locais ou departamentos possam ver reconhecimentos relacionados a pessoas que conhecem (ex.:

  1. Acesse Configurações da Comunidade.
  2. Selecione um campo de metadados para basear as regras.
  3. Clique em “Adicionar Regra”.
  4. Selecione um ou mais valores de metadados.
  5. Selecione qual Comunidade Viva Engage você gostaria que publicasse reconhecimentos para esses valores de metadados.
  6. Clique em “Salvar Regra”.
  7. Continue adicionando e salvando regras conforme necessário.
  8. Você pode desativar a “Comunidade Padrão” se não quiser que reconhecimentos sejam publicados para usuários que não tenham um dos valores de metadados listados.



 

Perguntas Frequentes (FAQ)

  1. O que fazer se eu não vir comunidades na Awardco?
    • Adicione o usuário bot a todas as comunidades nas quais deseja postar reconhecimentos
  2. O que fazer se os reconhecimentos não forem publicados no Viva Engage?
    • Certifique-se de que a integração não esteja pausada em “Pausar Integração”
    • Verifique se a comunidade padrão está definida ou se as regras de metadados se aplicam ao destinatário do reconhecimento.
    • Confira se você está visualizando a comunidade correta
    • Garanta que os reconhecimentos sejam públicos.
  3. Posso personalizar como os reconhecimentos aparecem no Viva Engage?
    • Devido às limitações da API do Viva Engage, não podemos formatar o texto do reconhecimento nem permitir qualquer personalização.
  4. Comentários e reações no Viva Engage aparecerão no feed da Awardco?
    • Não, isso não é possível atualmente.
  5. Posso conectar o SharePoint com o Viva Engage para mostrar reconhecimentos?






 

If you have any questions, please contact Awardco Admin Support.

Relacionado com