Freigeben über


Viva Engage

Viva Engage ist ein führendes soziales Netzwerk für Unternehmen, um die Arbeit intelligenter und schneller zu erledigen. Stellen Sie eine Verbindung mit Viva Engage her, um auf Unterhaltungen in Ihrem Unternehmensnetzwerk zuzugreifen.

Dieser Connector ist in den folgenden Produkten und Regionen verfügbar:

Dienstleistung Class Regions
Copilot Studio Norm Alle Power Automate-Regionen mit Ausnahme der folgenden Bereiche:
     - US Government (GCC)
     - US Government (GCC High)
     - China Cloud betrieben von 21Vianet
     - US Department of Defense (DoD)
Logik-Apps Norm Alle Logik-Apps-Regionen mit Ausnahme der folgenden Bereiche:
     – Azure Government-Regionen
     - Azure China-Regionen
     - US Department of Defense (DoD)
Power Apps Norm Alle Power Apps-Regionen mit Ausnahme der folgenden:
     - US Government (GCC)
     - US Government (GCC High)
     - China Cloud betrieben von 21Vianet
     - US Department of Defense (DoD)
Power Automate Norm Alle Power Automate-Regionen mit Ausnahme der folgenden Bereiche:
     - US Government (GCC)
     - US Government (GCC High)
     - China Cloud betrieben von 21Vianet
     - US Department of Defense (DoD)
Kontakt
Name Microsoft
URL https://microsoft.com
Connectormetadaten
Herausgeber Microsoft
Webseite https://products.office.com/yammer/yammer-overview
Datenschutzrichtlinie https://privacy.microsoft.com
Kategorien Communication

Von Bedeutung

Die OAuth2-Authentifizierung für Yammer (Viva Engage) wird in Kürze nicht mehr unterstützt.

  • Neue Verbindungen müssen ab dem 1. September entra ID-Authentifizierung verwenden.
  • Bestehende OAuth2-Verbindungen funktionieren bis zum 15. November 2025 weiterhin.

Bitte wechseln Sie vor dem 15. November 2025 zu Entra ID-Authentifizierung, um Unterbrechungen zu vermeiden.

Bekannte Probleme und Einschränkungen

Die folgenden Aktionen und Trigger garantieren nicht, dass alle Nachrichten aufgrund von Einschränkungen der Viva Engage-REST-API zurückgegeben werden:

  • Abrufen aller Nachrichten
  • Abrufen von Nachrichten in einer Gruppe
  • Abrufen von Nachrichten in einem Thread
  • Abrufen der Nachrichten aus meinem folgenden Feed
  • Wenn eine neue Nachricht in einer Gruppe vorhanden ist
  • Wenn es eine neue Nachricht in meinem gefolgten Feed gibt

Die folgende Aktion kann aufgrund von Einschränkungen der Viva Engage-REST-API maximal 100 Gruppen zurückgeben:

  • Gruppen abrufen

Hinweis

Die Viva Engage-API kann die Anzahl der zurückgegebenen Nachrichten einschränken. Wenn dies der Fall ist, lesen Sie bitte, wie Sie alle Nachrichten in einer Yammer Gruppe mithilfe von Microsoft Flow abrufen können, um diesen Grenzwert zu umgehen. Weitere Informationen zu Viva Engage-API-Grenzwerten finden Sie unter Yammer API-Ratenbeschränkungen.

Außerdem funktionieren die folgenden Aktionen und Trigger möglicherweise nicht mit der Gruppe "Alle Unternehmen ", da Viva Engage REST-API-Einschränkungen gelten:

  • Abrufen von Nachrichten in einer Gruppe
  • Abrufen von Nachrichten in einer Gruppe (V2)
  • Wenn eine neue Nachricht in einer Gruppe vorhanden ist

Das Feature "Drittanbieteranwendungen" muss in der Yammer-Konfiguration aktiviert sein. Eine Aktionsantwort wie "Die Antwort befindet sich nicht in einem JSON-Format" bedeutet in der Regel, dass das Feature deaktiviert ist.

Mit den folgenden Aktionen können Sie einen Beitrag "Ankündigung" mit einem "Titel" erstellen, nachdem Sie die entsprechenden erweiterten Parameter festgelegt haben. Dieser Beitrag kann jedoch nicht in der Viva Engage-Benutzeroberfläche bearbeitet werden. Viva Engage ist sich dieses Problem bewusst und wird dieses Problem in einem zukünftigen Update beheben.

  • PostMessage
  • PostMessageV2

Erstellen einer Verbindung

Der Connector unterstützt die folgenden Authentifizierungstypen:

Melden Sie sich mit der Microsoft Entra-ID an Melden Sie sich mit der Microsoft Entra-ID an Alle Regionen Nicht teilbar
Standard [VERALTET] Diese Option ist nur für ältere Verbindungen ohne expliziten Authentifizierungstyp vorgesehen und wird nur aus Gründen der Abwärtskompatibilität bereitgestellt. Alle Regionen Nicht teilbar

Melden Sie sich mit der Microsoft Entra-ID an

Auth-ID: entraIDUserLogin

Anwendbar: Alle Regionen

Melden Sie sich mit der Microsoft Entra-ID an

Dies ist keine freigabefähige Verbindung. Wenn die Power-App für einen anderen Benutzer freigegeben wird, wird ein anderer Benutzer aufgefordert, eine neue Verbindung explizit zu erstellen.

Standard [VERALTET]

Anwendbar: Alle Regionen

Diese Option ist nur für ältere Verbindungen ohne expliziten Authentifizierungstyp vorgesehen und wird nur aus Gründen der Abwärtskompatibilität bereitgestellt.

Dies ist keine freigabefähige Verbindung. Wenn die Power-App für einen anderen Benutzer freigegeben wird, wird ein anderer Benutzer aufgefordert, eine neue Verbindung explizit zu erstellen.

Drosselungsgrenzwerte

Name Aufrufe Verlängerungszeitraum
API-Aufrufe pro Verbindung 100 60 Sekunden
Häufigkeit der Triggerumfragen 1 15 Sekunden

