Grâce à l’intégration d’Awardco avec Viva Engage, les organisations peuvent partager facilement les reconnaissances publiques Awardco au sein de leurs communautés. Pour ce faire, vous devez 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 incarner 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.
Remarque : Cette intégration vous permet de voir le fil de reconnaissances pour les reconnaissances ponctuelles dans Viva Engage. Cependant, elle ne prend pas en charge l’envoi de reconnaissances directement via Viva Engage, n’inclut pas les reconnaissances provenant de programmes automatisés, ni l’affichage d’images et de vidéos dans le fil.
- Enregistrer une application dans Microsoft Entra ID
- Obtenir l’ID client et le secret client
- Configurer les autorisations API
- Créer un utilisateur bot
- Ajouter un utilisateur bot à une communauté
- Connecter l’application Viva Engage à Awardco
- Configurer les métadonnées pour la publication de reconnaissances
- Foire aux questions (FAQ)
Enregistrer une application dans Microsoft Entra ID
- Un administrateur Microsoft 365 (ou une personne disposant des autorisations appropriées, comme un développeur d’application ou un administrateur d’application cloud) doit se connecter au portail Microsoft Azure (http://portal.azure.com).
- Sélectionnez Microsoft Entra ID (ou recherchez-le).
- Sous Gérer, sélectionnez Enregistrements d’applications, puis cliquez sur + Nouvel enregistrement.
- Remplissez les détails de l’enregistrement :
- Nom : Donnez un nom significatif (par exemple, « Intégration Awardco Viva Engage »).
- Types de comptes pris en charge : Sélectionnez « Comptes dans ce répertoire organisationnel uniquement » (locataire unique).
- URI de redirection : Saisissez ce qui suit en remplaçant [votre-sous-domaine] par celui de votre entreprise : https://[votre-sous-domaine].awardco.com/viva-engage/auth.
- Enregistrez l’application.
Obtenir l’ID client et le secret client
- Une fois l’application enregistrée, vous serez dirigé vers la page Présentation de l’application. L’ID d’application (client) correspond à l’ID client. Enregistrez-le pour plus tard.
- 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.
- Remarque : 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
- Dans la navigation de gauche, allez dans Autorisations API.
- Cliquez sur + Ajouter une autorisation.
- Ajoutez les autorisations suivantes
- Sous Microsoft Graph
- openid
- profile
- User.read
- Sous Yammer
- user_impersonation
- Sous Microsoft Graph
- Accorder le consentement de l’administrateur : Après avoir ajouté l’autorisation, un administrateur doit cliquer sur Accorder le consentement de l’administrateur pour [Votre organisation]
Créer un utilisateur bot
Pour créer votre utilisateur bot afin de publier des reconnaissances :
- Connectez-vous au Centre d’administration Microsoft 365 en tant qu’administrateur Microsoft 365. https://admin.microsoft.com/Adminportal/Home#/users
- Cliquez sur « Ajouter un utilisateur ».
- Nommez l’utilisateur comme vous le souhaitez. Par exemple, vous pouvez lui attribuer le nom d’affichage « Reconnaissance Ma Compagnie ».
- Attribuez un nom d’utilisateur et un mot de passe. Vous pouvez également demander à recevoir le mot de passe par courriel. Assurez-vous de sauvegarder le nom d’utilisateur et le mot de passe, car vous en aurez besoin plus tard !
- Sélectionnez une licence pour l’utilisateur. Assurez-vous que l’utilisateur a accès à Viva Engage.
- Vous pouvez passer les paramètres optionnels, sauf si vous souhaitez faire des modifications.
- Vérifiez les informations et, si elles sont correctes, cliquez sur « Terminer l’ajout ».
- 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é
- Utilisez le nouvel utilisateur bot pour vous connecter à Viva Engage https://web.yammer.com/. Vous pouvez vouloir faire cela dans une fenêtre de navigation privée de votre navigateur.
- Faites en sorte que l’utilisateur crée et/ou rejoigne toutes les communautés dans lesquelles vous souhaitez publier des reconnaissances.
Une méthode optionnelle pour que les administrateurs donnent les permissions au bot pour publier dans n’importe quelle communauté :
- Connectez-vous à Viva Engage (Yammer) en tant qu’administrateur global.
- Allez au Centre d’administration Yammer (Paramètres > Administrateur réseau).
- Sélectionnez Administrateurs dans le menu.
- Trouvez votre utilisateur bot.
- Attribuez-lui le statut d’administrateur vérifié.
Connecter l’application Viva Engage à Awardco
Pour connecter l’application Viva Engage à Awardco :
- Allez à https://[votre-sous-domaine].awardco.com/settings/integrations/viva-engage
- Cliquez sur Commencer la configuration
- Cliquez sur Suivant
- Entrez l’ID client que vous avez enregistré plus tôt
- Entrez le secret client que vous avez enregistré plus tôt
- Connectez-vous avec le bot que vous souhaitez utiliser pour publier les reconnaissances dans la nouvelle page qui s’ouvre
- Cliquez sur Continuer
- Sélectionnez une communauté dans laquelle vous souhaitez que le bot publie
Configurer les métadonnées pour la publication de 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. :
- Accédez aux paramètres de la communauté.
- Sélectionnez un champ de métadonnées sur lequel baser les règles.
- Cliquez sur « Ajouter une règle ».
- Sélectionnez une ou plusieurs valeurs de métadonnées.
- Sélectionnez la communauté Viva Engage dans laquelle vous souhaitez publier des reconnaissances pour ces valeurs de métadonnées.
- Cliquez sur « Enregistrer la règle ».
- Continuez à ajouter et enregistrer des règles selon les besoins.
- Vous pouvez désactiver la « Communauté par défaut » si vous ne souhaitez pas que des reconnaissances soient publiées pour les utilisateurs qui n’ont pas l’une des valeurs de métadonnées listées.
Foire aux questions (FAQ)
- 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.
- Que faire si les reconnaissances ne sont pas publiées dans Viva Engage ?
- Assurez-vous que l’intégration n’est pas en pause dans « Pause Integration »
- Vérifiez que la communauté par défaut est définie ou que les règles de métadonnées s’appliquent au destinataire de la reconnaissance.
- Vérifiez que vous regardez la bonne communauté.
- Assurez-vous que les reconnaissances sont publiques.
- Puis-je personnaliser l’apparence des reconnaissances dans Viva Engage ?
- En raison des limites de l’API Viva Engage, nous ne pouvons pas formater le texte des reconnaissances ni permettre aucune personnalisation.
- Les commentaires et réactions dans Viva Engage apparaîtront-ils dans le fil Awardco ?
- Non, ce n’est pas possible actuellement.
- 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 les reconnaissances dans SharePoint à l’aide de l’intégration Viva Engage.
If you have any questions, please contact Awardco Admin Support.