Durch die Integration von Awardco mit Viva Engage können Organisationen öffentliche Awardco-Anerkennungen nahtlos innerhalb ihrer Communities teilen. Dazu müssen Sie einen Bot-Benutzer erstellen, diesen Benutzer zu allen Communities hinzufügen, in denen Anerkennungen gepostet werden sollen, eine Viva Engage-Anwendung erstellen, die diesen Benutzer imitiert, und diese Anwendung mit Awardco verbinden. Sie benötigen einen Microsoft 365-Administrator, um den Benutzer zu erstellen, sicherzustellen, dass der Benutzer eine gültige Lizenz für den Zugriff auf Viva Engage hat, und Sie müssen als Awardco-Administrator angemeldet sein, um das Konto des Bot-Benutzers mit Awardco zu verbinden. Folgen Sie den unten beschriebenen Schritten, um die Integration erfolgreich zu konfigurieren.

Hinweis: Diese Integration ermöglicht es Ihnen, den Anerkennungs-Feed für Spot-Anerkennungen in Viva Engage einzusehen. Allerdings unterstützt sie nicht das direkte Senden von Anerkennungen über Viva Engage, einschließlich Anerkennungen aus automatisierten Programmen, noch das Anzeigen von Bildern und Videos im Feed.

 

1. Registrieren einer Anwendung in Microsoft Entra ID
2. Erhalten der Client-ID und des Client-Geheimnisses
3. Konfigurieren der API-Berechtigungen
4. Erstellen eines Bot-Benutzers
5. Hinzufügen eines Bot-Benutzers zu einer Community
6. Verbinden der Viva Engage-Anwendung mit Awardco
7. Einrichten von Metadaten für die Anerkennungsposts
8. Häufig gestellte Fragen (FAQ)

 Registrieren einer Anwendung in Microsoft Entra ID