Aktionen

Abrufen aller Nachrichten (V2) [VERALTET]

Diese Aktion ist veraltet. Verwenden Sie stattdessen "Alle Nachrichten abrufen" (V3 ).

Dieser Vorgang gibt alle öffentlichen Nachrichten im Viva Engage-Netzwerk des angemeldeten Benutzers zurück. Entspricht "Alle" Unterhaltungen in der Viva Engage-Weboberfläche.

Abrufen aller Nachrichten (V3)

Dieser Vorgang gibt alle öffentlichen Nachrichten im Viva Engage-Netzwerk des angemeldeten Benutzers zurück. Entspricht "Alle" Unterhaltungen in der Viva Engage-Weboberfläche.

Abrufen aller Nachrichten [VERALTET]

Diese Aktion ist veraltet. Verwenden Sie stattdessen "Alle Nachrichten abrufen" (V3 ).

Dieser Vorgang gibt alle öffentlichen Nachrichten im Viva Engage-Netzwerk des angemeldeten Benutzers zurück. Entspricht "Alle" Unterhaltungen in der Yammer Weboberfläche.

Abrufen der Nachrichten aus meinem folgenden Feed (V2) [VERALTET]

Diese Aktion ist veraltet. Verwenden Sie stattdessen "Abrufen der Nachrichten aus meinem folgenden Feed (V3) ".

Dieser Vorgang gibt die Nachrichten aus dem folgenden Feed zurück, bei denen es sich um Unterhaltungen mit Personen, Gruppen und Themen handelt, denen der Benutzer folgt.

Abrufen der Nachrichten aus meinem folgenden Feed (V3)

Dieser Vorgang gibt die Nachrichten aus dem folgenden Feed zurück, bei denen es sich um Unterhaltungen mit Personen, Gruppen und Themen handelt, denen der Benutzer folgt.

Abrufen der Nachrichten aus meinem folgenden Feed [VERALTET]

Diese Aktion ist veraltet. Verwenden Sie stattdessen "Abrufen der Nachrichten aus meinem folgenden Feed (V3) ".

Dieser Vorgang gibt die Nachrichten aus dem folgenden Feed zurück, bei denen es sich um Unterhaltungen mit Personen, Gruppen und Themen handelt, denen der Benutzer folgt.

Abrufen von Benutzerdetails

Dieser Vorgang gibt Benutzerprofildetails zurück.

Abrufen von Nachrichten in einem Thread (V2) [VERALTET]

Diese Aktion ist veraltet. Verwenden Sie stattdessen "Nachrichten abrufen" in einem Thread (V3 ).

Dieser Vorgang gibt die nachrichten zurück, die in einem Thread gepostet wurden.

Abrufen von Nachrichten in einem Thread (V3)

Dieser Vorgang gibt die nachrichten zurück, die in einem Thread gepostet wurden.

Abrufen von Nachrichten in einem Thread [VERALTET]

Diese Aktion ist veraltet. Verwenden Sie stattdessen "Nachrichten abrufen" in einem Thread (V3 ).

Dieser Vorgang gibt die nachrichten zurück, die in einem Thread gepostet wurden.

Abrufen von Nachrichten in einer Gruppe (V2) [VERALTET]

Diese Aktion ist veraltet. Verwenden Sie stattdessen "Nachrichten in einer Gruppe abrufen" (V3 ).

Dieser Vorgang gibt die nachrichten zurück, die in einer Gruppe gepostet wurden.

Abrufen von Nachrichten in einer Gruppe (V3)

Dieser Vorgang gibt die nachrichten zurück, die in einer Gruppe gepostet wurden.

Abrufen von Nachrichten in einer Gruppe [VERALTET]

Diese Aktion ist veraltet. Verwenden Sie stattdessen "Nachrichten in einer Gruppe abrufen" (V3 ).

Dieser Vorgang gibt die nachrichten zurück, die in einer Gruppe gepostet wurden.

Gruppen abrufen

Ruft alle Gruppen ab. Wenn meine = 1 ist, rufen Sie nur Gruppen ab, zu denen der Benutzer gehört.

Meine Netzwerke abrufen

Ruft alle Netzwerke ab, zu denen der Benutzer gehört.

Nachricht mit "Gefällt mir"

Dieser Vorgang wird verwendet, um die angegebene Nachricht zu liken.

Nachricht posten (V2)

Dieser Vorgang wird verwendet, um eine Nachricht in einem Gruppen- oder allen Firmenfeed zu posten. Wenn Gruppen-ID angegeben wird, wird die Nachricht in der angegebenen Gruppe veröffentlicht, andernfalls wird sie in allen Unternehmensfeeds gepostet.

Nachricht posten [VERALTET]

Dieser Vorgang wird verwendet, um eine Nachricht in einem Gruppen- oder allen Firmenfeed zu posten. Wenn Gruppen-ID angegeben wird, wird die Nachricht in der angegebenen Gruppe veröffentlicht, andernfalls wird sie in allen Unternehmensfeeds gepostet.

Abrufen aller Nachrichten (V2) [VERALTET]

Diese Aktion ist veraltet. Verwenden Sie stattdessen "Alle Nachrichten abrufen" (V3 ).

Dieser Vorgang gibt alle öffentlichen Nachrichten im Viva Engage-Netzwerk des angemeldeten Benutzers zurück. Entspricht "Alle" Unterhaltungen in der Viva Engage-Weboberfläche.

Parameter

Name Schlüssel Erforderlich Typ Beschreibung
Eindeutiger Bezeichner des Netzwerks
network_id string

Netzwerk-ID

Älter als
older_than integer

Gibt Nachrichten zurück, die älter als die nachrichten-ID sind, die als numerische Zeichenfolge angegeben ist. Dies ist nützlich für das Paginieren von Nachrichten. Wenn Sie z. B. derzeit 20 Nachrichten anzeigen und die älteste zahl 2912 ist, können Sie "?older_than=2912" an Ihre Anforderung anfügen, um die 20 Nachrichten abzurufen, bevor sie angezeigt werden.

