Contact Support

Integração com Viva Engage (Legado)

Atualizado

This is a Legacy article. If you are using the current Awardco 2.0 Interface, please search for the updated version to ensure accuracy.

Através da integração do Awardco com o Viva Engage, as organizações podem compartilhar reconhecimentos públicos do Awardco dentro de suas comunidades de forma integrada. 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 ao Awardco. É necessário que um administrador do Microsoft 365 crie o usuário, garanta que o usuário tenha uma licença válida para acessar o Viva Engage e que você esteja logado como administrador do Awardco para conectar a conta do usuário bot ao 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 reconhecimentos para reconhecimentos pontuais no Viva Engage. No entanto, não suporta o envio de reconhecimentos diretamente pelo Viva Engage, não inclui reconhecimentos de programas automatizados, nem exibe 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 ao 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 depois clique em + Novo registro.
  4. Preencha os Detalhes do Registro:
    1. Nome: Dê um nome significativo (por exemplo, "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 [your-subdomain] pelo subdomínio da sua empresa https://[your-subdomain].awardco.com/viva-engage/auth.
  5. Registre o aplicativo.

 

Obter o ID do Cliente e o Segredo do Cliente

  1. Após o registro, você será direcionado para a página de Visão Geral do aplicativo. O ID da Aplicação (cliente) é o ID do Cliente. Salve este dado 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 é seu novo Segredo do Cliente, e você não poderá recuperá-lo depois de 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
    • Em Microsoft Graph
      • openid
      • profile
      • User.read
    • Em Yammer
      • user_impersonation
  4. Conceder Consentimento do 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 colocar o nome de exibição como “Reconhecimento Minha Empresa”.
  2. Forneça um nome de usuário e uma senha. Você também pode solicitar que a senha seja enviada por e-mail para você. Certifique-se de salvar o nome de usuário e a senha porque 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 porque 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/. Você pode querer fazer isso em uma janela anônima do seu navegador.
  2. Faça com que o usuário crie e/ou entre em quaisquer comunidades nas quais você deseja publicar reconhecimentos.

Uma forma opcional para administradores concederem permissões ao 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 status de Administrador Verificado.
     

Conectando o Aplicativo Viva Engage ao Awardco

Para conectar o aplicativo Viva Engage ao Awardco:

  1. Navegue até https://[you-subdomain].awardco.com/settings/integrations/viva-engage
  2. Clique em Iniciar Configuração
  3. Clique em Avançar
  4. Digite o ID do Cliente que você salvou anteriormente
  5. Digite o Segredo do Cliente que você salvou anteriormente
  6. Faça login com o bot que você quer que publique os reconhecimentos na nova página que abrir
  7. Clique em Continuar
  8. Selecione uma Comunidade na qual você 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 (ou seja. :

  1. Acesse as Configurações da Comunidade.
  2. Selecione um campo de metadados no qual basear as regras.
  3. Clique em “Adicionar Regra”.
  4. Selecione um ou mais valores de metadados.
  5. Selecione qual Comunidade Viva Engage você gostaria de postar 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. E se eu não vir nenhuma comunidade no Awardco?
    • Adicione o usuário bot a todas as comunidades nas quais você deseja publicar reconhecimentos
  2. E 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”
    • Garanta que a comunidade padrão esteja definida ou que as regras de metadados se apliquem ao destinatário do reconhecimento.
    • Verifique se você está visualizando a comunidade correta
    • Certifique-se de 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 do 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