Microsoft Viva Engage
Viva Engage is een toonaangevend sociaal netwerk voor bedrijven om slimmer en sneller aan het werk te gaan. Maak verbinding met Viva Engage voor toegang tot gesprekken in uw bedrijfsnetwerk.
Deze connector is beschikbaar in de volgende producten en regio's:
| Dienst | Class | Regions |
|---|---|---|
| Copilot Studio | Standaard | Alle Power Automate-regio's , met uitzondering van het volgende: - Amerikaanse overheid (GCC) - Amerikaanse overheid (GCC High) - China Cloud beheerd door 21Vianet - Us Department of Defense (DoD) |
| Logic-apps | Standaard | Alle Logic Apps-regio's , met uitzondering van het volgende: - Azure Government-regio's - Azure China-regio's - Us Department of Defense (DoD) |
| Power Apps | Standaard | Alle Power Apps-regio's , met uitzondering van het volgende: - Amerikaanse overheid (GCC) - Amerikaanse overheid (GCC High) - China Cloud beheerd door 21Vianet - Us Department of Defense (DoD) |
| Power Automate | Standaard | Alle Power Automate-regio's , met uitzondering van het volgende: - Amerikaanse overheid (GCC) - Amerikaanse overheid (GCC High) - China Cloud beheerd door 21Vianet - Us Department of Defense (DoD) |
| Contactpersoon | |
|---|---|
| Naam | Microsoft |
| URL | https://microsoft.com |
| Connectormetagegevens | |
|---|---|
| Uitgever | Microsoft |
| Webpagina | https://products.office.com/yammer/yammer-overview |
| Privacybeleid | https://privacy.microsoft.com |
| Categorieën | Communication |
Belangrijk
OAuth2-verificatie voor Yammer (Viva Engage) wordt binnenkort afgeschaft.
- Nieuwe verbindingen moeten de Entra ID-verificatie gebruiken vanaf 1 september.
- Bestaande OAuth2-verbindingen blijven werken tot 15 november 2025.
Schakel vóór 15 november 2025 uw verbindingen over naar Entra ID-verificatie om onderbrekingen te voorkomen.
Bekende problemen en beperkingen
De volgende acties en triggers garanderen niet dat alle berichten worden geretourneerd vanwege beperkingen van de Viva Engage REST API:
- Alle berichten ophalen
- Berichten in een groep ophalen
- Berichten ophalen in een thread
- De berichten ophalen uit mijn volgende feed
- Wanneer er een nieuw bericht in een groep is
- Wanneer er een nieuw bericht in mijn gevolgde feed staat
De volgende actie kan maximaal 100 groepen retourneren vanwege beperkingen van de Viva Engage REST API:
- Groepen ophalen
Opmerking
De Viva Engage-API kan het aantal geretourneerde berichten beperken. Als dit het geval is, raadpleegt u om deze limiet te omzeilen, naar Alle berichten in een Yammer-groep ophalen met behulp van Microsoft Flow. Ga voor meer informatie over Viva Engage API-limieten naar Yammer API-frequentielimieten.
De volgende acties en triggers werken mogelijk niet met alle bedrijfsgroepen , vanwege de beperkingen van de Viva Engage REST API:
- Berichten in een groep ophalen
- Berichten ophalen in een groep (V2)
- Wanneer er een nieuw bericht in een groep is
De functie Toepassingen van derden moet zijn ingeschakeld in de Yammer-configuratie. Een actieantwoord zoals 'Het antwoord heeft geen JSON-indeling' betekent meestal dat de functie is uitgeschakeld.
Met de volgende acties kunt u na het instellen van de bijbehorende geavanceerde parameters een bericht 'Aankondiging' maken met een bericht 'Aankondiging'. Dit bericht kan echter niet worden bewerkt in de Viva Engage-gebruikersinterface. Viva Engage is op de hoogte van dit probleem en zal dit probleem in een toekomstige update oplossen.
- PostMessage
- PostMessageV2
Een verbinding maken
De connector ondersteunt de volgende verificatietypen:
| Aanmelden met Microsoft Entra-id | Aanmelden met Microsoft Entra-id | Alle regio's | Niet deelbaar |
| Standaard [AFGESCHAFT] | Deze optie is alleen bedoeld voor oudere verbindingen zonder expliciet verificatietype en is alleen beschikbaar voor compatibiliteit met eerdere versies. | Alle regio's | Niet deelbaar |
Aanmelden met Microsoft Entra-id
Verificatie-id: entraIDUserLogin
Van toepassing: Alle regio's
Aanmelden met Microsoft Entra-id
Dit is geen deelbare verbinding. Als de power-app wordt gedeeld met een andere gebruiker, wordt een andere gebruiker gevraagd om expliciet een nieuwe verbinding te maken.
Standaard [AFGESCHAFT]
Van toepassing: Alle regio's
Deze optie is alleen bedoeld voor oudere verbindingen zonder expliciet verificatietype en is alleen beschikbaar voor compatibiliteit met eerdere versies.
Dit is geen deelbare verbinding. Als de power-app wordt gedeeld met een andere gebruiker, wordt een andere gebruiker gevraagd om expliciet een nieuwe verbinding te maken.
Beperkingslimieten
| Name | Aanroepen | Verlengingsperiode |
|---|---|---|
| API-aanroepen per verbinding | 100 | 60 seconden |
| Frequentie van trigger-polls | 1 | 15 seconden |
Acties
| Alle berichten ophalen (V2) [AFGESCHAFT] |
Deze actie is afgeschaft. Gebruik in plaats daarvan Alle berichten ophalen (V3 ).
|
| Alle berichten ophalen (V3) |
Deze bewerking retourneert alle openbare berichten in het aangemelde Viva Engage-netwerk van de gebruiker. Komt overeen met alle gesprekken in de Viva Engage-webinterface. |
| Alle berichten ophalen [AFGESCHAFT] |
Deze actie is afgeschaft. Gebruik in plaats daarvan Alle berichten ophalen (V3 ).
|
| Bericht leuk vinden |
Deze bewerking wordt gebruikt om het opgegeven bericht leuk te vinden. |
| Bericht plaatsen (V2) |
Deze bewerking wordt gebruikt om een bericht te posten op een groep of alle bedrijfsfeeds. Als de groeps-id is opgegeven, wordt het bericht in de opgegeven groep geplaatst, anders wordt het bericht in alle bedrijfsfeeds geplaatst. |
| Bericht posten [AFGESCHAFT] |
Deze bewerking wordt gebruikt om een bericht te posten op een groep of alle bedrijfsfeeds. Als de groeps-id is opgegeven, wordt het bericht in de opgegeven groep geplaatst, anders wordt het bericht in alle bedrijfsfeeds geplaatst. |
| Berichten ophalen in een groep (V2) [AFGESCHAFT] |
Deze actie is afgeschaft. Gebruik in plaats daarvan Berichten ophalen in een groep (V3 ).
|
| Berichten ophalen in een groep (V3) |
Met deze bewerking worden de berichten geretourneerd die in een groep zijn geplaatst. |
| Berichten ophalen in een groep [AFGESCHAFT] |
Deze actie is afgeschaft. Gebruik in plaats daarvan Berichten ophalen in een groep (V3 ).
|
| Berichten ophalen in een thread (V2) [AFGESCHAFT] |
Deze actie is afgeschaft. Gebruik in plaats daarvan Berichten ophalen in een thread (V3 ).
|
| Berichten ophalen in een thread (V3) |
Met deze bewerking worden de berichten geretourneerd die in een thread zijn geplaatst. |
| Berichten ophalen in een thread [AFGESCHAFT] |
Deze actie is afgeschaft. Gebruik in plaats daarvan Berichten ophalen in een thread (V3 ).
|
| De berichten ophalen uit mijn volgende feed (V3) |
Deze bewerking retourneert de berichten uit de volgende feed. Dit zijn gesprekken met personen, groepen en onderwerpen die de gebruiker volgt. |
| De berichten ophalen uit mijn volgende feed [AFGESCHAFT] |
Deze actie is afgeschaft. Gebruik in plaats daarvan De berichten ophalen uit mijn volgende feed (V3 ).
|
| Gebruikersgegevens ophalen |
Met deze bewerking worden details van gebruikersprofielen geretourneerd. |
| Groepen ophalen |
Hiermee haalt u alle groepen op. Als van mij = 1, krijgt u alleen groepen waartoe de gebruiker behoort |
| Haal de berichten op uit mijn volgende feed (V2) [AFGESCHAFT] |
Deze actie is afgeschaft. Gebruik in plaats daarvan De berichten ophalen uit mijn volgende feed (V3 ).
|
| Mijn netwerken ophalen |
Hiermee haalt u alle netwerken op waartoe de gebruiker behoort. |
Alle berichten ophalen (V2) [AFGESCHAFT]
Deze actie is afgeschaft. Gebruik in plaats daarvan Alle berichten ophalen (V3 ).
Deze bewerking retourneert alle openbare berichten in het aangemelde Viva Engage-netwerk van de gebruiker. Komt overeen met alle gesprekken in de Viva Engage-webinterface.
Parameters
| Name | Sleutel | Vereist | Type | Description |
|---|---|---|---|---|
|
Unieke id van het netwerk
|
network_id | string |
Netwerk-id |
|
|
Ouder dan
|
older_than | integer |
Retourneert berichten die ouder zijn dan de bericht-id die is opgegeven als een numerieke tekenreeks. Dit is handig voor het pagineren van berichten. Als u momenteel bijvoorbeeld 20 berichten bekijkt en het oudste nummer 2912 is, kunt u '?older_than=2912' toevoegen aan uw aanvraag om de 20 berichten te ontvangen voordat u deze ziet. |
|
|
Nieuwer dan
|
newer_than | integer |
Retourneert nieuwere berichten dan de bericht-id die is opgegeven als een numerieke tekenreeks. Dit moet worden gebruikt bij het peilen naar nieuwe berichten. Als u berichten bekijkt en het meest recente bericht dat wordt geretourneerd 3516 is, kunt u een aanvraag indienen met de parameter '?newer_than=3516' om ervoor te zorgen dat u geen dubbele kopieën van berichten op uw pagina krijgt. |
|
|
Threadtype van berichten
|
threaded | string |
Threaded=true retourneert alleen de threadstarter (eerste bericht) voor elke thread. Deze parameter is bedoeld voor apps die berichtenthreads moeten weergeven die zijn samengevouwen. threaded=extended retourneert de thread starter-berichten en de twee meest recente berichten die allemaal op activiteit zijn gerangschikt, omdat ze worden weergegeven in de standaardweergave op de Viva Engage-webinterface. |
|
|
Limit
|
limit | integer |
Alleen het opgegeven aantal berichten retourneren. |
Retouren
Lijst met één of meerdere berichten.
- Berichtenlijst
- PageableMessageList
Alle berichten ophalen (V3)
Deze bewerking retourneert alle openbare berichten in het aangemelde Viva Engage-netwerk van de gebruiker. Komt overeen met alle gesprekken in de Viva Engage-webinterface.
Parameters
| Name | Sleutel | Vereist | Type | Description |
|---|---|---|---|---|
|
Unieke id van het netwerk
|
network_id | string |
Netwerk-id |
|
|
Ouder dan
|
older_than | integer |
Retourneert berichten die ouder zijn dan de bericht-id die is opgegeven als een numerieke tekenreeks. Dit is handig voor het pagineren van berichten. Als u momenteel bijvoorbeeld 20 berichten bekijkt en het oudste nummer 2912 is, kunt u '?older_than=2912' toevoegen aan uw aanvraag om de 20 berichten te ontvangen voordat u deze ziet. |
|
|
Nieuwer dan
|
newer_than | integer |
Retourneert nieuwere berichten dan de bericht-id die is opgegeven als een numerieke tekenreeks. Dit moet worden gebruikt bij het peilen naar nieuwe berichten. Als u berichten bekijkt en het meest recente bericht dat wordt geretourneerd 3516 is, kunt u een aanvraag indienen met de parameter '?newer_than=3516' om ervoor te zorgen dat u geen dubbele kopieën van berichten op uw pagina krijgt. |
|
|
Threadtype van berichten
|
threaded | string |
Threaded=true retourneert alleen de threadstarter (eerste bericht) voor elke thread. Deze parameter is bedoeld voor apps die berichtenthreads moeten weergeven die zijn samengevouwen. threaded=extended retourneert de thread starter-berichten en de twee meest recente berichten die allemaal op activiteit zijn gerangschikt, omdat ze worden weergegeven in de standaardweergave op de Viva Engage-webinterface. |
|
|
Limit
|
limit | integer |
Alleen het opgegeven aantal berichten retourneren. |
Retouren
Lijst met één of meerdere berichten.
- Berichtenlijst
- PageableMessageListV2
Alle berichten ophalen [AFGESCHAFT]
Deze actie is afgeschaft. Gebruik in plaats daarvan Alle berichten ophalen (V3 ).
Deze bewerking retourneert alle openbare berichten in het aangemelde Viva Engage-netwerk van de gebruiker. Komt overeen met alle gesprekken in de Yammer-webinterface.
Parameters
| Name | Sleutel | Vereist | Type | Description |
|---|---|---|---|---|
|
Unieke id van het netwerk
|
network_id | string |
Netwerk-id |
|
|
Ouder dan
|
older_than | integer |
Retourneert berichten die ouder zijn dan de bericht-id die is opgegeven als een numerieke tekenreeks. Dit is handig voor het pagineren van berichten. Als u momenteel bijvoorbeeld 20 berichten bekijkt en het oudste nummer 2912 is, kunt u '?older_than=2912' toevoegen aan uw aanvraag om de 20 berichten te ontvangen voordat u deze ziet. |
|
|
Nieuwer dan
|
newer_than | integer |
Retourneert nieuwere berichten dan de bericht-id die is opgegeven als een numerieke tekenreeks. Dit moet worden gebruikt bij het peilen naar nieuwe berichten. Als u berichten bekijkt en het meest recente bericht dat wordt geretourneerd 3516 is, kunt u een aanvraag indienen met de parameter '?newer_than=3516' om ervoor te zorgen dat u geen dubbele kopieën van berichten op uw pagina krijgt. |
|
|
Limit
|
limit | integer |
Alleen het opgegeven aantal berichten retourneren. |
|
|
Page
|
page | integer |
Haal de opgegeven pagina op. Als geretourneerde gegevens groter zijn dan de limiet, kunt u dit veld gebruiken voor toegang tot volgende pagina's |
Retouren
Lijst met één of meerdere berichten.
- Berichtenlijst
- MessageList
Bericht leuk vinden
Deze bewerking wordt gebruikt om het opgegeven bericht leuk te vinden.
Parameters
| Name | Sleutel | Vereist | Type | Description |
|---|---|---|---|---|
|
Bericht-id
|
message_id | True | string |
Unieke id van het bericht. |
Bericht plaatsen (V2)
Deze bewerking wordt gebruikt om een bericht te posten op een groep of alle bedrijfsfeeds. Als de groeps-id is opgegeven, wordt het bericht in de opgegeven groep geplaatst, anders wordt het bericht in alle bedrijfsfeeds geplaatst.
Parameters
| Name | Sleutel | Vereist | Type | Description |
|---|---|---|---|---|
|
Netwerk-id
|
network_id | string |
Unieke id van het netwerk. |
|
|
Groeps-id
|
group_id | True | integer |
De groep waaraan een bericht moet worden geplaatst (0 = Alle bedrijf/netwerk). |
|
Berichttekst
|
body | True | string |
Uw bericht dat in uw netwerk moet worden geplaatst. |
|
Antwoord op id
|
replied_to_id | integer |
De bericht-id van dit bericht is in antwoord. |
|
|
Direct To Id
|
direct_to_id | integer |
Indien ingesteld, wordt een privébericht rechtstreeks naar de gebruiker verzonden met de aangegeven id. |
|
|
Uitzending
|
broadcast | boolean |
Bericht posten als een aankondiging voor alle gebruikers in een groep. |
|
|
Title
|
title | string |
Titel van het bericht dat moet worden geplaatst. |
Retouren
Lijst met één of meerdere berichten.
- Berichtenlijst
- MessageListV2
Bericht posten [AFGESCHAFT]
Deze bewerking wordt gebruikt om een bericht te posten op een groep of alle bedrijfsfeeds. Als de groeps-id is opgegeven, wordt het bericht in de opgegeven groep geplaatst, anders wordt het bericht in alle bedrijfsfeeds geplaatst.
Parameters
| Name | Sleutel | Vereist | Type | Description |
|---|---|---|---|---|
|
Netwerk-id
|
network_id | string |
Unieke id van het netwerk. |
|
|
Groeps-id
|
group_id | True | integer |
De groep waaraan een bericht moet worden geplaatst (0 = Alle bedrijf/netwerk). |
|
Berichttekst
|
body | True | string |
Uw bericht dat in uw netwerk moet worden geplaatst. |
|
Antwoord op id
|
replied_to_id | integer |
De bericht-id van dit bericht is in antwoord. |
|
|
Direct To Id
|
direct_to_id | integer |
Indien ingesteld, wordt een privébericht rechtstreeks naar de gebruiker verzonden met de aangegeven id. |
|
|
Uitzending
|
broadcast | boolean |
Bericht posten als een aankondiging voor alle gebruikers in een groep. |
|
|
Title
|
title | string |
Titel van het bericht dat moet worden geplaatst. |
|
|
Onderwerp 1
|
topic1 | string |
Onderwerp dat moet worden toegepast op het bericht. |
|
|
Onderwerp 2
|
topic2 | string |
Onderwerp dat moet worden toegepast op het bericht |
|
|
Onderwerp 3
|
topic3 | string |
Onderwerp dat moet worden toegepast op het bericht. |
|
|
Onderwerp 4
|
topic4 | string |
Onderwerp dat moet worden toegepast op het bericht |
|
|
Onderwerp 5
|
topic5 | string |
Onderwerp dat moet worden toegepast op het bericht. |
|
|
Onderwerp 6
|
topic6 | string |
Onderwerp dat moet worden toegepast op het bericht. |
|
|
Onderwerp 7
|
topic7 | string |
Onderwerp dat moet worden toegepast op het bericht |
|
|
Onderwerp 8
|
topic8 | string |
Onderwerp dat moet worden toegepast op het bericht. |
|
|
Onderwerp 9
|
topic9 | string |
Onderwerp dat moet worden toegepast op het bericht. |
|
|
Onderwerp 10
|
topic10 | string |
Onderwerp dat moet worden toegepast op het bericht. |
|
|
Onderwerp 11
|
topic11 | string |
Onderwerp dat moet worden toegepast op het bericht. |
|
|
Onderwerp 12
|
topic12 | string |
Onderwerp dat moet worden toegepast op het bericht. |
|
|
Onderwerp 13
|
topic13 | string |
Onderwerp dat moet worden toegepast op het bericht. |
|
|
Onderwerp 14
|
topic14 | string |
Onderwerp dat moet worden toegepast op het bericht. |
|
|
Onderwerp 15
|
topic15 | string |
Onderwerp dat moet worden toegepast op het bericht. |
|
|
Onderwerp 16
|
topic16 | string |
Onderwerp dat moet worden toegepast op het bericht. |
|
|
Onderwerp 17
|
topic17 | string |
Onderwerp dat moet worden toegepast op het bericht. |
|
|
Onderwerp 18
|
topic18 | string |
Onderwerp dat moet worden toegepast op het bericht. |
|
|
Onderwerp 19
|
topic19 | string |
Onderwerp dat moet worden toegepast op het bericht. |
|
|
Onderwerp 20
|
topic20 | string |
Onderwerp dat moet worden toegepast op het bericht. |
Retouren
Lijst met één of meerdere berichten.
- Berichtenlijst
- MessageList
Berichten ophalen in een groep (V2) [AFGESCHAFT]
Deze actie is afgeschaft. Gebruik in plaats daarvan Berichten ophalen in een groep (V3 ).
Met deze bewerking worden de berichten geretourneerd die in een groep zijn geplaatst.
Parameters
| Name | Sleutel | Vereist | Type | Description |
|---|---|---|---|---|
|
Netwerk-id
|
network_id | string |
Unieke id van het netwerk. |
|
|
Groeps-id
|
group_id | True | integer |
Unieke id van de groep. |
|
Ouder dan
|
older_than | integer |
Retourneert berichten die ouder zijn dan de bericht-id die is opgegeven als een numerieke tekenreeks. Dit is handig voor het pagineren van berichten. Als u momenteel bijvoorbeeld 20 berichten bekijkt en het oudste nummer 2912 is, kunt u '?older_than=2912' toevoegen aan uw aanvraag om de 20 berichten te ontvangen voordat u deze ziet. |
|
|
Nieuwer dan
|
newer_than | integer |
Retourneert nieuwere berichten dan de bericht-id die is opgegeven als een numerieke tekenreeks. Dit moet worden gebruikt bij het peilen naar nieuwe berichten. Als u berichten bekijkt en het meest recente bericht dat wordt geretourneerd 3516 is, kunt u een aanvraag indienen met de parameter '?newer_than=3516' om ervoor te zorgen dat u geen dubbele kopieën van berichten op uw pagina krijgt. |
|
|
Threadtype van berichten
|
threaded | string |
Threaded=true retourneert alleen de threadstarter (eerste bericht) voor elke thread. Deze parameter is bedoeld voor apps die berichtenthreads moeten weergeven die zijn samengevouwen. threaded=extended retourneert de thread starter-berichten en de twee meest recente berichten die allemaal op activiteit zijn gerangschikt, omdat ze worden weergegeven in de standaardweergave op de Viva Engage-webinterface. |
|
|
Limit
|
limit | integer |
Alleen het opgegeven aantal berichten retourneren. |
Retouren
Lijst met één of meerdere berichten.
- Berichtenlijst
- PageableMessageList
Berichten ophalen in een groep (V3)
Met deze bewerking worden de berichten geretourneerd die in een groep zijn geplaatst.
Parameters
| Name | Sleutel | Vereist | Type | Description |
|---|---|---|---|---|
|
Netwerk-id
|
network_id | string |
Unieke id van het netwerk. |
|
|
Groeps-id
|
group_id | True | integer |
Unieke id van de groep. |
|
Ouder dan
|
older_than | integer |
Retourneert berichten in threads waarin het meest recente bericht van de thread ouder is dan de opgegeven bericht-id. Elke thread met een meest recente bericht-id die nieuwer is dan of gelijk is aan de opgegeven id, heeft geen van de berichten die door deze query worden geretourneerd. |
|
|
Nieuwer dan
|
newer_than | integer |
Retourneert berichten in threads waarbij het meest recente bericht van de thread nieuwer is dan de opgegeven bericht-id. Elke thread met een meest recente bericht-id die ouder is dan of gelijk is aan de opgegeven id, heeft geen van de berichten die door deze query worden geretourneerd. |
|
|
Threadtype van berichten
|
threaded | string |
Threaded=true retourneert alleen de threadstarter (eerste bericht) voor elke thread. Deze parameter is bedoeld voor apps die berichtenthreads moeten weergeven die zijn samengevouwen. threaded=extended retourneert de thread starter-berichten en de twee meest recente berichten die allemaal op activiteit zijn gerangschikt, omdat ze worden weergegeven in de standaardweergave op de Viva Engage-webinterface. |
|
|
Limit
|
limit | integer |
Alleen het opgegeven aantal berichten retourneren. |
Retouren
Lijst met één of meerdere berichten.
- Berichtenlijst
- PageableMessageListV2
Berichten ophalen in een groep [AFGESCHAFT]
Deze actie is afgeschaft. Gebruik in plaats daarvan Berichten ophalen in een groep (V3 ).
Met deze bewerking worden de berichten geretourneerd die in een groep zijn geplaatst.
Parameters
| Name | Sleutel | Vereist | Type | Description |
|---|---|---|---|---|
|
Netwerk-id
|
network_id | string |
Unieke id van het netwerk. |
|
|
Groeps-id
|
group_id | True | integer |
Unieke id van de groep. |
|
Ouder dan
|
older_than | integer |
Retourneert berichten die ouder zijn dan de bericht-id die is opgegeven als een numerieke tekenreeks. Dit is handig voor het pagineren van berichten. Als u momenteel bijvoorbeeld 20 berichten bekijkt en het oudste nummer 2912 is, kunt u '?older_than=2912' toevoegen aan uw aanvraag om de 20 berichten te ontvangen voordat u deze ziet. |
|
|
Nieuwer dan
|
newer_than | integer |
Retourneert nieuwere berichten dan de bericht-id die is opgegeven als een numerieke tekenreeks. Dit moet worden gebruikt bij het peilen naar nieuwe berichten. Als u berichten bekijkt en het meest recente bericht dat wordt geretourneerd 3516 is, kunt u een aanvraag indienen met de parameter '?newer_than=3516' om ervoor te zorgen dat u geen dubbele kopieën van berichten op uw pagina krijgt. |
|
|
Limit
|
limit | integer |
Alleen het opgegeven aantal berichten retourneren. |
|
|
Page
|
page | integer |
Haal de opgegeven pagina op. Als geretourneerde gegevens groter zijn dan de limiet, kunt u dit veld gebruiken voor toegang tot volgende pagina's |
Retouren
Lijst met één of meerdere berichten.
- Berichtenlijst
- MessageList
Berichten ophalen in een thread (V2) [AFGESCHAFT]
Deze actie is afgeschaft. Gebruik in plaats daarvan Berichten ophalen in een thread (V3 ).
Met deze bewerking worden de berichten geretourneerd die in een thread zijn geplaatst.
Parameters
| Name | Sleutel | Vereist | Type | Description |
|---|---|---|---|---|
|
Thread-id
|
thread_id | True | integer |
Unieke id van de thread. |
Retouren
Lijst met één of meerdere berichten.
- Berichtenlijst
- PageableMessageList
Berichten ophalen in een thread (V3)
Met deze bewerking worden de berichten geretourneerd die in een thread zijn geplaatst.
Parameters
| Name | Sleutel | Vereist | Type | Description |
|---|---|---|---|---|
|
Thread-id
|
thread_id | True | integer |
Unieke id van de thread. |
Retouren
Lijst met één of meerdere berichten.
- Berichtenlijst
- PageableMessageListV2
Berichten ophalen in een thread [AFGESCHAFT]
Deze actie is afgeschaft. Gebruik in plaats daarvan Berichten ophalen in een thread (V3 ).
Met deze bewerking worden de berichten geretourneerd die in een thread zijn geplaatst.
Parameters
| Name | Sleutel | Vereist | Type | Description |
|---|---|---|---|---|
|
Thread-id
|
thread_id | True | integer |
Unieke id van de thread. |
Retouren
Lijst met één of meerdere berichten.
- Berichtenlijst
- MessageList
De berichten ophalen uit mijn volgende feed (V3)
Deze bewerking retourneert de berichten uit de volgende feed. Dit zijn gesprekken met personen, groepen en onderwerpen die de gebruiker volgt.
Parameters
| Name | Sleutel | Vereist | Type | Description |
|---|---|---|---|---|
|
Netwerk-id
|
network_id | string |
Unieke id van het netwerk. |
|
|
Ouder dan
|
older_than | integer |
Retourneert berichten die ouder zijn dan de bericht-id die is opgegeven als een numerieke tekenreeks. Dit is handig voor het pagineren van berichten. Als u momenteel bijvoorbeeld 20 berichten bekijkt en het oudste nummer 2912 is, kunt u '?older_than=2912' toevoegen aan uw aanvraag om de 20 berichten te ontvangen voordat u deze ziet. |
|
|
Nieuwer dan
|
newer_than | integer |
Retourneert nieuwere berichten dan de bericht-id die is opgegeven als een numerieke tekenreeks. Dit moet worden gebruikt bij het peilen naar nieuwe berichten. Als u berichten bekijkt en het meest recente bericht dat wordt geretourneerd 3516 is, kunt u een aanvraag indienen met de parameter '?newer_than=3516' om ervoor te zorgen dat u geen dubbele kopieën van berichten op uw pagina krijgt. |
|
|
Threadtype van berichten
|
threaded | string |
Threaded=true retourneert alleen de threadstarter (eerste bericht) voor elke thread. Deze parameter is bedoeld voor apps die berichtenthreads moeten weergeven die zijn samengevouwen. threaded=extended retourneert de thread starter-berichten en de twee meest recente berichten die allemaal op activiteit zijn gerangschikt, omdat ze worden weergegeven in de standaardweergave op de Viva Engage-webinterface. |
|
|
Limit
|
limit | integer |
Alleen het opgegeven aantal berichten retourneren. |
Retouren
Lijst met één of meerdere berichten.
- Berichtenlijst
- PageableMessageListV2
De berichten ophalen uit mijn volgende feed [AFGESCHAFT]
Deze actie is afgeschaft. Gebruik in plaats daarvan De berichten ophalen uit mijn volgende feed (V3 ).
Deze bewerking retourneert de berichten uit de volgende feed. Dit zijn gesprekken met personen, groepen en onderwerpen die de gebruiker volgt.
Parameters
| Name | Sleutel | Vereist | Type | Description |
|---|---|---|---|---|
|
Netwerk-id
|
network_id | string |
Unieke id van het netwerk. |
|
|
Ouder dan
|
older_than | integer |
Retourneert berichten die ouder zijn dan de bericht-id die is opgegeven als een numerieke tekenreeks. Dit is handig voor het pagineren van berichten. Als u momenteel bijvoorbeeld 20 berichten bekijkt en het oudste nummer 2912 is, kunt u '?older_than=2912' toevoegen aan uw aanvraag om de 20 berichten te ontvangen voordat u deze ziet. |
|
|
Nieuwer dan
|
newer_than | integer |
Retourneert nieuwere berichten dan de bericht-id die is opgegeven als een numerieke tekenreeks. Dit moet worden gebruikt bij het peilen naar nieuwe berichten. Als u berichten bekijkt en het meest recente bericht dat wordt geretourneerd 3516 is, kunt u een aanvraag indienen met de parameter '?newer_than=3516' om ervoor te zorgen dat u geen dubbele kopieën van berichten op uw pagina krijgt. |
|
|
Limit
|
limit | integer |
Alleen het opgegeven aantal berichten retourneren. |
|
|
Page
|
page | integer |
Haal de opgegeven pagina op. Als geretourneerde gegevens groter zijn dan de limiet, kunt u dit veld gebruiken voor toegang tot volgende pagina's |
Retouren
Lijst met één of meerdere berichten.
- Berichtenlijst
- MessageList
Gebruikersgegevens ophalen
Met deze bewerking worden details van gebruikersprofielen geretourneerd.
Parameters
| Name | Sleutel | Vereist | Type | Description |
|---|---|---|---|---|
|
Gebruikers-ID
|
user_id | True | integer |
De unieke id van de gebruiker. |
Retouren
Eigenschappen van Viva Engage-gebruiker.
- User
- User
Groepen ophalen
Hiermee haalt u alle groepen op. Als van mij = 1, krijgt u alleen groepen waartoe de gebruiker behoort
Parameters
| Name | Sleutel | Vereist | Type | Description |
|---|---|---|---|---|
|
Netwerk-id
|
network_id | string |
Netwerk-id |
|
|
mijn
|
mine | integer |
Wordt gebruikt voor het verkrijgen van groepen waarvan de gebruiker deel uitmaakt |
|
|
Alle bedrijfsgroep weergeven
|
showAllCompanyGroup | integer |
Wordt gebruikt voor het weergeven van alle bedrijfsgroepen |
Retouren
- response
- array of YammmerEntity
Haal de berichten op uit mijn volgende feed (V2) [AFGESCHAFT]
Deze actie is afgeschaft. Gebruik in plaats daarvan De berichten ophalen uit mijn volgende feed (V3 ).
Deze bewerking retourneert de berichten uit de volgende feed. Dit zijn gesprekken met personen, groepen en onderwerpen die de gebruiker volgt.
Parameters
| Name | Sleutel | Vereist | Type | Description |
|---|---|---|---|---|
|
Netwerk-id
|
network_id | string |
Unieke id van het netwerk. |
|
|
Ouder dan
|
older_than | integer |
Retourneert berichten die ouder zijn dan de bericht-id die is opgegeven als een numerieke tekenreeks. Dit is handig voor het pagineren van berichten. Als u momenteel bijvoorbeeld 20 berichten bekijkt en het oudste nummer 2912 is, kunt u '?older_than=2912' toevoegen aan uw aanvraag om de 20 berichten te ontvangen voordat u deze ziet. |
|
|
Nieuwer dan
|
newer_than | integer |
Retourneert nieuwere berichten dan de bericht-id die is opgegeven als een numerieke tekenreeks. Dit moet worden gebruikt bij het peilen naar nieuwe berichten. Als u berichten bekijkt en het meest recente bericht dat wordt geretourneerd 3516 is, kunt u een aanvraag indienen met de parameter '?newer_than=3516' om ervoor te zorgen dat u geen dubbele kopieën van berichten op uw pagina krijgt. |
|
|
Threadtype van berichten
|
threaded | string |
Threaded=true retourneert alleen de threadstarter (eerste bericht) voor elke thread. Deze parameter is bedoeld voor apps die berichtenthreads moeten weergeven die zijn samengevouwen. threaded=extended retourneert de thread starter-berichten en de twee meest recente berichten die allemaal op activiteit zijn gerangschikt, omdat ze worden weergegeven in de standaardweergave op de Viva Engage-webinterface. |
|
|
Limit
|
limit | integer |
Alleen het opgegeven aantal berichten retourneren. |
Retouren
Lijst met één of meerdere berichten.
- Berichtenlijst
- PageableMessageList
Mijn netwerken ophalen
Triggers
| Wanneer er een nieuw bericht in een groep is (V2) |
Deze bewerking wordt geactiveerd wanneer een nieuw bericht in een groep wordt geplaatst. |
| Wanneer er een nieuw bericht in een groep is [AFGESCHAFT] |
Deze actie is afgeschaft. Gebruik in plaats daarvan een nieuw bericht in een groep (V2 ).
|
| Wanneer er een nieuw bericht in mijn gevolgde feed is [AFGESCHAFT] |
Deze actie is afgeschaft. Gebruik in plaats daarvan wanneer er een nieuw bericht in mijn gevolgde feed (V2) staat .
|
| Wanneer er een nieuw bericht in mijn gevolgde feed staat (V2) |
Deze bewerking wordt geactiveerd wanneer er een nieuw bericht in een netwerk is, gevolgd door u. |
Wanneer er een nieuw bericht in een groep is (V2)
Deze bewerking wordt geactiveerd wanneer een nieuw bericht in een groep wordt geplaatst.
Parameters
| Name | Sleutel | Vereist | Type | Description |
|---|---|---|---|---|
|
Netwerk-id
|
network_id | string |
Unieke id van het netwerk. |
|
|
Groeps-id
|
group_id | True | integer |
Unieke id van de groep. |
Retouren
Lijst met één of meerdere berichten.
- Berichtenlijst
- MessageListV2
Wanneer er een nieuw bericht in een groep is [AFGESCHAFT]
Deze actie is afgeschaft. Gebruik in plaats daarvan een nieuw bericht in een groep (V2 ).
Deze bewerking wordt geactiveerd wanneer een nieuw bericht in een groep wordt geplaatst.
Parameters
| Name | Sleutel | Vereist | Type | Description |
|---|---|---|---|---|
|
Netwerk-id
|
network_id | string |
Unieke id van het netwerk. |
|
|
Groeps-id
|
group_id | True | integer |
Unieke id van de groep. |
Retouren
Lijst met één of meerdere berichten.
- Berichtenlijst
- MessageList
Wanneer er een nieuw bericht in mijn gevolgde feed is [AFGESCHAFT]
Deze actie is afgeschaft. Gebruik in plaats daarvan wanneer er een nieuw bericht in mijn gevolgde feed (V2) staat .
Deze bewerking wordt geactiveerd wanneer er een nieuw bericht in een netwerk is, gevolgd door u.
Parameters
| Name | Sleutel | Vereist | Type | Description |
|---|---|---|---|---|
|
Netwerk-id
|
network_id | string |
Kies een netwerk. |
Retouren
Lijst met één of meerdere berichten.
- Berichtenlijst
- MessageList
Wanneer er een nieuw bericht in mijn gevolgde feed staat (V2)
Deze bewerking wordt geactiveerd wanneer er een nieuw bericht in een netwerk is, gevolgd door u.
Parameters
| Name | Sleutel | Vereist | Type | Description |
|---|---|---|---|---|
|
Netwerk-id
|
network_id | string |
Kies een netwerk. |
Retouren
Lijst met één of meerdere berichten.
- Berichtenlijst
- MessageListV2
Definities
User
Eigenschappen van Viva Engage-gebruiker.
| Name | Pad | Type | Description |
|---|---|---|---|
|
Gebruikersnaam
|
name | string |
Gebruikersnaam. |
|
Functietitel
|
job_title | string |
Functie van gebruiker. |
|
Locatie
|
location | string |
Gebruikerslocatie. |
|
Volledige naam
|
full_name | string |
Volledige naam van gebruiker. |
|
Voornaam
|
first_name | string |
Voornaam van gebruiker. |
|
Achternaam
|
last_name | string |
Achternaam van gebruiker. |
|
Profiel-URL
|
web_url | string |
URL van gebruikersprofiel. |
|
E-mailen
|
string |
E-mailadres van gebruiker. |
|
|
Geboortedatum
|
birth_date | string |
Geboortedatum van gebruiker. |
|
Foto-URL
|
mugshot_url | string |
Url van gebruikersfoto. |
Message
Eigenschappen van één Viva Engage-bericht.
| Name | Pad | Type | Description |
|---|---|---|---|
|
ID-kaart
|
id | integer |
Id die is gekoppeld aan het bericht. |
|
Tekst
|
content_excerpt | string |
Tekstinhoud van het bericht. |
|
Afzender
|
sender_id | integer |
Unieke id van de gebruiker die het bericht heeft gepost. |
|
Gereageerd op
|
replied_to_id | integer |
Id van het bericht waarop dit bericht een antwoord is. |
|
Gemaakt op
|
created_at | string |
Tijdstip waarop het bericht is gemaakt. |
|
Netwerk
|
network_id | integer |
De id van het netwerkbericht is gekoppeld. |
|
Typologie
|
message_type | string |
Beschrijving van het berichttype. |
|
Type afzender
|
sender_type | string |
Beschrijving van het type afzender. |
|
URL
|
url | uri |
API-URL van het bericht. |
|
Web-URL
|
web_url | uri |
Web-URL van het bericht. |
|
Groeps-id
|
group_id | integer |
Unieke id van de groep die het bericht heeft gepost. |
|
Berichttekst
|
body | MessageBody |
Inhoud die is gekoppeld aan één bericht. |
|
Thread-id
|
thread_id | integer |
Unieke id van thread. |
|
Direct bericht
|
direct_message | boolean |
Vlag om op te geven of het bericht een direct bericht is. |
|
Client-id
|
client_type | string |
Type van de client. |
|
Client-URL
|
client_url | uri |
Webkoppeling van de client. |
|
Language
|
language | string |
Taal die in het bericht wordt gebruikt. |
|
Getagde gebruiker
|
notified_user_ids | array of integer |
Details van gebruikers op de hoogte gesteld. |
|
Geheimhouding
|
privacy | string |
Details van de privacy die aan het bericht is gekoppeld. |
|
liked_by
|
liked_by | LikedBy |
Leuk gevonden door |
|
Is systeembericht
|
system_message | boolean |
Vlag om op te geven of het bericht een door het systeem gegenereerd bericht is of niet. |
|
Onderwerpen
|
topics | array of Topic |
Lijst met onderwerpen. |
MessageV2
Eigenschappen van één Viva Engage-bericht.
| Name | Pad | Type | Description |
|---|---|---|---|
|
ID-kaart
|
id | integer |
Id die is gekoppeld aan het bericht. |
|
Tekst
|
content_excerpt | string |
Tekstinhoud van het bericht. |
|
Afzender
|
sender_id | integer |
Unieke id van de gebruiker die het bericht heeft gepost. |
|
Gereageerd op
|
replied_to_id | integer |
Id van het bericht waarop dit bericht een antwoord is. |
|
Gemaakt op
|
created_at | string |
Tijdstip waarop het bericht is gemaakt. |
|
Netwerk
|
network_id | integer |
De id van het netwerkbericht is gekoppeld. |
|
Typologie
|
message_type | string |
Beschrijving van het berichttype. |
|
Type afzender
|
sender_type | string |
Beschrijving van het type afzender. |
|
URL
|
url | uri |
API-URL van het bericht. |
|
Web-URL
|
web_url | uri |
Web-URL van het bericht. |
|
Groeps-id
|
group_id | integer |
Unieke id van de groep die het bericht heeft gepost. |
|
Berichttekst
|
body | MessageBody |
Inhoud die is gekoppeld aan één bericht. |
|
Thread-id
|
thread_id | integer |
Unieke id van thread. |
|
Direct bericht
|
direct_message | boolean |
Vlag om op te geven of het bericht een direct bericht is. |
|
Client-id
|
client_type | string |
Type van de client. |
|
Client-URL
|
client_url | uri |
Webkoppeling van de client. |
|
Language
|
language | string |
Taal die in het bericht wordt gebruikt. |
|
Getagde gebruiker
|
notified_user_ids | array of integer |
Details van gebruikers op de hoogte gesteld. |
|
Geheimhouding
|
privacy | string |
Details van de privacy die aan het bericht is gekoppeld. |
|
liked_by
|
liked_by | LikedBy |
Leuk gevonden door |
|
Is systeembericht
|
system_message | boolean |
Vlag om op te geven of het bericht een door het systeem gegenereerd bericht is of niet. |
Onderwerp
Eigenschappen van één onderwerp.
| Name | Pad | Type | Description |
|---|---|---|---|
|
ID-kaart
|
id | integer |
Unieke id van het onderwerp. |
|
Naam
|
name | string |
Naam van het onderwerp. |
PageableMessageList
Lijst met één of meerdere berichten.
| Name | Pad | Type | Description |
|---|---|---|---|
|
Messages
|
value | array of Message |
PageableMessageListV2
Lijst met één of meerdere berichten.
| Name | Pad | Type | Description |
|---|---|---|---|
|
Messages
|
value | array of MessageV2 |
MessageList
Lijst met één of meerdere berichten.
| Name | Pad | Type | Description |
|---|---|---|---|
|
Messages
|
messages | array of Message |
messages |
MessageListV2
Lijst met één of meerdere berichten.
| Name | Pad | Type | Description |
|---|---|---|---|
|
Messages
|
messages | array of MessageV2 |
messages |
MessageBody
Inhoud die is gekoppeld aan één bericht.
| Name | Pad | Type | Description |
|---|---|---|---|
|
Tekst
|
parsed | string |
Geparseerde tekstindeling. |
|
Vlakte
|
plain | string |
Tekst zonder opmaak. |
|
Rijk
|
rich | string |
Rtf-tekstindeling. |
LikedBy
Leuk gevonden door
| Name | Pad | Type | Description |
|---|---|---|---|
|
Aantal
|
count | integer |
Aantal afzonderlijke vind-ik-leuks. |
|
Names
|
names | array of object |
Lijst met personen die het bericht leuk vonden. |
|
Volledige naam
|
names.full_name | string |
De volledige naam van de persoon die het bericht leuk vond. |
Netwerk
Eigenschappen van één netwerk.
| Name | Pad | Type | Description |
|---|---|---|---|
|
ID-kaart
|
id | string |
Unieke id van het netwerk. |
|
Naam
|
name | string |
Samenvatting van het netwerk. |
|
Link
|
permalink | string |
Webkoppeling naar de netwerkpagina. |
YammmerEntity
Eigenschappen van één Viva Engage-entiteit.
| Name | Pad | Type | Description |
|---|---|---|---|
|
Description
|
type | string |
Details van de Entiteit Viva Engage. |
|
Groeps-id
|
id | integer |
Unieke id van de groep. |
|
Volledige naam
|
full_name | string |
Naam van de Entiteit Viva Engage. |