Neuer als
newer_than integer

Gibt Nachrichten neuer als die als numerische Zeichenfolge angegebene Nachrichten-ID zurück. Dies sollte beim Abrufen neuer Nachrichten verwendet werden. Wenn Sie Nachrichten betrachten und die zuletzt zurückgegebene Nachricht 3516 ist, können Sie eine Anforderung mit dem Parameter "?newer_than=3516" stellen, um sicherzustellen, dass Sie keine duplizierten Kopien von Nachrichten erhalten, die sich bereits auf Ihrer Seite befinden.

Threadtyp von Nachrichten
threaded string

Threaded=true gibt nur den Threadstarter (erste Nachricht) für jeden Thread zurück. Dieser Parameter ist für Apps vorgesehen, die Meldungsthreads reduziert anzeigen müssen. threaded=extended gibt die Threadstartnachrichten und die beiden zuletzt nach Aktivität sortierten Nachrichten zurück, da sie in der Standardansicht auf der Viva Engage-Weboberfläche angezeigt werden.

Limit
limit integer

Gibt nur die angegebene Anzahl von Nachrichten zurück.

Gibt zurück

Liste einer oder mehrerer Nachrichten.

Nachrichtenliste
PageableMessageList

Abrufen aller Nachrichten (V3)

Dieser Vorgang gibt alle öffentlichen Nachrichten im Viva Engage-Netzwerk des angemeldeten Benutzers zurück. Entspricht "Alle" Unterhaltungen in der Viva Engage-Weboberfläche.

Parameter

Name Schlüssel Erforderlich Typ Beschreibung
Eindeutiger Bezeichner des Netzwerks
network_id string

Netzwerk-ID

Älter als
older_than integer

Gibt Nachrichten zurück, die älter als die nachrichten-ID sind, die als numerische Zeichenfolge angegeben ist. Dies ist nützlich für das Paginieren von Nachrichten. Wenn Sie z. B. derzeit 20 Nachrichten anzeigen und die älteste zahl 2912 ist, können Sie "?older_than=2912" an Ihre Anforderung anfügen, um die 20 Nachrichten abzurufen, bevor sie angezeigt werden.

Neuer als
newer_than integer

Gibt Nachrichten neuer als die als numerische Zeichenfolge angegebene Nachrichten-ID zurück. Dies sollte beim Abrufen neuer Nachrichten verwendet werden. Wenn Sie Nachrichten betrachten und die zuletzt zurückgegebene Nachricht 3516 ist, können Sie eine Anforderung mit dem Parameter "?newer_than=3516" stellen, um sicherzustellen, dass Sie keine duplizierten Kopien von Nachrichten erhalten, die sich bereits auf Ihrer Seite befinden.

Threadtyp von Nachrichten
threaded string

Threaded=true gibt nur den Threadstarter (erste Nachricht) für jeden Thread zurück. Dieser Parameter ist für Apps vorgesehen, die Meldungsthreads reduziert anzeigen müssen. threaded=extended gibt die Threadstartnachrichten und die beiden zuletzt nach Aktivität sortierten Nachrichten zurück, da sie in der Standardansicht auf der Viva Engage-Weboberfläche angezeigt werden.

Limit
limit integer

Gibt nur die angegebene Anzahl von Nachrichten zurück.

Gibt zurück

Liste einer oder mehrerer Nachrichten.

Nachrichtenliste
PageableMessageListV2

Abrufen aller Nachrichten [VERALTET]

Diese Aktion ist veraltet. Verwenden Sie stattdessen "Alle Nachrichten abrufen" (V3 ).

Dieser Vorgang gibt alle öffentlichen Nachrichten im Viva Engage-Netzwerk des angemeldeten Benutzers zurück. Entspricht "Alle" Unterhaltungen in der Yammer Weboberfläche.

Parameter

Name Schlüssel Erforderlich Typ Beschreibung
Eindeutiger Bezeichner des Netzwerks
network_id string

Netzwerk-ID

Älter als
older_than integer

Gibt Nachrichten zurück, die älter als die nachrichten-ID sind, die als numerische Zeichenfolge angegeben ist. Dies ist nützlich für das Paginieren von Nachrichten. Wenn Sie z. B. derzeit 20 Nachrichten anzeigen und die älteste zahl 2912 ist, können Sie "?older_than=2912" an Ihre Anforderung anfügen, um die 20 Nachrichten abzurufen, bevor sie angezeigt werden.

Neuer als
newer_than integer

Gibt Nachrichten neuer als die als numerische Zeichenfolge angegebene Nachrichten-ID zurück. Dies sollte beim Abrufen neuer Nachrichten verwendet werden. Wenn Sie Nachrichten betrachten und die zuletzt zurückgegebene Nachricht 3516 ist, können Sie eine Anforderung mit dem Parameter "?newer_than=3516" stellen, um sicherzustellen, dass Sie keine duplizierten Kopien von Nachrichten erhalten, die sich bereits auf Ihrer Seite befinden.

Limit
limit integer

Gibt nur die angegebene Anzahl von Nachrichten zurück.

Seite
page integer

Rufen Sie die angegebene Seite ab. Wenn zurückgegebene Daten größer als der Grenzwert sind, können Sie dieses Feld verwenden, um auf nachfolgende Seiten zuzugreifen.

Gibt zurück

Liste einer oder mehrerer Nachrichten.

Nachrichtenliste
MessageList

Abrufen der Nachrichten aus meinem folgenden Feed (V2) [VERALTET]

Diese Aktion ist veraltet. Verwenden Sie stattdessen "Abrufen der Nachrichten aus meinem folgenden Feed (V3) ".

Dieser Vorgang gibt die Nachrichten aus dem folgenden Feed zurück, bei denen es sich um Unterhaltungen mit Personen, Gruppen und Themen handelt, denen der Benutzer folgt.

Parameter

