Grâce à l'intégration d'Awardco avec Viva Engage, les organisations peuvent partager sans effort les reconnaissances publiques d'Awardco au sein de leurs communautés. Pour ce faire, vous devrez créer un utilisateur bot, ajouter cet utilisateur à toutes les communautés où vous souhaitez publier des reconnaissances, créer une application Viva Engage pour usurper l'identité de cet utilisateur, et connecter cette application à Awardco. Vous devez disposer d'un administrateur Microsoft 365 pour créer l'utilisateur, vous assurer que l'utilisateur dispose d'une licence valide pour accéder à Viva Engage, et être connecté en tant qu'administrateur Awardco pour connecter le compte de l'utilisateur bot à Awardco. Suivez les étapes décrites dans l'article ci-dessous pour configurer l'intégration avec succès.

Note : Cette intégration vous permet de voir le fil de reconnaissance pour les reconnaissances ponctuelles dans Viva Engage. Cependant, elle ne prend pas en charge l'envoi direct de reconnaissances via Viva Engage, y compris les reconnaissances issues de programmes automatisés, ni l'affichage d'images et de vidéos dans le fil.

 

1. Enregistrer une application dans Microsoft Entra ID
2. Obtenir l'ID client et le secret client
3. Configurer les autorisations API
4. Créer un utilisateur bot
5. Ajouter un utilisateur bot à une communauté
6. Connecter l'application Viva Engage à Awardco
7. Configurer les métadonnées pour la publication des reconnaissances
8. Foire aux questions (FAQ)

 Enregistrer une application dans Microsoft Entra ID

