Viva Engage
Viva Engage är ett ledande socialt nätverk för företag för att få arbete gjort smartare och snabbare. Anslut till Viva Engage för att få åtkomst till konversationer i företagsnätverket.
Den här anslutningsappen är tillgänglig i följande produkter och regioner:
| Tjänster | Class | Regioner |
|---|---|---|
| Copilot Studio | Norm | Alla Power Automate-regioner utom följande: - Amerikanska myndigheter (GCC) - Amerikanska myndigheter (GCC High) – China Cloud drivs av 21Vianet - US Department of Defense (DoD) |
| Logiska appar | Norm | Alla Logic Apps-regioner utom följande: – Azure Government-regioner – Regioner i Azure Kina - US Department of Defense (DoD) |
| Power Apps | Norm | Alla Power Apps-regioner utom följande: - Amerikanska myndigheter (GCC) - Amerikanska myndigheter (GCC High) – China Cloud drivs av 21Vianet - US Department of Defense (DoD) |
| Power Automate | Norm | Alla Power Automate-regioner utom följande: - Amerikanska myndigheter (GCC) - Amerikanska myndigheter (GCC High) – China Cloud drivs av 21Vianet - US Department of Defense (DoD) |
| Kontakt | |
|---|---|
| Namn | Microsoft |
| URL | https://microsoft.com |
| Metadata för anslutningsprogram | |
|---|---|
| Utgivare | Microsoft |
| Webbplats | https://products.office.com/yammer/yammer-overview |
| Sekretesspolicy | https://privacy.microsoft.com |
| Kategorier | Communication |
Viktigt!
OAuth2-autentisering för Yammer (Viva Engage) kommer snart att bli inaktuell.
- Nya anslutningar måste använda Entra ID-autentisering från och med den 1 september.
- Befintliga OAuth2-anslutningar fortsätter att fungera fram till den 15 november 2025.
Växla dina anslutningar till Entra ID-autentisering före den 15 november 2025 för att undvika störningar.
Kända problem och begränsningar
Följande åtgärder och utlösare garanterar inte att alla meddelanden returneras på grund av begränsningar för Rest API för Viva Engage:
- Hämta alla meddelanden
- Hämta meddelanden i en grupp
- Hämta meddelanden i en tråd
- Hämta meddelandena från följande feed
- När det finns ett nytt meddelande i en grupp
- När det finns ett nytt meddelande i mitt följt flöde
Följande åtgärd kan returnera högst 100 grupper på grund av begränsningarna i Viva Engage REST API:
- Hämta grupper
Anmärkning
Viva Engage-API:et kan begränsa antalet meddelanden som returneras. Om detta inträffar kan du läsa Så här hämtar du alla meddelanden i en Yammer-grupp med Hjälp av Microsoft Flow för att undvika den här gränsen. Mer information om Viva Engage API-gränser finns i Hastighetsbegränsningar för Yammer API.
Dessutom kanske följande åtgärder och utlösare inte fungerar med Alla företagsgrupp på grund av Begränsningar för Viva Engage REST API:
- Hämta meddelanden i en grupp
- Hämta meddelanden i en grupp (V2)
- När det finns ett nytt meddelande i en grupp
Funktionen Program från tredje part måste vara aktiverad i Yammer-konfigurationen. Ett åtgärdssvar som "Svaret är inte i JSON-format" innebär vanligtvis att funktionen är inaktiverad.
Med följande åtgärder kan du skapa ett "Meddelande"-inlägg med en "Rubrik" efter att du har angett motsvarande avancerade parametrar, men det här inlägget kommer inte att kunna redigeras i Användargränssnittet för Viva Engage. Viva Engage är medveten om det här problemet och kommer att åtgärda problemet i en framtida uppdatering.
- PostMessage
- PostMessageV2
Skapa en anslutning
Anslutningsappen stöder följande autentiseringstyper:
| Logga in med Microsoft Entra-ID | Logga in med Microsoft Entra-ID | Alla regioner | Går inte att dela |
| Standard [INAKTUELL] | Det här alternativet är endast för äldre anslutningar utan en explicit autentiseringstyp och tillhandahålls endast för bakåtkompatibilitet. | Alla regioner | Går inte att dela |
Logga in med Microsoft Entra-ID
Autentiserings-ID: entraIDUserLogin
Tillämpligt: Alla regioner
Logga in med Microsoft Entra-ID
Det här är inte delningsbar anslutning. Om power-appen delas med en annan användare uppmanas en annan användare att skapa en ny anslutning explicit.
Standard [INAKTUELL]
Tillämpligt: Alla regioner
Det här alternativet är endast för äldre anslutningar utan en explicit autentiseringstyp och tillhandahålls endast för bakåtkompatibilitet.
Det här är inte delningsbar anslutning. Om power-appen delas med en annan användare uppmanas en annan användare att skapa en ny anslutning explicit.
Begränsningar för strypning
| Namn | Samtal | Förnyelseperioden |
|---|---|---|
| API-anrop per anslutning | 100 | 60 sekunder |
| Frekvens för utlösarundersökningar | 1 | 15 sekunder |
Åtgärder
| Gilla meddelande |
Den här åtgärden används för att gilla det angivna meddelandet. |
| Hämta alla meddelanden (V2) [INAKTUELL] |
Den här åtgärden är inaktuell. Använd Hämta alla meddelanden (V3) i stället.
|
| Hämta alla meddelanden (V3) |
Den här åtgärden returnerar alla offentliga meddelanden i den inloggade användarens Viva Engage-nätverk. Motsvarar alla konversationer i webbgränssnittet Viva Engage. |
| Hämta alla meddelanden [INAKTUELL] |
Den här åtgärden är inaktuell. Använd Hämta alla meddelanden (V3) i stället.
|
| Hämta användarinformation |
Den här åtgärden returnerar användarprofilinformation. |
| Hämta grupper |
Hämtar alla grupper. Om min = 1 hämtar du endast grupper som användaren tillhör |
| Hämta meddelanden i en grupp (V2) [INAKTUELL] |
Den här åtgärden är inaktuell. Använd Hämta meddelanden i en grupp (V3) i stället.
|
| Hämta meddelanden i en grupp (V3) |
Den här åtgärden returnerar meddelandena som publiceras i en grupp. |
| Hämta meddelanden i en grupp [INAKTUELL] |
Den här åtgärden är inaktuell. Använd Hämta meddelanden i en grupp (V3) i stället.
|
| Hämta meddelanden i en tråd (V2) [INAKTUELL] |
Den här åtgärden är inaktuell. Använd Hämta meddelanden i en tråd (V3) i stället.
|
| Hämta meddelanden i en tråd (V3) |
Den här åtgärden returnerar meddelandena som publiceras i en tråd. |
| Hämta meddelanden i en tråd [INAKTUELL] |
Den här åtgärden är inaktuell. Använd Hämta meddelanden i en tråd (V3) i stället.
|
| Hämta meddelandena från följande feed [INAKTUELL] |
Den här åtgärden är inaktuell. Använd Hämta meddelanden från min Följande feed (V3) i stället.
|
| Hämta meddelandena från min Följande feed (V2) [INAKTUELL] |
Den här åtgärden är inaktuell. Använd Hämta meddelanden från min Följande feed (V3) i stället.
|
| Hämta meddelandena från min följande feed (V3) |
Den här åtgärden returnerar meddelandena från Följande feed, vilket är konversationer som involverar personer, grupper och ämnen som användaren följer. |
| Hämta mina nätverk |
Hämtar alla nätverk som användaren tillhör. |
| Publicera meddelande (V2) |
Den här åtgärden används för att publicera ett meddelande till en grupp eller alla företagsfeed. Om grupp-ID anges publiceras meddelandet till den angivna gruppen, annars publiceras det i Alla företagsfeed. |
| Publicera meddelandet [INAKTUELL] |
Den här åtgärden används för att publicera ett meddelande till en grupp eller alla företagsfeed. Om grupp-ID anges publiceras meddelandet till den angivna gruppen, annars publiceras det i Alla företagsfeed. |
Gilla meddelande
Den här åtgärden används för att gilla det angivna meddelandet.
Parametrar
| Namn | Nyckel | Krävs | Typ | Beskrivning |
|---|---|---|---|---|
|
Meddelande-ID
|
message_id | True | string |
Unikt ID för meddelandet. |
Hämta alla meddelanden (V2) [INAKTUELL]
Den här åtgärden är inaktuell. Använd Hämta alla meddelanden (V3) i stället.
Den här åtgärden returnerar alla offentliga meddelanden i den inloggade användarens Viva Engage-nätverk. Motsvarar alla konversationer i webbgränssnittet Viva Engage.
Parametrar
| Namn | Nyckel | Krävs | Typ | Beskrivning |
|---|---|---|---|---|
|
Unikt id för nätverket
|
network_id | string |
Nätverks-ID |
|
|
Äldre än
|
older_than | integer |
Returnerar meddelanden som är äldre än det meddelande-ID som anges som en numerisk sträng. Detta är användbart för sidnumrering av meddelanden. Om du till exempel för närvarande visar 20 meddelanden och den äldsta är nummer 2912 kan du lägga till "?older_than=2912" i din begäran för att hämta de 20 meddelandena innan du ser dem. |
|
|
Nyare än
|
newer_than | integer |
Returnerar meddelanden som är nyare än det meddelande-ID som anges som en numerisk sträng. Detta bör användas när du söker efter nya meddelanden. Om du tittar på meddelanden och det senaste meddelandet som returneras är 3516 kan du göra en begäran med parametern "?newer_than=3516" för att säkerställa att du inte får duplicerade kopior av meddelanden som redan finns på sidan. |
|
|
Trådtyp för meddelanden
|
threaded | string |
Threaded=true returnerar bara trådstarten (första meddelandet) för varje tråd. Den här parametern är avsedd för appar som behöver visa meddelandetrådar som har komprimerats. threaded=extended returnerar trådstartmeddelandena och de två senaste meddelandena som alla sorteras efter aktivitet, eftersom de visas i standardvyn i Webbgränssnittet för Viva Engage. |
|
|
Limit
|
limit | integer |
Returnera endast det angivna antalet meddelanden. |
Returnerar
Lista över ett eller flera meddelanden.
- Meddelandelista
- PageableMessageList
Hämta alla meddelanden (V3)
Den här åtgärden returnerar alla offentliga meddelanden i den inloggade användarens Viva Engage-nätverk. Motsvarar alla konversationer i webbgränssnittet Viva Engage.
Parametrar
| Namn | Nyckel | Krävs | Typ | Beskrivning |
|---|---|---|---|---|
|
Unikt id för nätverket
|
network_id | string |
Nätverks-ID |
|
|
Äldre än
|
older_than | integer |
Returnerar meddelanden som är äldre än det meddelande-ID som anges som en numerisk sträng. Detta är användbart för sidnumrering av meddelanden. Om du till exempel för närvarande visar 20 meddelanden och den äldsta är nummer 2912 kan du lägga till "?older_than=2912" i din begäran för att hämta de 20 meddelandena innan du ser dem. |
|
|
Nyare än
|
newer_than | integer |
Returnerar meddelanden som är nyare än det meddelande-ID som anges som en numerisk sträng. Detta bör användas när du söker efter nya meddelanden. Om du tittar på meddelanden och det senaste meddelandet som returneras är 3516 kan du göra en begäran med parametern "?newer_than=3516" för att säkerställa att du inte får duplicerade kopior av meddelanden som redan finns på sidan. |
|
|
Trådtyp för meddelanden
|
threaded | string |
Threaded=true returnerar bara trådstarten (första meddelandet) för varje tråd. Den här parametern är avsedd för appar som behöver visa meddelandetrådar som har komprimerats. threaded=extended returnerar trådstartmeddelandena och de två senaste meddelandena som alla sorteras efter aktivitet, eftersom de visas i standardvyn i Webbgränssnittet för Viva Engage. |
|
|
Limit
|
limit | integer |
Returnera endast det angivna antalet meddelanden. |
Returnerar
Lista över ett eller flera meddelanden.
- Meddelandelista
- PageableMessageListV2
Hämta alla meddelanden [INAKTUELL]
Den här åtgärden är inaktuell. Använd Hämta alla meddelanden (V3) i stället.
Den här åtgärden returnerar alla offentliga meddelanden i den inloggade användarens Viva Engage-nätverk. Motsvarar alla konversationer i Yammer-webbgränssnittet.
Parametrar
| Namn | Nyckel | Krävs | Typ | Beskrivning |
|---|---|---|---|---|
|
Unikt id för nätverket
|
network_id | string |
Nätverks-ID |
|
|
Äldre än
|
older_than | integer |
Returnerar meddelanden som är äldre än det meddelande-ID som anges som en numerisk sträng. Detta är användbart för sidnumrering av meddelanden. Om du till exempel för närvarande visar 20 meddelanden och den äldsta är nummer 2912 kan du lägga till "?older_than=2912" i din begäran för att hämta de 20 meddelandena innan du ser dem. |
|
|
Nyare än
|
newer_than | integer |
Returnerar meddelanden som är nyare än det meddelande-ID som anges som en numerisk sträng. Detta bör användas när du söker efter nya meddelanden. Om du tittar på meddelanden och det senaste meddelandet som returneras är 3516 kan du göra en begäran med parametern "?newer_than=3516" för att säkerställa att du inte får duplicerade kopior av meddelanden som redan finns på sidan. |
|
|
Limit
|
limit | integer |
Returnera endast det angivna antalet meddelanden. |
|
|
Sida
|
page | integer |
Hämta den angivna sidan. Om returnerade data är större än gränsen kan du använda det här fältet för att komma åt efterföljande sidor |
Returnerar
Lista över ett eller flera meddelanden.
- Meddelandelista
- MessageList
Hämta användarinformation
Den här åtgärden returnerar användarprofilinformation.
Parametrar
| Namn | Nyckel | Krävs | Typ | Beskrivning |
|---|---|---|---|---|
|
Användar-ID
|
user_id | True | integer |
Unik identifierare för användaren. |
Returnerar
Egenskaper för Viva Engage-användare.
- User
- User
Hämta grupper
Hämtar alla grupper. Om min = 1 hämtar du endast grupper som användaren tillhör
Parametrar
| Namn | Nyckel | Krävs | Typ | Beskrivning |
|---|---|---|---|---|
|
Nätverks-ID
|
network_id | string |
Nätverks-ID |
|
|
gruva
|
mine | integer |
Används för att hämta grupper som användaren ingår i |
|
|
Visa alla företagsgrupper
|
showAllCompanyGroup | integer |
Används för att visa alla företagsgrupper |
Returnerar
- response
- array of YammmerEntity
Hämta meddelanden i en grupp (V2) [INAKTUELL]
Den här åtgärden är inaktuell. Använd Hämta meddelanden i en grupp (V3) i stället.
Den här åtgärden returnerar meddelandena som publiceras i en grupp.
Parametrar
| Namn | Nyckel | Krävs | Typ | Beskrivning |
|---|---|---|---|---|
|
Nätverks-ID
|
network_id | string |
Unikt ID för nätverket. |
|
|
grupp-id
|
group_id | True | integer |
Unik identifierare för gruppen. |
|
Äldre än
|
older_than | integer |
Returnerar meddelanden som är äldre än det meddelande-ID som anges som en numerisk sträng. Detta är användbart för sidnumrering av meddelanden. Om du till exempel för närvarande visar 20 meddelanden och den äldsta är nummer 2912 kan du lägga till "?older_than=2912" i din begäran för att hämta de 20 meddelandena innan du ser dem. |
|
|
Nyare än
|
newer_than | integer |
Returnerar meddelanden som är nyare än det meddelande-ID som anges som en numerisk sträng. Detta bör användas när du söker efter nya meddelanden. Om du tittar på meddelanden och det senaste meddelandet som returneras är 3516 kan du göra en begäran med parametern "?newer_than=3516" för att säkerställa att du inte får duplicerade kopior av meddelanden som redan finns på sidan. |
|
|
Trådtyp för meddelanden
|
threaded | string |
Threaded=true returnerar bara trådstarten (första meddelandet) för varje tråd. Den här parametern är avsedd för appar som behöver visa meddelandetrådar som har komprimerats. threaded=extended returnerar trådstartmeddelandena och de två senaste meddelandena som alla sorteras efter aktivitet, eftersom de visas i standardvyn i Webbgränssnittet för Viva Engage. |
|
|
Limit
|
limit | integer |
Returnera endast det angivna antalet meddelanden. |
Returnerar
Lista över ett eller flera meddelanden.
- Meddelandelista
- PageableMessageList
Hämta meddelanden i en grupp (V3)
Den här åtgärden returnerar meddelandena som publiceras i en grupp.
Parametrar
| Namn | Nyckel | Krävs | Typ | Beskrivning |
|---|---|---|---|---|
|
Nätverks-ID
|
network_id | string |
Unikt ID för nätverket. |
|
|
grupp-id
|
group_id | True | integer |
Unik identifierare för gruppen. |
|
Äldre än
|
older_than | integer |
Returnerar meddelanden i trådar där trådens senaste meddelande är äldre än det angivna meddelande-ID:t. Alla trådar med ett senaste meddelande-ID som är nyare än eller lika med det angivna ID:t kommer inte att ha något av dess meddelanden som returneras av den här frågan. |
|
|
Nyare än
|
newer_than | integer |
Returnerar meddelanden i trådar där trådens senaste meddelande är nyare än det angivna meddelande-ID:t. Alla trådar med ett senaste meddelande-ID som är äldre än eller lika med det angivna ID:t kommer inte att ha något av dess meddelanden som returneras av den här frågan. |
|
|
Trådtyp för meddelanden
|
threaded | string |
Threaded=true returnerar bara trådstarten (första meddelandet) för varje tråd. Den här parametern är avsedd för appar som behöver visa meddelandetrådar som har komprimerats. threaded=extended returnerar trådstartmeddelandena och de två senaste meddelandena som alla sorteras efter aktivitet, eftersom de visas i standardvyn i Webbgränssnittet för Viva Engage. |
|
|
Limit
|
limit | integer |
Returnera endast det angivna antalet meddelanden. |
Returnerar
Lista över ett eller flera meddelanden.
- Meddelandelista
- PageableMessageListV2
Hämta meddelanden i en grupp [INAKTUELL]
Den här åtgärden är inaktuell. Använd Hämta meddelanden i en grupp (V3) i stället.
Den här åtgärden returnerar meddelandena som publiceras i en grupp.
Parametrar
| Namn | Nyckel | Krävs | Typ | Beskrivning |
|---|---|---|---|---|
|
Nätverks-ID
|
network_id | string |
Unikt ID för nätverket. |
|
|
grupp-id
|
group_id | True | integer |
Unik identifierare för gruppen. |
|
Äldre än
|
older_than | integer |
Returnerar meddelanden som är äldre än det meddelande-ID som anges som en numerisk sträng. Detta är användbart för sidnumrering av meddelanden. Om du till exempel för närvarande visar 20 meddelanden och den äldsta är nummer 2912 kan du lägga till "?older_than=2912" i din begäran för att hämta de 20 meddelandena innan du ser dem. |
|
|
Nyare än
|
newer_than | integer |
Returnerar meddelanden som är nyare än det meddelande-ID som anges som en numerisk sträng. Detta bör användas när du söker efter nya meddelanden. Om du tittar på meddelanden och det senaste meddelandet som returneras är 3516 kan du göra en begäran med parametern "?newer_than=3516" för att säkerställa att du inte får duplicerade kopior av meddelanden som redan finns på sidan. |
|
|
Limit
|
limit | integer |
Returnera endast det angivna antalet meddelanden. |
|
|
Sida
|
page | integer |
Hämta den angivna sidan. Om returnerade data är större än gränsen kan du använda det här fältet för att komma åt efterföljande sidor |
Returnerar
Lista över ett eller flera meddelanden.
- Meddelandelista
- MessageList
Hämta meddelanden i en tråd (V2) [INAKTUELL]
Den här åtgärden är inaktuell. Använd Hämta meddelanden i en tråd (V3) i stället.
Den här åtgärden returnerar meddelandena som publiceras i en tråd.
Parametrar
| Namn | Nyckel | Krävs | Typ | Beskrivning |
|---|---|---|---|---|
|
Tråd-ID
|
thread_id | True | integer |
Unik identifierare för tråden. |
Returnerar
Lista över ett eller flera meddelanden.
- Meddelandelista
- PageableMessageList
Hämta meddelanden i en tråd (V3)
Den här åtgärden returnerar meddelandena som publiceras i en tråd.
Parametrar
| Namn | Nyckel | Krävs | Typ | Beskrivning |
|---|---|---|---|---|
|
Tråd-ID
|
thread_id | True | integer |
Unik identifierare för tråden. |
Returnerar
Lista över ett eller flera meddelanden.
- Meddelandelista
- PageableMessageListV2
Hämta meddelanden i en tråd [INAKTUELL]
Den här åtgärden är inaktuell. Använd Hämta meddelanden i en tråd (V3) i stället.
Den här åtgärden returnerar meddelandena som publiceras i en tråd.
Parametrar
| Namn | Nyckel | Krävs | Typ | Beskrivning |
|---|---|---|---|---|
|
Tråd-ID
|
thread_id | True | integer |
Unik identifierare för tråden. |
Returnerar
Lista över ett eller flera meddelanden.
- Meddelandelista
- MessageList
Hämta meddelandena från följande feed [INAKTUELL]
Den här åtgärden är inaktuell. Använd Hämta meddelanden från min Följande feed (V3) i stället.
Den här åtgärden returnerar meddelandena från Följande feed, vilket är konversationer som involverar personer, grupper och ämnen som användaren följer.
Parametrar
| Namn | Nyckel | Krävs | Typ | Beskrivning |
|---|---|---|---|---|
|
Nätverks-ID
|
network_id | string |
Unikt ID för nätverket. |
|
|
Äldre än
|
older_than | integer |
Returnerar meddelanden som är äldre än det meddelande-ID som anges som en numerisk sträng. Detta är användbart för sidnumrering av meddelanden. Om du till exempel för närvarande visar 20 meddelanden och den äldsta är nummer 2912 kan du lägga till "?older_than=2912" i din begäran för att hämta de 20 meddelandena innan du ser dem. |
|
|
Nyare än
|
newer_than | integer |
Returnerar meddelanden som är nyare än det meddelande-ID som anges som en numerisk sträng. Detta bör användas när du söker efter nya meddelanden. Om du tittar på meddelanden och det senaste meddelandet som returneras är 3516 kan du göra en begäran med parametern "?newer_than=3516" för att säkerställa att du inte får duplicerade kopior av meddelanden som redan finns på sidan. |
|
|
Limit
|
limit | integer |
Returnera endast det angivna antalet meddelanden. |
|
|
Sida
|
page | integer |
Hämta den angivna sidan. Om returnerade data är större än gränsen kan du använda det här fältet för att komma åt efterföljande sidor |
Returnerar
Lista över ett eller flera meddelanden.
- Meddelandelista
- MessageList
Hämta meddelandena från min Följande feed (V2) [INAKTUELL]
Den här åtgärden är inaktuell. Använd Hämta meddelanden från min Följande feed (V3) i stället.
Den här åtgärden returnerar meddelandena från Följande feed, vilket är konversationer som involverar personer, grupper och ämnen som användaren följer.
Parametrar
| Namn | Nyckel | Krävs | Typ | Beskrivning |
|---|---|---|---|---|
|
Nätverks-ID
|
network_id | string |
Unikt ID för nätverket. |
|
|
Äldre än
|
older_than | integer |
Returnerar meddelanden som är äldre än det meddelande-ID som anges som en numerisk sträng. Detta är användbart för sidnumrering av meddelanden. Om du till exempel för närvarande visar 20 meddelanden och den äldsta är nummer 2912 kan du lägga till "?older_than=2912" i din begäran för att hämta de 20 meddelandena innan du ser dem. |
|
|
Nyare än
|
newer_than | integer |
Returnerar meddelanden som är nyare än det meddelande-ID som anges som en numerisk sträng. Detta bör användas när du söker efter nya meddelanden. Om du tittar på meddelanden och det senaste meddelandet som returneras är 3516 kan du göra en begäran med parametern "?newer_than=3516" för att säkerställa att du inte får duplicerade kopior av meddelanden som redan finns på sidan. |
|
|
Trådtyp för meddelanden
|
threaded | string |
Threaded=true returnerar bara trådstarten (första meddelandet) för varje tråd. Den här parametern är avsedd för appar som behöver visa meddelandetrådar som har komprimerats. threaded=extended returnerar trådstartmeddelandena och de två senaste meddelandena som alla sorteras efter aktivitet, eftersom de visas i standardvyn i Webbgränssnittet för Viva Engage. |
|
|
Limit
|
limit | integer |
Returnera endast det angivna antalet meddelanden. |
Returnerar
Lista över ett eller flera meddelanden.
- Meddelandelista
- PageableMessageList
Hämta meddelandena från min följande feed (V3)
Den här åtgärden returnerar meddelandena från Följande feed, vilket är konversationer som involverar personer, grupper och ämnen som användaren följer.
Parametrar
| Namn | Nyckel | Krävs | Typ | Beskrivning |
|---|---|---|---|---|
|
Nätverks-ID
|
network_id | string |
Unikt ID för nätverket. |
|
|
Äldre än
|
older_than | integer |
Returnerar meddelanden som är äldre än det meddelande-ID som anges som en numerisk sträng. Detta är användbart för sidnumrering av meddelanden. Om du till exempel för närvarande visar 20 meddelanden och den äldsta är nummer 2912 kan du lägga till "?older_than=2912" i din begäran för att hämta de 20 meddelandena innan du ser dem. |
|
|
Nyare än
|
newer_than | integer |
Returnerar meddelanden som är nyare än det meddelande-ID som anges som en numerisk sträng. Detta bör användas när du söker efter nya meddelanden. Om du tittar på meddelanden och det senaste meddelandet som returneras är 3516 kan du göra en begäran med parametern "?newer_than=3516" för att säkerställa att du inte får duplicerade kopior av meddelanden som redan finns på sidan. |
|
|
Trådtyp för meddelanden
|
threaded | string |
Threaded=true returnerar bara trådstarten (första meddelandet) för varje tråd. Den här parametern är avsedd för appar som behöver visa meddelandetrådar som har komprimerats. threaded=extended returnerar trådstartmeddelandena och de två senaste meddelandena som alla sorteras efter aktivitet, eftersom de visas i standardvyn i Webbgränssnittet för Viva Engage. |
|
|
Limit
|
limit | integer |
Returnera endast det angivna antalet meddelanden. |
Returnerar
Lista över ett eller flera meddelanden.
- Meddelandelista
- PageableMessageListV2
Hämta mina nätverk
Publicera meddelande (V2)
Den här åtgärden används för att publicera ett meddelande till en grupp eller alla företagsfeed. Om grupp-ID anges publiceras meddelandet till den angivna gruppen, annars publiceras det i Alla företagsfeed.
Parametrar
| Namn | Nyckel | Krävs | Typ | Beskrivning |
|---|---|---|---|---|
|
Nätverks-ID
|
network_id | string |
Unikt ID för nätverket. |
|
|
grupp-id
|
group_id | True | integer |
Gruppen som ska skicka ett meddelande till (0 = Alla företag/nätverk). |
|
Meddelandetext
|
body | True | string |
Meddelandet som ska publiceras i nätverket. |
|
Svarade på ID
|
replied_to_id | integer |
Meddelande-ID:t som det här meddelandet svarar på. |
|
|
Direkt till ID
|
direct_to_id | integer |
Om det anges skickas ett privat meddelande direkt till användaren med det angivna ID:t. |
|
|
Sändning
|
broadcast | boolean |
Publicera meddelandet som ett meddelande till alla användare i en grupp. |
|
|
Titel
|
title | string |
Rubriken på meddelandet som ska publiceras. |
Returnerar
Lista över ett eller flera meddelanden.
- Meddelandelista
- MessageListV2
Publicera meddelandet [INAKTUELL]
Den här åtgärden används för att publicera ett meddelande till en grupp eller alla företagsfeed. Om grupp-ID anges publiceras meddelandet till den angivna gruppen, annars publiceras det i Alla företagsfeed.
Parametrar
| Namn | Nyckel | Krävs | Typ | Beskrivning |
|---|---|---|---|---|
|
Nätverks-ID
|
network_id | string |
Unikt ID för nätverket. |
|
|
grupp-id
|
group_id | True | integer |
Gruppen som ska skicka ett meddelande till (0 = Alla företag/nätverk). |
|
Meddelandetext
|
body | True | string |
Meddelandet som ska publiceras i nätverket. |
|
Svarade på ID
|
replied_to_id | integer |
Meddelande-ID:t som det här meddelandet svarar på. |
|
|
Direkt till ID
|
direct_to_id | integer |
Om det anges skickas ett privat meddelande direkt till användaren med det angivna ID:t. |
|
|
Sändning
|
broadcast | boolean |
Publicera meddelandet som ett meddelande till alla användare i en grupp. |
|
|
Titel
|
title | string |
Rubriken på meddelandet som ska publiceras. |
|
|
Ämne 1
|
topic1 | string |
Ämne som ska tillämpas på meddelandet. |
|
|
Ämne 2
|
topic2 | string |
Ämne som ska tillämpas på meddelandet |
|
|
Ämne 3
|
topic3 | string |
Ämne som ska tillämpas på meddelandet. |
|
|
Ämne 4
|
topic4 | string |
Ämne som ska tillämpas på meddelandet |
|
|
Ämne 5
|
topic5 | string |
Ämne som ska tillämpas på meddelandet. |
|
|
Ämne 6
|
topic6 | string |
Ämne som ska tillämpas på meddelandet. |
|
|
Ämne 7
|
topic7 | string |
Ämne som ska tillämpas på meddelandet |
|
|
Ämne 8
|
topic8 | string |
Ämne som ska tillämpas på meddelandet. |
|
|
Ämne 9
|
topic9 | string |
Ämne som ska tillämpas på meddelandet. |
|
|
Ämne 10
|
topic10 | string |
Ämne som ska tillämpas på meddelandet. |
|
|
Ämne 11
|
topic11 | string |
Ämne som ska tillämpas på meddelandet. |
|
|
Ämne 12
|
topic12 | string |
Ämne som ska tillämpas på meddelandet. |
|
|
Ämne 13
|
topic13 | string |
Ämne som ska tillämpas på meddelandet. |
|
|
Ämne 14
|
topic14 | string |
Ämne som ska tillämpas på meddelandet. |
|
|
Ämne 15
|
topic15 | string |
Ämne som ska tillämpas på meddelandet. |
|
|
Ämne 16
|
topic16 | string |
Ämne som ska tillämpas på meddelandet. |
|
|
Ämne 17
|
topic17 | string |
Ämne som ska tillämpas på meddelandet. |
|
|
Ämne 18
|
topic18 | string |
Ämne som ska tillämpas på meddelandet. |
|
|
Ämne 19
|
topic19 | string |
Ämne som ska tillämpas på meddelandet. |
|
|
Ämne 20
|
topic20 | string |
Ämne som ska tillämpas på meddelandet. |
Returnerar
Lista över ett eller flera meddelanden.
- Meddelandelista
- MessageList
Utlösare
| När det finns ett nytt meddelande i en grupp (V2) |
Den här åtgärden utlöses när ett nytt meddelande publiceras i en grupp. |
| När det finns ett nytt meddelande i en grupp [INAKTUELL] |
Den här åtgärden är inaktuell. Använd När det finns ett nytt meddelande i en grupp (V2) i stället.
|
| När det finns ett nytt meddelande i mitt följt flöde (V2) |
Den här åtgärden utlöses när det finns ett nytt meddelande i ett nätverk följt av dig. |
| När det finns ett nytt meddelande i mitt följt flöde [INAKTUELL] |
Den här åtgärden är inaktuell. Använd När det finns ett nytt meddelande i mitt följt flöde (V2) i stället.
|
När det finns ett nytt meddelande i en grupp (V2)
Den här åtgärden utlöses när ett nytt meddelande publiceras i en grupp.
Parametrar
| Namn | Nyckel | Krävs | Typ | Beskrivning |
|---|---|---|---|---|
|
Nätverks-ID
|
network_id | string |
Unikt identifer för nätverket. |
|
|
Grupp-ID
|
group_id | True | integer |
Unik identifierare för gruppen. |
Returnerar
Lista över ett eller flera meddelanden.
- Meddelandelista
- MessageListV2
När det finns ett nytt meddelande i en grupp [INAKTUELL]
Den här åtgärden är inaktuell. Använd När det finns ett nytt meddelande i en grupp (V2) i stället.
Den här åtgärden utlöses när ett nytt meddelande publiceras i en grupp.
Parametrar
| Namn | Nyckel | Krävs | Typ | Beskrivning |
|---|---|---|---|---|
|
Nätverks-ID
|
network_id | string |
Unikt identifer för nätverket. |
|
|
Grupp-ID
|
group_id | True | integer |
Unik identifierare för gruppen. |
Returnerar
Lista över ett eller flera meddelanden.
- Meddelandelista
- MessageList
När det finns ett nytt meddelande i mitt följt flöde (V2)
Den här åtgärden utlöses när det finns ett nytt meddelande i ett nätverk följt av dig.
Parametrar
| Namn | Nyckel | Krävs | Typ | Beskrivning |
|---|---|---|---|---|
|
Nätverks-ID
|
network_id | string |
Välj ett nätverk. |
Returnerar
Lista över ett eller flera meddelanden.
- Meddelandelista
- MessageListV2
När det finns ett nytt meddelande i mitt följt flöde [INAKTUELL]
Den här åtgärden är inaktuell. Använd När det finns ett nytt meddelande i mitt följt flöde (V2) i stället.
Den här åtgärden utlöses när det finns ett nytt meddelande i ett nätverk följt av dig.
Parametrar
| Namn | Nyckel | Krävs | Typ | Beskrivning |
|---|---|---|---|---|
|
Nätverks-ID
|
network_id | string |
Välj ett nätverk. |
Returnerar
Lista över ett eller flera meddelanden.
- Meddelandelista
- MessageList
Definitioner
User
Egenskaper för Viva Engage-användare.
| Namn | Stig | Typ | Beskrivning |
|---|---|---|---|
|
Användarnamn
|
name | string |
Användarnamn. |
|
Befattning
|
job_title | string |
Befattning för användarjobb. |
|
Plats
|
location | string |
Användarplats. |
|
Fullständigt namn
|
full_name | string |
Användarens fullständiga namn. |
|
Förnamn
|
first_name | string |
Användarens förnamn. |
|
Efternamn
|
last_name | string |
Användarnamn. |
|
Profil-URL
|
web_url | string |
Url för användarprofil. |
|
E-postmeddelande
|
string |
Användarens e-post. |
|
|
Födelsedatum
|
birth_date | string |
Användarens födelsedatum. |
|
Foto-URL
|
mugshot_url | string |
Url för användarfoto. |
Message
Egenskaper för ett enda Viva Engage-meddelande.
| Namn | Stig | Typ | Beskrivning |
|---|---|---|---|
|
ID-nummer
|
id | integer |
ID som är associerat med inlägget. |
|
Text
|
content_excerpt | string |
Textinnehåll i inlägget. |
|
Avsändare
|
sender_id | integer |
Unikt ID för användare som publicerade meddelandet. |
|
Svarade på
|
replied_to_id | integer |
ID för meddelandet som det här meddelandet är ett svar på. |
|
Skapad vid
|
created_at | string |
Tidpunkt då meddelandet skapades. |
|
Nätverk
|
network_id | integer |
ID för nätverksmeddelandet är associerat med. |
|
Typ
|
message_type | string |
Beskrivning av meddelandetypen. |
|
Avsändartyp
|
sender_type | string |
Beskrivning av typen av avsändare. |
|
URL
|
url | uri |
API-URL för inlägget. |
|
Webb-URL
|
web_url | uri |
Webb-URL för inlägget. |
|
grupp-id
|
group_id | integer |
Unikt ID för gruppen som publicerade meddelandet. |
|
Meddelandetext
|
body | MessageBody |
Innehåll som är associerat med ett enda meddelande. |
|
Tråd-ID
|
thread_id | integer |
Unikt ID för tråd. |
|
Direktmeddelande
|
direct_message | boolean |
Flagga för att ange om inlägget är ett direktmeddelande. |
|
Klient-ID
|
client_type | string |
Typ av klient. |
|
Klient-URL
|
client_url | uri |
Webblänk för klienten. |
|
Language
|
language | string |
Språk som används i meddelandet. |
|
Taggad användare
|
notified_user_ids | array of integer |
Information om användare som meddelas. |
|
Privatliv
|
privacy | string |
Information om den sekretess som är associerad med meddelandet. |
|
liked_by
|
liked_by | LikedBy |
Gillad av |
|
Är systemmeddelande
|
system_message | boolean |
Flagga för att ange om inlägget är ett systemgenererat meddelande eller inte. |
|
Ämnen
|
topics | array of Topic |
Lista över ämnen. |
MessageV2
Egenskaper för ett enda Viva Engage-meddelande.
| Namn | Stig | Typ | Beskrivning |
|---|---|---|---|
|
ID-nummer
|
id | integer |
ID som är associerat med inlägget. |
|
Text
|
content_excerpt | string |
Textinnehåll i inlägget. |
|
Avsändare
|
sender_id | integer |
Unikt ID för användare som publicerade meddelandet. |
|
Svarade på
|
replied_to_id | integer |
ID för meddelandet som det här meddelandet är ett svar på. |
|
Skapad vid
|
created_at | string |
Tidpunkt då meddelandet skapades. |
|
Nätverk
|
network_id | integer |
ID för nätverksmeddelandet är associerat med. |
|
Typ
|
message_type | string |
Beskrivning av meddelandetypen. |
|
Avsändartyp
|
sender_type | string |
Beskrivning av typen av avsändare. |
|
URL
|
url | uri |
API-URL för inlägget. |
|
Webb-URL
|
web_url | uri |
Webb-URL för inlägget. |
|
grupp-id
|
group_id | integer |
Unikt ID för gruppen som publicerade meddelandet. |
|
Meddelandetext
|
body | MessageBody |
Innehåll som är associerat med ett enda meddelande. |
|
Tråd-ID
|
thread_id | integer |
Unikt ID för tråd. |
|
Direktmeddelande
|
direct_message | boolean |
Flagga för att ange om inlägget är ett direktmeddelande. |
|
Klient-ID
|
client_type | string |
Typ av klient. |
|
Klient-URL
|
client_url | uri |
Webblänk för klienten. |
|
Language
|
language | string |
Språk som används i meddelandet. |
|
Taggad användare
|
notified_user_ids | array of integer |
Information om användare som meddelas. |
|
Privatliv
|
privacy | string |
Information om den sekretess som är associerad med meddelandet. |
|
liked_by
|
liked_by | LikedBy |
Gillad av |
|
Är systemmeddelande
|
system_message | boolean |
Flagga för att ange om inlägget är ett systemgenererat meddelande eller inte. |
Ämne
Egenskaper för ett enskilt ämne.
| Namn | Stig | Typ | Beskrivning |
|---|---|---|---|
|
ID-nummer
|
id | integer |
Unik identifierare för ämnet. |
|
Namn
|
name | string |
Namnet på ämnet. |
PageableMessageList
Lista över ett eller flera meddelanden.
| Namn | Stig | Typ | Beskrivning |
|---|---|---|---|
|
Messages
|
value | array of Message |
PageableMessageListV2
Lista över ett eller flera meddelanden.
| Namn | Stig | Typ | Beskrivning |
|---|---|---|---|
|
Messages
|
value | array of MessageV2 |
MessageList
Lista över ett eller flera meddelanden.
| Namn | Stig | Typ | Beskrivning |
|---|---|---|---|
|
Messages
|
messages | array of Message |
messages |
MessageListV2
Lista över ett eller flera meddelanden.
| Namn | Stig | Typ | Beskrivning |
|---|---|---|---|
|
Messages
|
messages | array of MessageV2 |
messages |
MessageBody
Innehåll som är associerat med ett enda meddelande.
| Namn | Stig | Typ | Beskrivning |
|---|---|---|---|
|
Text
|
parsed | string |
Tolkat textformat. |
|
Slätt
|
plain | string |
Format för oformaterad text. |
|
Rik
|
rich | string |
RTF-format. |
LikedBy
Gillad av
| Namn | Stig | Typ | Beskrivning |
|---|---|---|---|
|
Räkna
|
count | integer |
Antal distinkta likes. |
|
Names
|
names | array of object |
Lista över personer som gillade inlägget. |
|
Fullständigt namn
|
names.full_name | string |
Det fullständiga namnet på den person som gillade inlägget. |
Nätverk
Egenskaper för ett enda nätverk.
| Namn | Stig | Typ | Beskrivning |
|---|---|---|---|
|
ID-nummer
|
id | string |
Unikt ID för nätverket. |
|
Namn
|
name | string |
Sammanfattning av nätverket. |
|
Länk
|
permalink | string |
Webblänk till nätverkssidan. |
YammmerEntity
Egenskaper för en enda Viva Engage-entitet.
| Namn | Stig | Typ | Beskrivning |
|---|---|---|---|
|
Description
|
type | string |
Information om Viva Engage-entiteten. |
|
grupp-id
|
id | integer |
Unik identifierare för gruppen. |
|
Fullständigt namn
|
full_name | string |
Namnet på Viva Engage-entiteten. |