Name Schlüssel Erforderlich Typ Beschreibung
Netzwerk-ID
network_id string

Eindeutiger Bezeichner des Netzwerks.

Älter als
older_than integer

Gibt Nachrichten zurück, die älter als die nachrichten-ID sind, die als numerische Zeichenfolge angegeben ist. Dies ist nützlich für das Paginieren von Nachrichten. Wenn Sie z. B. derzeit 20 Nachrichten anzeigen und die älteste zahl 2912 ist, können Sie "?older_than=2912" an Ihre Anforderung anfügen, um die 20 Nachrichten abzurufen, bevor sie angezeigt werden.

Neuer als
newer_than integer

Gibt Nachrichten neuer als die als numerische Zeichenfolge angegebene Nachrichten-ID zurück. Dies sollte beim Abrufen neuer Nachrichten verwendet werden. Wenn Sie Nachrichten betrachten und die zuletzt zurückgegebene Nachricht 3516 ist, können Sie eine Anforderung mit dem Parameter "?newer_than=3516" stellen, um sicherzustellen, dass Sie keine duplizierten Kopien von Nachrichten erhalten, die sich bereits auf Ihrer Seite befinden.

Threadtyp von Nachrichten
threaded string

Threaded=true gibt nur den Threadstarter (erste Nachricht) für jeden Thread zurück. Dieser Parameter ist für Apps vorgesehen, die Meldungsthreads reduziert anzeigen müssen. threaded=extended gibt die Threadstartnachrichten und die beiden zuletzt nach Aktivität sortierten Nachrichten zurück, da sie in der Standardansicht auf der Viva Engage-Weboberfläche angezeigt werden.

Limit
limit integer

Gibt nur die angegebene Anzahl von Nachrichten zurück.

Gibt zurück

Liste einer oder mehrerer Nachrichten.

Nachrichtenliste
PageableMessageList

Abrufen der Nachrichten aus meinem folgenden Feed (V3)

Dieser Vorgang gibt die Nachrichten aus dem folgenden Feed zurück, bei denen es sich um Unterhaltungen mit Personen, Gruppen und Themen handelt, denen der Benutzer folgt.

Parameter

Name Schlüssel Erforderlich Typ Beschreibung
Netzwerk-ID
network_id string

Eindeutiger Bezeichner des Netzwerks.

Älter als
older_than integer

Gibt Nachrichten zurück, die älter als die nachrichten-ID sind, die als numerische Zeichenfolge angegeben ist. Dies ist nützlich für das Paginieren von Nachrichten. Wenn Sie z. B. derzeit 20 Nachrichten anzeigen und die älteste zahl 2912 ist, können Sie "?older_than=2912" an Ihre Anforderung anfügen, um die 20 Nachrichten abzurufen, bevor sie angezeigt werden.

Neuer als
newer_than integer

Gibt Nachrichten neuer als die als numerische Zeichenfolge angegebene Nachrichten-ID zurück. Dies sollte beim Abrufen neuer Nachrichten verwendet werden. Wenn Sie Nachrichten betrachten und die zuletzt zurückgegebene Nachricht 3516 ist, können Sie eine Anforderung mit dem Parameter "?newer_than=3516" stellen, um sicherzustellen, dass Sie keine duplizierten Kopien von Nachrichten erhalten, die sich bereits auf Ihrer Seite befinden.

Threadtyp von Nachrichten
threaded string

Threaded=true gibt nur den Threadstarter (erste Nachricht) für jeden Thread zurück. Dieser Parameter ist für Apps vorgesehen, die Meldungsthreads reduziert anzeigen müssen. threaded=extended gibt die Threadstartnachrichten und die beiden zuletzt nach Aktivität sortierten Nachrichten zurück, da sie in der Standardansicht auf der Viva Engage-Weboberfläche angezeigt werden.

Limit
limit integer

Gibt nur die angegebene Anzahl von Nachrichten zurück.

Gibt zurück

Liste einer oder mehrerer Nachrichten.

Nachrichtenliste
PageableMessageListV2

Abrufen der Nachrichten aus meinem folgenden Feed [VERALTET]

Diese Aktion ist veraltet. Verwenden Sie stattdessen "Abrufen der Nachrichten aus meinem folgenden Feed (V3) ".

Dieser Vorgang gibt die Nachrichten aus dem folgenden Feed zurück, bei denen es sich um Unterhaltungen mit Personen, Gruppen und Themen handelt, denen der Benutzer folgt.

Parameter

Name Schlüssel Erforderlich Typ Beschreibung
Netzwerk-ID
network_id string

Eindeutiger Bezeichner des Netzwerks.

Älter als
older_than integer

Gibt Nachrichten zurück, die älter als die nachrichten-ID sind, die als numerische Zeichenfolge angegeben ist. Dies ist nützlich für das Paginieren von Nachrichten. Wenn Sie z. B. derzeit 20 Nachrichten anzeigen und die älteste zahl 2912 ist, können Sie "?older_than=2912" an Ihre Anforderung anfügen, um die 20 Nachrichten abzurufen, bevor sie angezeigt werden.

Neuer als
newer_than integer

Gibt Nachrichten neuer als die als numerische Zeichenfolge angegebene Nachrichten-ID zurück. Dies sollte beim Abrufen neuer Nachrichten verwendet werden. Wenn Sie Nachrichten betrachten und die zuletzt zurückgegebene Nachricht 3516 ist, können Sie eine Anforderung mit dem Parameter "?newer_than=3516" stellen, um sicherzustellen, dass Sie keine duplizierten Kopien von Nachrichten erhalten, die sich bereits auf Ihrer Seite befinden.

Limit
limit integer

Gibt nur die angegebene Anzahl von Nachrichten zurück.

Seite
page integer

Rufen Sie die angegebene Seite ab. Wenn zurückgegebene Daten größer als der Grenzwert sind, können Sie dieses Feld verwenden, um auf nachfolgende Seiten zuzugreifen.

Gibt zurück

Liste einer oder mehrerer Nachrichten.

