Contact Support

Integration mit Viva Engage (Legacy)

Aktualisiert

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

Durch die Integration von Awardco mit Viva Engage können Organisationen öffentliche Awardco-Auszeichnungen nahtlos innerhalb ihrer Communities teilen. Dazu müssen Sie einen Bot-Benutzer erstellen, diesen Benutzer zu allen Communities hinzufügen, in denen Auszeichnungen 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 über eine gültige Lizenz für den Zugriff auf Viva Engage verfügt, und müssen als Awardco-Administrator angemeldet sein, um das Bot-Benutzerkonto mit Awardco zu verbinden. Folgen Sie den im folgenden Artikel beschriebenen Schritten, um die Integration erfolgreich zu konfigurieren.
 

Hinweis: Diese Integration ermöglicht es Ihnen, den Anerkennungsfeed für Spot-Auszeichnungen in Viva Engage anzuzeigen. Sie unterstützt jedoch nicht das direkte Senden von Auszeichnungen über Viva Engage, das Einbeziehen von Auszeichnungen aus automatisierten Programmen oder die Anzeige 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 das Posten von Anerkennungen
  8. Häufig gestellte Fragen (FAQ)

 

 Registrieren einer Anwendung in Microsoft Entra ID

  1. Ein Microsoft 365-Administrator (oder jemand mit 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 (oder suchen Sie danach).
  3. Unter „Verwalten“ 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).
    3. Weiterleitungs-URI: Geben Sie Folgendes ein und ersetzen Sie [your-subdomain] durch Ihre Firmen-URL: 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 in der linken Navigation zu Zertifikate & Geheimnisse. Klicken Sie auf + Neues Client-Geheimnis, geben Sie eine Beschreibung ein, wählen Sie eine Ablaufzeit und klicken Sie auf Hinzufügen. KOPIEREN Sie SOFORT den Wert des Geheimnisses.
    • Hinweis: Dies ist Ihr neues Client-Geheimnis, und Sie können es nicht erneut abrufen, nachdem Sie diese Seite verlassen haben.

 

Konfigurieren der API-Berechtigungen

  1. Gehen Sie in der linken Navigation 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. Administratorzustimmung erteilen: Nachdem Sie die Berechtigungen hinzugefügt haben, muss ein Administrator auf „Administratorzustimmung für [Ihre Organisation] erteilen“ klicken.

 

Erstellen eines Bot-Benutzers

So erstellen Sie Ihren Bot-Benutzer, der Anerkennungen posten soll:

  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“.

  

 

  1. Benennen Sie den Benutzer nach Wunsch. Zum Beispiel könnten Sie den Anzeigenamen „My Company Recognition“ vergeben.
  2. Vergeben Sie einen Benutzernamen und ein Passwort. Sie können sich das Passwort auch per E-Mail zusenden lassen. Speichern Sie den Benutzernamen und das Passwort, da Sie diese später benötigen!
  3. Weisen Sie dem Benutzer eine Lizenz zu. Stellen Sie sicher, dass der Benutzer Zugriff auf Viva Engage hat.
  4. Optionale Einstellungen können übersprungen werden, es sei denn, Sie möchten Änderungen vornehmen.
  5. Überprüfen Sie die Angaben und klicken Sie bei Richtigkeit auf „Hinzufügen abschließen“.
  6. 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 alle Communities erstellen und/oder beitreten, in denen Sie Anerkennungen posten möchten.

Eine optionale Möglichkeit für Administratoren, dem Bot die Berechtigung 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 „Administratoren“ aus dem Menü.
  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://[you-subdomain].awardco.com/settings/integrations/viva-engage
  2. Klicken Sie auf „Setup starten“
  3. Klicken Sie auf „Weiter“
  4. Geben Sie die zuvor gespeicherte Client-ID ein
  5. Geben Sie das zuvor gespeicherte Client-Geheimnis ein
  6. Melden Sie sich auf der neuen Seite mit dem Bot an, der die Anerkennungen posten soll
  7. Klicken Sie auf „Weiter“
  8. Wählen Sie eine Community aus, in der der Bot posten soll
     

Einrichten von Metadaten für das Posten von Anerkennungen

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 dieser Metadatenwerte posten möchten.
  6. Klicken Sie auf „Regel speichern“.
  7. Fügen Sie nach 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 gepostet werden, die keinen der aufgeführten Metadatenwerte haben.



 

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 unter „Integration pausieren“ angehalten 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 sich in der richtigen Community befinden.
    • 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 zulassen.
  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?






 

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

 

Verknüpfung mit