1. Ein Microsoft 365-Administrator (oder jemand mit den entsprechenden Berechtigungen, wie Anwendungsentwickler oder Cloud-Anwendungsadministrator) muss sich im Microsoft Azure-Portal (http://portal.azure.com) anmelden.
2. Wählen Sie Microsoft Entra ID aus (oder suchen Sie danach).
3. Unter Verwaltung wählen Sie App-Registrierungen und klicken dann auf + Neue Registrierung.
4. Füllen Sie die Registrierungsdetails aus:
   1. Name: Geben Sie einen aussagekräftigen Namen ein (z. B. „Awardco Viva Engage Integration“).
   2. Unterstützte Kontotypen: Wählen Sie „Konten in diesem Organisationsverzeichnis“ (Einzelmandant) aus.
   3. Umleitungs-URI: Geben Sie Folgendes ein, wobei Sie [your-subdomain] durch Ihre Firmen-Subdomain ersetzen: https://[your-subdomain].awardco.com/viva-engage/auth.
5. Registrieren Sie die Anwendung.

Erhalten der Client-ID und des Client-Geheimnisses

1. Nach der Registrierung gelangen Sie zur Übersichtsseite der App. Die Anwendungs-(Client-)ID ist die Client-ID. Speichern Sie diese für später.
2. Client-Geheimnis: Gehen Sie im linken Navigationsbereich zu Zertifikate & Geheimnisse. Klicken Sie auf + Neues Client-Geheimnis, geben Sie eine Beschreibung ein, wählen Sie eine Ablaufzeit aus und klicken Sie auf Hinzufügen. Kopieren Sie SOFORT den Wert des Geheimnisses.
   • Hinweis: Dies ist Ihr neues Client-Geheimnis, das Sie nach Verlassen dieser Seite nicht mehr abrufen können.

Konfigurieren der API-Berechtigungen

1. Gehen Sie im linken Navigationsbereich zu API-Berechtigungen.
2. Klicken Sie auf + Berechtigung hinzufügen.
3. Fügen Sie die folgenden Berechtigungen hinzu:
   • Unter Microsoft Graph:
     • openid
     • profile
     • User.read
   • Unter Yammer:
     • user_impersonation
4. Admin-Zustimmung erteilen: Nachdem Sie die Berechtigung hinzugefügt haben, muss ein Administrator auf „Admin-Zustimmung für [Ihre Organisation] erteilen“ klicken.

Erstellen eines Bot-Benutzers

Um Ihren Bot-Benutzer zum Posten von Anerkennungen zu erstellen:

1. Melden Sie sich im Microsoft 365 Admin Center als Microsoft 365-Administrator an. https://admin.microsoft.com/Adminportal/Home#/users
2. Klicken Sie auf „Benutzer hinzufügen“.

3. Benennen Sie den Benutzer nach Wunsch. Zum Beispiel könnten Sie den Anzeigenamen „Mein Unternehmen Anerkennung“ vergeben.
4. Vergeben Sie einen Benutzernamen und ein Passwort. Sie können sich das Passwort auch per E-Mail zusenden lassen. Speichern Sie Benutzername und Passwort unbedingt, da Sie diese später benötigen!
5. Wählen Sie eine Lizenz für den Benutzer aus. Stellen Sie sicher, dass der Benutzer Zugriff auf Viva Engage hat.
6. Optionale Einstellungen können Sie überspringen, sofern Sie keine Änderungen vornehmen möchten.
7. Überprüfen Sie die Angaben und klicken Sie bei Korrektheit auf „Hinzufügen abschließen“.
8. Speichern Sie unbedingt den Benutzernamen und das Passwort, da Sie diese später benötigen!

Hinzufügen eines Bot-Benutzers zu einer Community

1. Melden Sie sich mit dem neuen Bot-Benutzer bei Viva Engage an https://web.yammer.com/. Es empfiehlt sich, dies in einem Inkognito-Fenster Ihres Browsers zu tun.
2. Lassen Sie den Benutzer Communities erstellen und/oder Communities beitreten, in denen Anerkennungen gepostet werden sollen.

Eine optionale Möglichkeit für Administratoren, dem Bot Berechtigungen zum Posten in jeder Community zu geben:

1. Melden Sie sich bei Viva Engage (Yammer) als globaler Administrator an.
2. Gehen Sie zum Yammer Admin Center (Einstellungen > Netzwerkadministrator).
3. Wählen Sie im Menü „Administratoren“ aus.
4. Suchen Sie Ihren Bot-Benutzer.
5. Erteilen Sie ihm den Status „Verifizierter Administrator“. 
    

Verbinden der Viva Engage-Anwendung mit Awardco

Um die Viva Engage-Anwendung mit Awardco zu verbinden:

1. Navigieren Sie zu https://[your-subdomain].awardco.com/settings/integrations/viva-engage
2. Wählen Sie die Schaltfläche „Admin“ unten im linken Navigationsmenü.
3. Wählen Sie „Plattform“, dann „Integrationen“ und klicken Sie in der Admin-Konsole auf die Integrationsbibliothek.
4. Suchen und wählen Sie „Microsoft Viva Engage“ aus.
5. Klicken Sie auf „Setup starten“.
6. Klicken Sie auf „Weiter“.
7. Geben Sie die zuvor gespeicherte Client-ID ein.
8. Geben Sie das zuvor gespeicherte Client-Geheimnis ein.
9. Melden Sie sich auf der neu geöffneten Seite mit dem Bot-Benutzer an, der die Anerkennungen posten soll.
10. Klicken Sie auf „Weiter“.
11. Wählen Sie eine Community aus, in der der Bot posten soll.
     

Einrichten von Metadaten für die Anerkennungsposts

Um Metadatenregeln einzurichten, damit Benutzer aus verschiedenen Standorten oder Abteilungen Anerkennungen sehen können, die Personen betreffen, die sie kennen (z. B. :

1. Greifen Sie auf die Community-Einstellungen zu.
2. Wählen Sie ein Metadatenfeld aus, auf dem die Regeln basieren sollen.
3. Klicken Sie auf „Regel hinzufügen“.
4. Wählen Sie einen oder mehrere Metadatenwerte aus.
5. Wählen Sie die Viva Engage-Community aus, für die Sie Anerkennungen für diese Metadatenwerte posten möchten.
6. Klicken Sie auf „Regel speichern“.
7. Fügen Sie bei Bedarf weitere Regeln hinzu und speichern Sie diese.
8. Sie können die „Standard-Community“ deaktivieren, wenn Sie nicht möchten, dass Anerkennungen für Benutzer ohne einen der aufgelisteten Metadatenwerte gepostet werden.

Häufig gestellte Fragen (FAQ)

1. Was, wenn ich keine Communities in Awardco sehe?
   • Fügen Sie den Bot-Benutzer allen Communities hinzu, in denen Sie Anerkennungen posten möchten.
2. Was, wenn Anerkennungen nicht in Viva Engage gepostet werden?
   • Stellen Sie sicher, dass die Integration nicht in „Integration pausieren“ pausiert ist.
   • Vergewissern Sie sich, dass die Standard-Community gesetzt ist oder die Metadatenregeln für den Empfänger der Anerkennung gelten.
   • Überprüfen Sie, ob Sie die richtige Community ansehen.
   • Stellen Sie sicher, dass die Anerkennungen öffentlich sind.
3. Kann ich das Aussehen der Anerkennungen in Viva Engage anpassen?
   • Aufgrund der Einschränkungen der Viva Engage API können wir den Anerkennungstext nicht formatieren oder Anpassungen erlauben.
4. Werden Kommentare und Reaktionen in Viva Engage im Awardco-Feed angezeigt?
   • Nein, das ist derzeit nicht möglich.
5. Kann ich SharePoint mit Viva Engage verbinden, um Anerkennungen anzuzeigen?
   • Sie können dies einrichten, indem Sie die Schritte in unserem Support-Artikel Anerkennung in SharePoint mit der Viva Engage Integration anzeigen befolgen.

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