Nachrichtenliste
MessageList

Abrufen von Benutzerdetails

Dieser Vorgang gibt Benutzerprofildetails zurück.

Parameter

Name Schlüssel Erforderlich Typ Beschreibung
Benutzer-ID
user_id True integer

Eindeutiger Bezeichner des Benutzers

Gibt zurück

Eigenschaften von Viva Engage-Benutzern.

Benutzer
User

Abrufen von Nachrichten in einem Thread (V2) [VERALTET]

Diese Aktion ist veraltet. Verwenden Sie stattdessen "Nachrichten abrufen" in einem Thread (V3 ).

Dieser Vorgang gibt die nachrichten zurück, die in einem Thread gepostet wurden.

Parameter

Name Schlüssel Erforderlich Typ Beschreibung
Thread-ID
thread_id True integer

Eindeutiger Bezeichner des Threads.

Gibt zurück

Liste einer oder mehrerer Nachrichten.

Nachrichtenliste
PageableMessageList

Abrufen von Nachrichten in einem Thread (V3)

Dieser Vorgang gibt die nachrichten zurück, die in einem Thread gepostet wurden.

Parameter

Name Schlüssel Erforderlich Typ Beschreibung
Thread-ID
thread_id True integer

Eindeutiger Bezeichner des Threads.

Gibt zurück

Liste einer oder mehrerer Nachrichten.

Nachrichtenliste
PageableMessageListV2

Abrufen von Nachrichten in einem Thread [VERALTET]

Diese Aktion ist veraltet. Verwenden Sie stattdessen "Nachrichten abrufen" in einem Thread (V3 ).

Dieser Vorgang gibt die nachrichten zurück, die in einem Thread gepostet wurden.

Parameter

Name Schlüssel Erforderlich Typ Beschreibung
Thread-ID
thread_id True integer

Eindeutiger Bezeichner des Threads.

Gibt zurück

Liste einer oder mehrerer Nachrichten.

Nachrichtenliste
MessageList

Abrufen von Nachrichten in einer Gruppe (V2) [VERALTET]

Diese Aktion ist veraltet. Verwenden Sie stattdessen "Nachrichten in einer Gruppe abrufen" (V3 ).

Dieser Vorgang gibt die nachrichten zurück, die in einer Gruppe gepostet wurden.

Parameter

Name Schlüssel Erforderlich Typ Beschreibung
Netzwerk-ID
network_id string

Eindeutiger Bezeichner des Netzwerks.

Gruppen-ID
group_id True integer

Eindeutiger Bezeichner der Gruppe.

Älter als
older_than integer

Gibt Nachrichten zurück, die älter als die nachrichten-ID sind, die als numerische Zeichenfolge angegeben ist. Dies ist nützlich für das Paginieren von Nachrichten. Wenn Sie z. B. derzeit 20 Nachrichten anzeigen und die älteste zahl 2912 ist, können Sie "?older_than=2912" an Ihre Anforderung anfügen, um die 20 Nachrichten abzurufen, bevor sie angezeigt werden.

Neuer als
newer_than integer

Gibt Nachrichten neuer als die als numerische Zeichenfolge angegebene Nachrichten-ID zurück. Dies sollte beim Abrufen neuer Nachrichten verwendet werden. Wenn Sie Nachrichten betrachten und die zuletzt zurückgegebene Nachricht 3516 ist, können Sie eine Anforderung mit dem Parameter "?newer_than=3516" stellen, um sicherzustellen, dass Sie keine duplizierten Kopien von Nachrichten erhalten, die sich bereits auf Ihrer Seite befinden.

Threadtyp von Nachrichten
threaded string

Threaded=true gibt nur den Threadstarter (erste Nachricht) für jeden Thread zurück. Dieser Parameter ist für Apps vorgesehen, die Meldungsthreads reduziert anzeigen müssen. threaded=extended gibt die Threadstartnachrichten und die beiden zuletzt nach Aktivität sortierten Nachrichten zurück, da sie in der Standardansicht auf der Viva Engage-Weboberfläche angezeigt werden.

Limit
limit integer

Gibt nur die angegebene Anzahl von Nachrichten zurück.

Gibt zurück

Liste einer oder mehrerer Nachrichten.

Nachrichtenliste
PageableMessageList

Abrufen von Nachrichten in einer Gruppe (V3)

Dieser Vorgang gibt die nachrichten zurück, die in einer Gruppe gepostet wurden.

Parameter

Name Schlüssel Erforderlich Typ Beschreibung
Netzwerk-ID
network_id string

Eindeutiger Bezeichner des Netzwerks.

Gruppen-ID
group_id True integer

Eindeutiger Bezeichner der Gruppe.

Älter als
older_than integer

Gibt Nachrichten in Threads zurück, bei denen die neueste Nachricht des Threads älter als die angegebene Nachrichten-ID ist. Jeder Thread mit einer neuesten Nachrichten-ID, die neuer als oder gleich der angegebenen ID ist, enthält keine der von dieser Abfrage zurückgegebenen Nachrichten.

Neuer als
newer_than integer

Gibt Nachrichten in Threads zurück, bei denen die neueste Nachricht des Threads neuer als die angegebene Nachrichten-ID ist. Jeder Thread mit einer neuesten Nachrichten-ID, die älter als oder gleich der angegebenen ID ist, enthält keine der von dieser Abfrage zurückgegebenen Nachrichten.

Threadtyp von Nachrichten
threaded string

Threaded=true gibt nur den Threadstarter (erste Nachricht) für jeden Thread zurück. Dieser Parameter ist für Apps vorgesehen, die Meldungsthreads reduziert anzeigen müssen. threaded=extended gibt die Threadstartnachrichten und die beiden zuletzt nach Aktivität sortierten Nachrichten zurück, da sie in der Standardansicht auf der Viva Engage-Weboberfläche angezeigt werden.

Limit
limit integer

Gibt nur die angegebene Anzahl von Nachrichten zurück.

Gibt zurück