1. Un administrateur Microsoft 365 (ou une personne disposant des autorisations appropriées, comme Développeur d'applications ou Administrateur d'applications cloud) doit se connecter au portail Microsoft Azure (http://portal.azure.com).
2. Sélectionnez Microsoft Entra ID (ou recherchez-le).
3. Sous Gérer, sélectionnez Inscriptions d'applications, puis cliquez sur + Nouvelle inscription.
4. Remplissez les détails de l'inscription :
   1. Nom : Donnez-lui un nom significatif (par exemple, « Intégration Awardco Viva Engage »).
   2. Types de comptes pris en charge : Sélectionnez « Comptes dans ce répertoire organisationnel uniquement » (locataire unique).
   3. URI de redirection : Saisissez ce qui suit en remplaçant [your-subdomain] par le sous-domaine de votre entreprise https://[your-subdomain].awardco.com/viva-engage/auth.
5. Enregistrez l'application.

Obtenir l'ID client et le secret client

1. Une fois l'application enregistrée, vous serez dirigé vers la page Vue d'ensemble de l'application. L'ID d'application (client) est l'ID client. Conservez-le pour plus tard.
2. Secret client : Dans la navigation de gauche, allez dans Certificats et secrets. Cliquez sur + Nouveau secret client, donnez-lui une description, sélectionnez une durée d'expiration, puis cliquez sur Ajouter. Copiez IMMÉDIATEMENT la valeur du secret.
   • Note : Ceci est votre nouveau secret client, et vous ne pourrez pas le récupérer après avoir quitté cette page.

Configurer les autorisations API

1. Dans la navigation de gauche, allez dans Autorisations API.
2. Cliquez sur + Ajouter une autorisation.
3. Ajoutez les autorisations suivantes
   • Sous Microsoft Graph
     • openid
     • profile
     • User.read
   • Sous Yammer
     • user_impersonation
4. Accorder le consentement administrateur : Après avoir ajouté l'autorisation, un administrateur doit cliquer sur Accorder le consentement administrateur pour [Votre organisation]

Créer un utilisateur bot

Pour créer votre utilisateur bot qui publiera les reconnaissances :

1. Connectez-vous au Centre d'administration Microsoft 365 en tant qu'administrateur Microsoft 365. https://admin.microsoft.com/Adminportal/Home#/users
2. Cliquez sur « Ajouter un utilisateur ».

3. Nommez l'utilisateur comme vous le souhaitez. Par exemple, vous pourriez nommer son affichage « Reconnaissance Ma Compagnie ».
4. Attribuez-lui un nom d'utilisateur et un mot de passe. Vous pouvez également demander que le mot de passe vous soit envoyé par courriel. Assurez-vous de sauvegarder le nom d'utilisateur et le mot de passe, car vous en aurez besoin plus tard !
5. Sélectionnez une licence pour cet utilisateur. Assurez-vous que l'utilisateur a accès à Viva Engage.
6. Vous pouvez ignorer les paramètres optionnels à moins que vous ne souhaitiez effectuer des modifications.
7. Vérifiez les informations et, si elles sont correctes, cliquez sur « Terminer l'ajout ».
8. Assurez-vous de sauvegarder le nom d'utilisateur et le mot de passe, car vous en aurez besoin plus tard !

Ajouter un utilisateur bot à une communauté

1. Utilisez le nouvel utilisateur bot pour vous connecter à Viva Engage https://web.yammer.com/. Vous voudrez peut-être le faire dans une fenêtre de navigation privée de votre navigateur.
2. Faites en sorte que l'utilisateur crée et/ou rejoigne toutes les communautés dans lesquelles vous souhaitez publier des reconnaissances.

Une façon optionnelle pour les administrateurs de donner les permissions de bot pour publier dans n'importe quelle communauté :

1. Connectez-vous à Viva Engage (Yammer) en tant qu'administrateur global.
2. Accédez au Centre d'administration Yammer (Paramètres > Administrateur du réseau).
3. Sélectionnez Administrateurs dans le menu.
4. Trouvez votre utilisateur bot.
5. Attribuez-lui le statut d'administrateur vérifié.
    

Connecter l'application Viva Engage à Awardco

Pour connecter l'application Viva Engage à Awardco :

1. Accédez à https://[your-subdomain].awardco.com/settings/integrations/viva-engage
2. Sélectionnez le bouton Admin en bas du menu de navigation de gauche.
3. Sélectionnez « Plateforme », puis « Intégrations », puis cliquez dans la Bibliothèque d'intégrations au sein du portail administrateur.
4. Trouvez et sélectionnez « Microsoft Viva Engage »
5. Cliquez sur Commencer la configuration
6. Cliquez sur Suivant
7. Entrez l'ID client que vous avez sauvegardé précédemment
8. Entrez le secret client que vous avez sauvegardé précédemment
9. Connectez-vous au bot que vous souhaitez utiliser pour publier les reconnaissances dans la nouvelle page qui s'ouvre
10. Cliquez sur Continuer
11. Sélectionnez une communauté dans laquelle vous souhaitez que le bot publie
     

Configurer les métadonnées pour la publication des reconnaissances

Pour configurer les règles de métadonnées afin que les utilisateurs de différents emplacements ou départements puissent voir les reconnaissances concernant des personnes qu'ils connaissent (c.-à-d. :

1. Accédez aux paramètres de la communauté.
2. Sélectionnez un champ de métadonnées sur lequel baser les règles.
3. Cliquez sur « Ajouter une règle ».
4. Sélectionnez une ou plusieurs valeurs de métadonnées.
5. Sélectionnez la communauté Viva Engage dans laquelle vous souhaitez publier les reconnaissances pour ces valeurs de métadonnées.
6. Cliquez sur « Enregistrer la règle ».
7. Continuez à ajouter et enregistrer des règles selon vos besoins.
8. Vous pouvez désactiver la « Communauté par défaut » si vous ne souhaitez pas que des reconnaissances soient publiées pour les utilisateurs qui ne possèdent pas l'une des valeurs de métadonnées listées.

Foire aux questions (FAQ)

1. Que faire si je ne vois aucune communauté dans Awardco ?
   • Ajoutez l'utilisateur bot à toutes les communautés dans lesquelles vous souhaitez publier des reconnaissances
2. Que faire si les reconnaissances ne sont pas publiées dans Viva Engage ?
   • Assurez-vous que l'intégration n'est pas mise en pause dans « Mettre l'intégration en pause »
   • Vérifiez que la communauté par défaut est définie ou que les règles de métadonnées s'appliquent pour le destinataire de la reconnaissance.
   • Vérifiez que vous regardez la bonne communauté
   • Assurez-vous que les reconnaissances sont publiques.
3. Puis-je personnaliser l'apparence des reconnaissances dans Viva Engage ?
   • En raison des limitations de l'API Viva Engage, nous ne pouvons pas formater le texte des reconnaissances ni permettre de personnalisation.
4. Les commentaires et réactions dans Viva Engage apparaîtront-ils dans le fil Awardco ?
   • Non, ce n'est pas possible pour le moment.
5. Puis-je connecter SharePoint avec Viva Engage pour afficher les reconnaissances ?
   • Vous pouvez configurer cela en suivant les étapes de notre article d'assistance Afficher la reconnaissance dans SharePoint en utilisant l'intégration Viva Engage.

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