Microsoft Teams-data naar Azure en Power BI
Samenwerkingsdata uit Teams
Yres heeft geen losse Teams-connector: Teams-data komt binnen via de Microsoft Graph API. Je registreert één app in Microsoft Entra ID, kent daar de Graph-permissies voor Teams aan toe en kiest in Yres de Graph-preset. Yres vraagt met OAuth2 een token aan, leest de Graph-endpoints voor teams, kanalen en berichten pagina voor pagina uit en zet de uitkomst in een Azure SQL-database in je eigen tenant. Van daaruit gebruik je de data in Power BI.
In het kort
- Verbinding
- Microsoft Graph API (versie 1.0), via de Graph-preset in Yres. Er is geen aparte Teams-connector
- Aanmelden
- OAuth2 met een app-registratie in Microsoft Entra ID: client credentials, of authorization code met een refresh token
- Graph-permissies
- Afhankelijk van je scenario, bijvoorbeeld Team.ReadBasic.All, Channel.ReadBasic.All of ChannelMessage.Read.All, met admin consent
- Bereik van de rechten
- Applicatiepermissies gelden voor de hele tenant; de app hoeft geen lid te zijn van een team
- Paginering
- Yres volgt de vervolglink die Graph bij elke pagina meegeeft, tot alles is opgehaald
- Waar draait het
- Graph is via HTTPS publiek bereikbaar, dus de cloud-runtime volstaat. Een self-hosted integration runtime is alleen nodig als verkeer via een afgeschermd netwerk moet lopen
- Geheimen
- De gegevens van de app gaan naar de Key Vault in je eigen Azure-omgeving, niet naar de webapplicatie van Yres
Wat je zelf regelt
- 1Registreer een app in het Microsoft Entra-beheercentrum (Identity → Applications → App registrations) en noteer de client-ID en tenant-ID.
- 2Maak een client secret aan en kopieer de waarde direct; die is daarna niet meer op te vragen.
- 3Voeg onder API permissions de Microsoft Graph-permissies voor Teams toe die bij je doel passen en laat een beheerder admin consent geven.
- 4Kies het grant type: Client Credentials voor een achtergrondproces zonder gebruiker, of Authorization Code met een refresh token voor toegang namens een gebruiker.
- 5Voeg in Yres een bron toe met de Graph-preset en vul tenant-ID, client-ID, secret en scope in.
Wanneer heb je dit nodig — en wanneer niet
Een losse connector is genoeg als…
Wil je alleen zien hoeveel Teams gebruikt wordt, dan geven de gebruiksrapporten in het Microsoft 365-beheercentrum dat al. Daar is geen datawarehouse voor nodig.
Yres voegt iets toe als…
Yres wordt zinvol als je Teams-gegevens wilt combineren met andere bronnen, bijvoorbeeld teams en kanalen naast je HR- of projectadministratie, of als je wilt vastleggen hoe de indeling van teams en kanalen in de tijd verandert.
Veelgestelde vragen: Microsoft Teams
Wat is het verschil tussen de bron Microsoft Teams en de bron Microsoft Graph in Yres?
Technisch geen: beide gebruiken dezelfde Graph-preset, hetzelfde adres en dezelfde OAuth2-aanmelding. Het verschil zit in de permissies die je aan de Entra-app geeft. Voor Teams zijn dat de Graph-permissies voor teams, kanalen en berichten. De Graph-pagina beschrijft dezelfde koppeling voor Microsoft 365 in het algemeen.
Moet de app lid worden van elk team dat ik wil uitlezen?
Nee. Met applicatiepermissies krijgt de app toegang tot de hele tenant, zonder lidmaatschap van een team. Een beheerder moet daarvoor wel admin consent geven. Kies alleen de permissies die je echt nodig hebt: voor berichten is dat een andere permissie (ChannelMessage.Read.All) dan voor teams (Team.ReadBasic.All) of kanalen (Channel.ReadBasic.All).
Wanneer kies ik Authorization Code in plaats van Client Credentials?
Client Credentials is bedoeld voor een achtergrondproces zonder ingelogde gebruiker en is voor geplande loads de gebruikelijke keuze. Authorization Code gebruik je als de toegang namens een gebruiker moet lopen. In dat geval is een refresh token verplicht; daarmee haalt Yres bij elke run een nieuw toegangstoken op.
Welke Teams-gegevens kan ik ophalen?
Wat de Graph-endpoints voor Teams teruggeven en wat de toegekende permissies toestaan: teams, kanalen en berichten. Welke endpoints er zijn, staat in de Teams-API-documentatie van Microsoft; wat de app daarvan mag lezen, regel je met de permissies.
Volledige technische beschrijving in de kennisbank →·Laatst gecontroleerd:
Datawarehouse-automatisering die in je eigen Azure draait
Gebouwd voor organisaties op Azure en Power BI. Yres koppelt je bronnen, bewaart de historie en rolt wijzigingen gecontroleerd uit, zonder handwerk.