Liste einer oder mehrerer Nachrichten.

Nachrichtenliste
PageableMessageListV2

Abrufen von Nachrichten in einer Gruppe [VERALTET]

Diese Aktion ist veraltet. Verwenden Sie stattdessen "Nachrichten in einer Gruppe abrufen" (V3 ).

Dieser Vorgang gibt die nachrichten zurück, die in einer Gruppe gepostet wurden.

Parameter

Name Schlüssel Erforderlich Typ Beschreibung
Netzwerk-ID
network_id string

Eindeutiger Bezeichner des Netzwerks.

Gruppen-ID
group_id True integer

Eindeutiger Bezeichner der Gruppe.

Älter als
older_than integer

Gibt Nachrichten zurück, die älter als die nachrichten-ID sind, die als numerische Zeichenfolge angegeben ist. Dies ist nützlich für das Paginieren von Nachrichten. Wenn Sie z. B. derzeit 20 Nachrichten anzeigen und die älteste zahl 2912 ist, können Sie "?older_than=2912" an Ihre Anforderung anfügen, um die 20 Nachrichten abzurufen, bevor sie angezeigt werden.

Neuer als
newer_than integer

Gibt Nachrichten neuer als die als numerische Zeichenfolge angegebene Nachrichten-ID zurück. Dies sollte beim Abrufen neuer Nachrichten verwendet werden. Wenn Sie Nachrichten betrachten und die zuletzt zurückgegebene Nachricht 3516 ist, können Sie eine Anforderung mit dem Parameter "?newer_than=3516" stellen, um sicherzustellen, dass Sie keine duplizierten Kopien von Nachrichten erhalten, die sich bereits auf Ihrer Seite befinden.

Limit
limit integer

Gibt nur die angegebene Anzahl von Nachrichten zurück.

Seite
page integer

Rufen Sie die angegebene Seite ab. Wenn zurückgegebene Daten größer als der Grenzwert sind, können Sie dieses Feld verwenden, um auf nachfolgende Seiten zuzugreifen.

Gibt zurück

Liste einer oder mehrerer Nachrichten.

Nachrichtenliste
MessageList

Gruppen abrufen

Ruft alle Gruppen ab. Wenn meine = 1 ist, rufen Sie nur Gruppen ab, zu denen der Benutzer gehört.

Parameter

Name Schlüssel Erforderlich Typ Beschreibung
Netzwerk-ID
network_id string

Netzwerk-ID

mein
mine integer

Wird zum Abrufen von Gruppen verwendet, zu denen der Benutzer gehört

Alle Unternehmensgruppe anzeigen
showAllCompanyGroup integer

Wird verwendet, um die Gesamte Unternehmensgruppe anzuzeigen.

Gibt zurück

Meine Netzwerke abrufen

Ruft alle Netzwerke ab, zu denen der Benutzer gehört.

Gibt zurück

response
array of Network

Nachricht mit "Gefällt mir"

Dieser Vorgang wird verwendet, um die angegebene Nachricht zu liken.

Parameter

Name Schlüssel Erforderlich Typ Beschreibung
Nachrichten-ID
message_id True string

Eindeutige ID der Nachricht.

Nachricht posten (V2)

Dieser Vorgang wird verwendet, um eine Nachricht in einem Gruppen- oder allen Firmenfeed zu posten. Wenn Gruppen-ID angegeben wird, wird die Nachricht in der angegebenen Gruppe veröffentlicht, andernfalls wird sie in allen Unternehmensfeeds gepostet.

Parameter

Name Schlüssel Erforderlich Typ Beschreibung
Netzwerk-ID
network_id string

Eindeutige ID des Netzwerks.

Gruppen-ID
group_id True integer

Die Gruppe, in der eine Nachricht gepostt werden soll (0 = Gesamtes Unternehmen/Netzwerk).

Meldungstext
body True string

Ihre Nachricht, die in Ihr Netzwerk gepostet werden soll.

Antwort auf ID
replied_to_id integer

Die Nachrichten-ID, auf die diese Nachricht antwortet.

Direct To Id
direct_to_id integer

Bei Festlegung wird eine private Nachricht direkt an den Benutzer mit der angegebenen ID gesendet.

Übertragen
broadcast boolean

Posten Sie eine Nachricht als Ankündigung für alle Benutzer in einer Gruppe.

Title
title string

Der Titel der Nachricht, die gepostet werden soll.

Gibt zurück

Liste einer oder mehrerer Nachrichten.

Nachrichtenliste
MessageListV2

Nachricht posten [VERALTET]

Dieser Vorgang wird verwendet, um eine Nachricht in einem Gruppen- oder allen Firmenfeed zu posten. Wenn Gruppen-ID angegeben wird, wird die Nachricht in der angegebenen Gruppe veröffentlicht, andernfalls wird sie in allen Unternehmensfeeds gepostet.

Parameter

Name Schlüssel Erforderlich Typ Beschreibung
Netzwerk-ID
network_id string

Eindeutige ID des Netzwerks.

Gruppen-ID
group_id True integer

Die Gruppe, in der eine Nachricht gepostt werden soll (0 = Gesamtes Unternehmen/Netzwerk).

Meldungstext
body True string

Ihre Nachricht, die in Ihr Netzwerk gepostet werden soll.

Antwort auf ID
replied_to_id integer

Die Nachrichten-ID, auf die diese Nachricht antwortet.

Direct To Id
direct_to_id integer

Bei Festlegung wird eine private Nachricht direkt an den Benutzer mit der angegebenen ID gesendet.

Übertragen
broadcast boolean

Posten Sie eine Nachricht als Ankündigung für alle Benutzer in einer Gruppe.

Title
title string

Der Titel der Nachricht, die gepostet werden soll.

Thema 1
topic1 string

Thema, das auf die Nachricht angewendet werden soll.

Thema 2
topic2 string

Thema, das auf die Nachricht angewendet werden soll

Thema 3
topic3 string

Thema, das auf die Nachricht angewendet werden soll.

Thema 4
topic4 string

