Teams-connectors en webhooks: uitfasering en vervanging door werkstromen
By Mirko Peters ·
Office 365-connectors en op connectors gebaseerde inkomende webhooks in Teams zijn in mei 2026 uitgefaseerd. Deze gids beschrijft wat niet meer werkt, wat ervoor in de plaats komt, hoe je migreert en waar Workflows nog steeds verschilt.
Automatically translated with AI from the original post. Read the English original
Teams-connectors, inclusief de Incoming Webhook-connector, zijn verdwenen. Microsoft Learn vermeldt dat Office 365-connectors in Teams in mei 2026 zijn uitgefaseerd, en dat de manier om webhookaanvragen te ontvangen en naar Teams te posten nu de Workflows-app is. Een werkstroom die is gebouwd op de trigger When a Teams webhook request is received vervangt de oude connector-URL.
Belangrijkste punten
- Volgens Microsoft Learn zijn Office 365-connectors in Teams, inclusief op connectors gebaseerde inkomende webhooks, in mei 2026 uitgefaseerd. Het laatste uitrolvenster in de ontwikkelblog was 18 tot en met 22 mei 2026.
- De vervanging is de Workflows-app in Teams, die op Power Automate draait. Gebruik de trigger When a Teams webhook request is received of een kant-en-klare sjabloon.
- Een werkstroom heeft een eigen webhook-URL, dus elk verzendend systeem moet naar die URL worden omgezet, want de oude connector-URL werkt niet meer.
- MessageCard-payloads worden weergegeven, maar hun HttpPost-knoppen niet. Gebruik Adaptive Cards voor interactieve inhoud.
- Werkstromen behoren toe aan een eigenaar, niet aan een kanaal. Voeg mede-eigenaren toe, zodat de werkstroom niet verweesd raakt wanneer de eigenaar vertrekt.
Dit artikel legt uit wat is uitgefaseerd, wat ervoor in de plaats komt, hoe je overstapt en welke verschillen nog voor problemen kunnen zorgen.
Wat er is uitgefaseerd en wanneer
De uitfasering liep bijna twee jaar en de datum is meerdere keren verschoven. De ontwikkelblog van Microsoft 365 legt de volgorde vast:
- Juli 2024: eerste plan om vanaf 15 augustus 2024 nieuwe connectors te blokkeren en op 1 oktober 2024 alle connectors te stoppen.
- Juli 2024: uitfasering uitgesteld tot december 2025.
- Oktober 2025: migratiedeadline verschoven naar 31 maart 2026.
- Februari 2026: ondersteuning voor Message Card toegevoegd aan Workflows, en de Workflows-bot kon posten in gedeelde kanalen. De deadline schoof op naar 30 april 2026.
- 14 april 2026 (laatste update): de uitrol begint op 18 mei 2026 en wordt voltooid op 22 mei 2026. Daarna werken de connectors niet meer.
Het gaat om Office 365-connectors in Teams, inclusief op webhooks gebaseerde connectors zoals Incoming Webhook en connectors van derden die naar een URL posten. De blog vermeldt dat de wijziging van de webhook-URL geldt voor op webhooks gebaseerde connectors, niet voor pollingconnectors zoals RSS.
Als iets nog via een oude connector post, beschouw je het als kapot of op het punt om kapot te gaan, en plan je migratie nu.
Wat connectors vervangt
Microsoft noemt op Learn drie routes:
- Workflows-app (Power Automate) voor inkomende webhooks. Gebruik een kant-en-klare sjabloon of de trigger When a Teams webhook request is received.
- De Power Automate-connector voor ISV's en productteams. Learn noemt dit de schaalbare en veilige manier om programmatisch gegevens naar Teams te verplaatsen en er uit te halen.
- Een Teams-app met proactieve berichten, zodat gebruikers berichten kunnen instellen op basis van triggergebeurtenissen in je eigen systeem.
Voor de meeste beheerders en scripters is pad 1 de directe vervanging.
Zo migreer je een webhook naar Workflows
De Microsoft-supportpagina over inkomende webhooks kon bij het opstellen van dit artikel niet worden gelezen. De onderstaande stappen volgen daarom de dev-blog en de referentie van de Learn-connector.
- Maak een lijst van elke connector die in gebruik is. Controleer kanalen waarin Kanaalbeheer > Connectors is gebruikt, en de systemen die meldingen versturen, zoals monitoring-, build- of ticketingtools.
- Open in Teams de app Workflows. Volgens de dev-blog kun je die ook openen vanuit een chat of kanaal via Meer opties (...).
- Kies een vooraf gedefinieerde webhooksjabloon, of begin vanaf nul met de trigger Wanneer een Teams-webhookaanvraag wordt ontvangen.
- Kies het team en het kanaal, sla de workflow op en kopieer de trigger-URL van de workflow in Power Automate.
- Vervang de oude connector-URL in het verzendende systeem door de nieuwe.
- Geef de workflow een naam en beschrijving, test de workflow en voeg mede-eigenaren toe.
- Verstuur een testaanroep met POST en controleer of het bericht verschijnt.
De trigger accepteert alleen POST-aanvragen. De referentie van de Learn-connector meldt dat GET-aanvragen niet worden ondersteund.
Payloadformaat en kaarten
De body van de trigger kan een array met adaptive cards bevatten. In de referentie zie je een bericht met een attachments-array waarvan de contentType gelijk is aan application/vnd.microsoft.card.adaptive. Een enkele Message Card-body wordt ook geaccepteerd.
Houd deze punten in gedachten:
- Adaptive Cards zijn de ondersteunde manier om interactieve inhoud te bouwen.
- MessageCard-payloads worden weergegeven, maar knoppen die HttpPost gebruiken werken niet. Volgens de dev-blog moet je overstappen op Adaptive Cards als je interactieve kaartelementen gebruikt.
Toegangsbeheer
Eén echte verbetering: de trigger heeft een verificatie-instelling. Learn noemt drie opties.
| Instelling | Wat de afzender moet doen | |---|---| | Iedereen | Stuur geen verificatietokenheader mee, anders mislukt de aanvraag | | Elke gebruiker in mijn tenant | Stuur een verificatietoken mee | | Specifieke gebruikers in mijn tenant | Stuur een verificatietoken mee, en de gebruiker moet op de toegestane lijst staan |
Voor de tenantopties verwijst Learn naar de gids over OAuth-verificatie voor HTTP-aanvraagtriggers. Als een tool alleen een gewone POST naar een URL kan sturen, heeft die de instelling Iedereen nodig. Behandel de URL dan als geheim.
Verschillen met de oude connector
Houd hier rekening mee voordat je overschakelt.
- Afzenderidentiteit. De dev-blogupdate van april 2026 meldt dat je het botpictogram en de botnaam voor webhookberichten niet kunt aanpassen. Berichten tonen de standaardidentiteit van de Workflows-bot.
- Eigenaarschap. Volgens Learn zijn workflows gekoppeld aan eigenaren, niet aan een team of kanaal. Als de eigenaar vertrekt en er is geen mede-eigenaar, kan de flow verweesd raken. Voeg mede-eigenaren toe met volledige beheerrechten.
- Limieten. De referentie van Learn noemt ongeveer 1.000 gelijktijdige inkomende aanroepen voor de trigger, en een limiet van 28 KB voor de actie Adaptieve kaart plaatsen in een chat of kanaal. Grotere payloads leveren de fout "Request Entity too large" op.
- Privékanalen. De bronnen spreken elkaar tegen. De dev-blog meldt dat de selectie van privékanalen in de Workflows-app volledig zou worden uitgerold vóór 20 april 2026. Eén Learn-pagina stelt dat Workflows-webhooks privékanalen ondersteunen, en een andere Learn-pagina noemt ondersteuning voor privékanalen in ontwikkeling. De referentie van de Microsoft Teams-connector stelt nog steeds dat het plaatsen van een bericht of kaart in een privékanaal momenteel niet wordt ondersteund. Test je doelkanaal voordat je erop vertrouwt.
Veelgemaakte fouten
- Alleen het kanaal migreren en vergeten de URL in het verzendende systeem te wijzigen.
- Eén persoon als enige workflow-eigenaar laten staan.
- Een token meesturen naar een trigger die op Iedereen staat ingesteld.
- MessageCard-knoppen behouden en verwachten dat de callbacks werken.
- Ervan uitgaan dat de oude botnaam en het oude pictogram behouden blijven.
Gerelateerd
Bronnen
- Uitfasering van Office 365-connectors in Microsoft Teams (Microsoft 365 developer blog)
- Office 365-connectors voor Teams maken (Microsoft Learn)
- Buitengebruikstelling van Microsoft 365-connectors en aangepaste connectors in Teams (Microsoft Learn)
- Referentie voor de Microsoft Teams-connector voor Power Automate (Microsoft Learn)
Veelgestelde vragen
Werken Teams-connectors nog?
Nee. Microsoft Learn vermeldt dat Office 365-connectors in Teams, inclusief op connectors gebaseerde inkomende webhooks, in mei 2026 zijn uitgefaseerd. De Microsoft 365-ontwikkelblog noemt 18 tot en met 22 mei 2026 als het laatste uitrolvenster en stelt dat webhooks vóór die start gemigreerd moesten zijn.
Wat vervangt de Incoming Webhook-connector in Teams?
De Workflows-app, die draait op Power Automate. Volgens Microsoft Learn gebruik je ofwel een vooraf gedefinieerde sjabloon die een bericht plaatst in een chat of kanaal zodra er een webhook-verzoek binnenkomt, ofwel bouw je een flow vanaf nul met de trigger When a Teams webhook request is received.
Heb ik een nieuwe URL nodig voor mijn monitoringtool of script?
Ja. Een werkstroom heeft een eigen trigger-URL, en de connectorreferentie beschrijft de trigger als gestart door een POST-aanvraag naar dat eindpunt. In de pagina's die ik las staat niet waar de URL wordt getoond, dus open de werkstroomtrigger in Power Automate om hem te kopiëren. Plak hem vervolgens in het systeem dat de POST-aanvraag verstuurt.
Kan de webhook van Workflows knoppen posten die terugroepen naar mijn systeem?
Niet met MessageCard. De ontwikkelblog stelt dat MessageCard inhoud weergeeft maar geen HttpPost-actieknoppen ondersteunt. Voor interactieve elementen verwijst Microsoft naar Adaptive Cards, en Learn stelt dat je de werkstroom moet configureren om de reacties af te handelen.
Wie mag aanvragen naar een workflow-webhook sturen?
Dat bepaal jij. De referentie van de Microsoft Teams-connector op Learn noemt drie opties: iedereen, elke gebruiker in je tenant, of specifieke gebruikers in je tenant. Bij de tenant-opties moeten aanvragen een authenticatietoken bevatten. Bij Iedereen mag je er geen meesturen.