Thema, das auf die Nachricht angewendet werden soll

Thema 5
topic5 string

Thema, das auf die Nachricht angewendet werden soll.

Thema 6
topic6 string

Thema, das auf die Nachricht angewendet werden soll.

Thema 7
topic7 string

Thema, das auf die Nachricht angewendet werden soll

Thema 8
topic8 string

Thema, das auf die Nachricht angewendet werden soll.

Thema 9
topic9 string

Thema, das auf die Nachricht angewendet werden soll.

Thema 10
topic10 string

Thema, das auf die Nachricht angewendet werden soll.

Thema 11
topic11 string

Thema, das auf die Nachricht angewendet werden soll.

Thema 12
topic12 string

Thema, das auf die Nachricht angewendet werden soll.

Thema 13
topic13 string

Thema, das auf die Nachricht angewendet werden soll.

Thema 14
topic14 string

Thema, das auf die Nachricht angewendet werden soll.

Thema 15
topic15 string

Thema, das auf die Nachricht angewendet werden soll.

Thema 16
topic16 string

Thema, das auf die Nachricht angewendet werden soll.

Thema 17
topic17 string

Thema, das auf die Nachricht angewendet werden soll.

Thema 18
topic18 string

Thema, das auf die Nachricht angewendet werden soll.

Thema 19
topic19 string

Thema, das auf die Nachricht angewendet werden soll.

Thema 20
topic20 string

Thema, das auf die Nachricht angewendet werden soll.

Gibt zurück

Liste einer oder mehrerer Nachrichten.

Nachrichtenliste
MessageList

Trigger

Wenn eine neue Nachricht in einer Gruppe vorhanden ist (V2)

Dieser Vorgang wird ausgelöst, wenn eine neue Nachricht in einer Gruppe gepostet wird.

Wenn eine neue Nachricht in einer Gruppe vorhanden ist [VERALTET]

Diese Aktion ist veraltet. Verwenden Sie stattdessen ", wenn eine neue Nachricht in einer Gruppe (V2) vorhanden ist .

Dieser Vorgang wird ausgelöst, wenn eine neue Nachricht in einer Gruppe gepostet wird.

Wenn es eine neue Nachricht in meinem gefolgten Feed (V2) gibt

Dieser Vorgang wird ausgelöst, wenn eine neue Nachricht in einem Netzwerk vorhanden ist, gefolgt von Ihnen.

Wenn es eine neue Nachricht in meinem gefolgten Feed gibt [VERALTET]

Diese Aktion ist veraltet. Verwenden Sie stattdessen", wenn es eine neue Nachricht in meinem gefolgten Feed (V2) gibt .

Dieser Vorgang wird ausgelöst, wenn eine neue Nachricht in einem Netzwerk vorhanden ist, gefolgt von Ihnen.

Wenn eine neue Nachricht in einer Gruppe vorhanden ist (V2)

Dieser Vorgang wird ausgelöst, wenn eine neue Nachricht in einer Gruppe gepostet wird.

Parameter

Name Schlüssel Erforderlich Typ Beschreibung
Netzwerk-ID
network_id string

Eindeutiger Identifer des Netzwerks.

Gruppen-ID
group_id True integer

Eindeutiger Bezeichner der Gruppe.

Gibt zurück

Liste einer oder mehrerer Nachrichten.

Nachrichtenliste
MessageListV2

Wenn eine neue Nachricht in einer Gruppe vorhanden ist [VERALTET]

Diese Aktion ist veraltet. Verwenden Sie stattdessen ", wenn eine neue Nachricht in einer Gruppe (V2) vorhanden ist .

Dieser Vorgang wird ausgelöst, wenn eine neue Nachricht in einer Gruppe gepostet wird.

Parameter

Name Schlüssel Erforderlich Typ Beschreibung
Netzwerk-ID
network_id string

Eindeutiger Identifer des Netzwerks.

Gruppen-ID
group_id True integer

Eindeutiger Bezeichner der Gruppe.

Gibt zurück

Liste einer oder mehrerer Nachrichten.

Nachrichtenliste
MessageList

Wenn es eine neue Nachricht in meinem gefolgten Feed (V2) gibt

Dieser Vorgang wird ausgelöst, wenn eine neue Nachricht in einem Netzwerk vorhanden ist, gefolgt von Ihnen.

Parameter

Name Schlüssel Erforderlich Typ Beschreibung
Netzwerk-ID
network_id string

Wählen Sie ein Netzwerk aus.

Gibt zurück

Liste einer oder mehrerer Nachrichten.

Nachrichtenliste
MessageListV2

Wenn es eine neue Nachricht in meinem gefolgten Feed gibt [VERALTET]

Diese Aktion ist veraltet. Verwenden Sie stattdessen", wenn es eine neue Nachricht in meinem gefolgten Feed (V2) gibt .

Dieser Vorgang wird ausgelöst, wenn eine neue Nachricht in einem Netzwerk vorhanden ist, gefolgt von Ihnen.

Parameter

Name Schlüssel Erforderlich Typ Beschreibung
Netzwerk-ID
network_id string

Wählen Sie ein Netzwerk aus.

Gibt zurück

Liste einer oder mehrerer Nachrichten.

Nachrichtenliste
MessageList

Definitionen

Benutzer

Eigenschaften von Viva Engage-Benutzern.

Name Pfad Typ Beschreibung
Nutzername
name string

Benutzername.

Berufsbezeichnung
job_title string

Position des Benutzers.

Standort
location string

Benutzerspeicherort.

Vollständiger Name
full_name string

Vollständiger Benutzername.

Vorname
first_name string

Vorname des Benutzers.

Nachname
last_name string

Nachname des Benutzers.

Profil-URL
web_url string

Benutzerprofil-URL.

Email
email string

Benutzer-E-Mail.

Geburtsdatum
birth_date string

Geburtsdatum des Benutzers.

Foto-URL
mugshot_url string

Benutzerfoto-URL.

Nachricht

Eigenschaften einer einzelnen Viva Engage-Nachricht.

Name Pfad Typ Beschreibung
ID
id integer

Id, die dem Beitrag zugeordnet ist.

Text
content_excerpt string

Textinhalt des Beitrags.

Absender
sender_id integer

Eindeutige ID des Benutzers, der die Nachricht gepostet hat.

Geantwortet auf
replied_to_id integer

ID der Nachricht, auf die diese Nachricht eine Antwort ist.

Erstellt unter
created_at string

Zeitpunkt, zu dem die Nachricht erstellt wurde.

Netzwerk
network_id integer

Die ID der Netzwerknachricht ist verknüpft.

Typ
message_type string

Beschreibung des Nachrichtentyps.

Absendertyp
sender_type string

Beschreibung des Absendertyps.

URL
url uri

API-URL des Beitrags.

Web-URL
web_url uri

Web-URL des Beitrags.

Gruppen-ID
group_id integer

Eindeutige ID der Gruppe, die die Nachricht gepostet hat.

Nachrichtentext
body MessageBody

Inhalt, der einer einzelnen Nachricht zugeordnet ist.

Thread-ID
thread_id integer

Eindeutige ID des Threads.

Direkte Nachricht
direct_message boolean

Kennzeichnen, um anzugeben, ob es sich bei dem Beitrag um eine direkte Nachricht handelt.

Client-ID
client_type string

Typ des Clients.

Client-URL
client_url uri

Weblink des Clients.

Language
language string

In der Nachricht verwendete Sprache.

Markierter Benutzer
notified_user_ids array of integer

Details der benachrichtigten Benutzer.

Datenschutz
privacy string

Details zum Datenschutz, der der Nachricht zugeordnet ist.

liked_by
liked_by LikedBy

Gefällt mir von

Ist Systemnachricht
system_message boolean

Kennzeichnen, um anzugeben, ob es sich bei dem Beitrag um eine vom System generierte Nachricht handelt oder nicht.

Themen
topics array of Topic

Liste der Themen.

MessageV2

Eigenschaften einer einzelnen Viva Engage-Nachricht.

Name Pfad Typ Beschreibung
ID
id integer

Id, die dem Beitrag zugeordnet ist.

Text
content_excerpt string

Textinhalt des Beitrags.

Absender
sender_id integer

Eindeutige ID des Benutzers, der die Nachricht gepostet hat.

Geantwortet auf
replied_to_id integer

ID der Nachricht, auf die diese Nachricht eine Antwort ist.

Erstellt unter
created_at string

Zeitpunkt, zu dem die Nachricht erstellt wurde.

Netzwerk
network_id integer

Die ID der Netzwerknachricht ist verknüpft.

Typ
message_type string

Beschreibung des Nachrichtentyps.

Absendertyp
sender_type string

Beschreibung des Absendertyps.

URL
url uri

API-URL des Beitrags.

Web-URL
web_url uri

Web-URL des Beitrags.

Gruppen-ID
group_id integer

Eindeutige ID der Gruppe, die die Nachricht gepostet hat.

Nachrichtentext
body MessageBody

Inhalt, der einer einzelnen Nachricht zugeordnet ist.

Thread-ID
thread_id integer

Eindeutige ID des Threads.

Direkte Nachricht
direct_message boolean

Kennzeichnen, um anzugeben, ob es sich bei dem Beitrag um eine direkte Nachricht handelt.

Client-ID
client_type string

Typ des Clients.

Client-URL
client_url uri

Weblink des Clients.

Language
language string

In der Nachricht verwendete Sprache.

Markierter Benutzer
notified_user_ids array of integer

Details der benachrichtigten Benutzer.

Datenschutz
privacy string

Details zum Datenschutz, der der Nachricht zugeordnet ist.

liked_by
liked_by LikedBy

Gefällt mir von

Ist Systemnachricht
system_message boolean

Kennzeichnen, um anzugeben, ob es sich bei dem Beitrag um eine vom System generierte Nachricht handelt oder nicht.

Thema

Eigenschaften eines einzelnen Themas.

Name Pfad Typ Beschreibung
ID
id integer

Eindeutiger Bezeichner des Themas.

Name
name string

Name des Themas.

PageableMessageList

Liste einer oder mehrerer Nachrichten.

Name Pfad Typ Beschreibung
Messages
value array of Message

PageableMessageListV2

Liste einer oder mehrerer Nachrichten.

Name Pfad Typ Beschreibung
Messages
value array of MessageV2

MessageList

Liste einer oder mehrerer Nachrichten.

Name Pfad Typ Beschreibung
Messages
messages array of Message

messages

MessageListV2

Liste einer oder mehrerer Nachrichten.

Name Pfad Typ Beschreibung
Messages
messages array of MessageV2

messages

MessageBody

Inhalt, der einer einzelnen Nachricht zugeordnet ist.

Name Pfad Typ Beschreibung
Text
parsed string

Analysiertes Textformat.

Einfach
plain string

Nur-Text-Format.

Reich
rich string

Rich-Text-Format.

"Gefällt mir"

Gefällt mir von

Name Pfad Typ Beschreibung
Anzahl
count integer

Anzahl unterschiedlicher Likes.

Namen
names array of object

Liste der Personen, die dem Beitrag gefallen haben.

Vollständiger Name
names.full_name string

Der vollständige Name der Person, die dem Beitrag gefallen hat.

Netzwerk

Eigenschaften eines einzelnen Netzwerks.

Name Pfad Typ Beschreibung
ID
id string

Eindeutiger Bezeichner des Netzwerks.

Name
name string

Zusammenfassung des Netzwerks.

Link
permalink string

Weblink zur Netzwerkseite.

YammmerEntity

Eigenschaften einer einzelnen Viva Engage-Entität.

Name Pfad Typ Beschreibung
Description
type string

Details zur Viva Engage-Entität.

Gruppen-ID
id integer

Eindeutiger Bezeichner der Gruppe.

Vollständiger Name
full_name string

Name der Viva Engage-Entität.